福帮手

官方免费 MCP 插件。本文依据插件市场当前上架信息与平台导入目录中的工具定义编写；不提供调用示例。

功能说明

提供身份识别、场景包查询、首值和继续使用记录、乐包状态确认及人工交接。

接入与授权

无需用户授权。平台会在安装或调用时连接该插件。

工具目录

工具	说明
resource-plugin__skill_whoami	第一步：识别当前用户、WorkBuddy 入口、场景包路由及服务端指定的下一步动作。任何自然语言入口均须优先调用；不得依据假设直接回复，也不得先调用高级或权益工具。
resource-plugin__fbs_scene_pack_query	第二步：仅在 skill_whoami 返回 nextTool=fbs_scene_pack_query 后调用。必须使用服务端下发的准确工具名，并原样透传 actionEnvelope.toolArguments。
resource-plugin__skill_consume	第三步：仅在场景包卡片已实际交付或已确认持续使用后调用。在同一绑定链路中记录 first_value_completed 或 continued_use_completed，并携带服务端幂等键。
resource-plugin__skill_activate	通过访问码激活 Skill 权益，返回后续调用所需的 sessionRef 和 sessionToken。仅在用户明确提供访问码，或身份识别/会话接力明确要求激活时使用，不得作为首轮业务步骤。
resource-plugin__skill_precheck	校验当前用户是否拥有指定场景包权益及足够积分。仅在身份或会话已明确后，用于显式权益或积分校验。
resource-plugin__skill_finish	更新使用记录的完成状态。仅在业务流程实际完成后调用，不用于首轮入口或首次价值阶段。
resource-plugin__skill_logout	主动注销当前会话。仅在用户明确要求退出登录或重置会话状态时调用。
resource-plugin__lebao_redeem	将本地 .FBS 乐包凭证兑换为福帮手站内积分或专家团权益。仅在已有明确乐包凭证载荷时使用，不属于首轮诊断主链。
resource-plugin__lebao_status	查询乐包兑换和匿名绑定状态（只读）。至少提供 voucherId、serverBindingId、anonymousUserCodeHash 之一；仅在已有绑定或价值证据后用于显式状态查询。
resource-plugin__lebao_claim	将乐包归并到当前会话用户并触发服务端发奖。仅在服务端已将用户推进到权益或升级阶段时调用。
resource-plugin__lebao_drop	放弃或取消乐包权益。

工具与参数

resource-plugin__skill_whoami

第一步：识别当前用户、WorkBuddy 入口、场景包路由及服务端指定的下一步动作。任何自然语言入口均须优先调用；不得依据假设直接回复，也不得先调用高级或权益工具。

输入参数

参数	类型	必填	说明
sessionRef	string	否	可选短会话引用（activate返回）；WorkBuddy宿主链式调用优先使用
sessionToken	string	否	可选JWT会话令牌；无令牌时返回匿名落地引导，仅在能保证原样传递时使用
anonymousUserCodeHash	string	否	匿名用户编码哈希；用于增强匿名上下文
serverBindingId	string	否	服务端匿名绑定ID；用于增强匿名上下文
scenePackId	string	否	专家包本地场景包ID，仅用于观测回流
entryId	string	否	可选服务端动作信封携带的标准化入口标识，用于意图归因连续性。
entryPromptCode	string	否	可选服务端动作信封携带的入口提示词追踪，用于归因和后续链路完整性。
entrySurface	string	否	可选服务端动作信封携带的入口页面追踪，用于归因和后续链路完整性。
entryVariantCode	string	否	可选入口变体码，仅用于实验与模板归因
assetType	string	否	可选成果类型追踪，用于价值事件分段和后续激励路由。
intentFamily	string	否	意图族短码，仅用于观测回流
profileSegment	string	否	画像分段短码，仅用于观测回流
lifecycleStage	string	否	生命周期阶段短码，仅用于观测回流
personaCode	string	否	人格编码，如ai_partner_public/legacy_cofounder，仅用于观测回流
customizationLevel	string	否	定制层级，如L1_standard/L2_private_pack，仅用于观测回流
packCode	string	否	服务端权益包编码，仅用于显示双轨状态
semanticSource	string	否	可选语义来源追踪，使后续使用、乐包和解锁流程保持归因一致。
expertLoaded	unknown	否	可选宿主信号。接受布尔值 true/false 或字符串 true/false，部分宿主会将工具参数序列化为字符串。
extensionExpertId	string	否	我的专家扩展专家ID，仅用于观测与归因
extensionExpertVersion	string	否	我的专家扩展专家版本，仅用于观测与归因
extensionKind	string	否	扩展专家类型，当前固定 agent
extensionBatchId	string	否	多 Agent 批次ID，仅用于观测与归因
extensionRole	string	否	扩展 Agent 角色或模板ID，仅用于观测与归因
extensionAccessMode	string	否	扩展专家接入模式，如 shared-connector
templateId	string	否	内置深度模板ID，仅用于观测与归因
toolName	string	否	可选宿主调度提示。若宿主包装器已选定完整 MCP 工具名，应原样透传；服务端会忽略该字段的路由提示。
expertEntryId	string	否	可选专家入口标识。当前展示的单个超级伙伴必须使用 fbsir-super-partner；fbsir-super-partner-group 是独立冻结的旧专家团队。通用 my_expert 页面不代表专家身份。
defaultPromptId	string	否	可选起始提示词标识，用于保持入口归因连续性。
cardActionId	string	否	可选起始卡片动作标识，用于保持入口归因连续性。
activeExpertEntryId	string	否	可选当前激活的专家入口标识，用于宿主后续链路兼容。
requestSource	string	否	可选来源追踪。真实 WorkBuddy 宿主调用使用 workbuddy；probe 或 test 等值会禁用首次价值自动记录。
hostType	string	否	可选宿主类型，例如 WORKBUDDY、WORKBUDDY_AI 或 CODEBUDDY。宿主以工具参数传递时，对应 x-fbss-host-type。
productTrack	string	否	可选产品线，例如 domestic 或 international。宿主以工具参数传递时，对应 x-fbss-product-track。
productId	string	否	可选产品归因标识。当前展示的单个超级伙伴必须使用 fbsir-super-partner；冻结旧团队标识不得用于或提升为当前单专家。
serviceProductId	string	否	可选服务产品别名。当前单个超级伙伴使用 workbuddy_super_partner_expert，但不能替代 productId=fbsir-super-partner。
packageName	string	否	可选宿主插件包名。当前单个超级伙伴包名为 fbsir-super-partner。
marketplace	string	否	可选当前专家包的市场标识，例如 experts。它仅为路由字段，不能单独作为上架证明。
channelTrack	string	否	可选产品渠道线。当前单个超级伙伴使用 super_partner；冻结旧团队使用 expert_team；my_expert 不能覆盖明确的产品或专家身份。
skillId	string	否	可选宿主提供的 WorkBuddy Skill 安装标识。它只表示实例提示，不是稳定的产品归因键。
channel	string	否	可选渠道，例如 workbuddy_cn 或 workbuddy_ai。宿主以工具参数传递时，对应 x-fbss-channel。
clientTrack	string	否	可选客户端路由标签，仅用于探测与转化分段，不能证明上架产品身份。
terminal	string	否	可选终端分类，例如 desktop 或 cloud，仅用于归因分段。
deviceType	string	否	可选宿主传递的设备类型，仅用于归因分段。
hostPlatform	string	否	可选宿主传递的平台信息，仅用于归因分段。
hostVersion	string	否	可选前一同绑定动作信封透传的 WorkBuddy 宿主版本。
hostPatchVersion	string	否	可选前一同绑定动作信封透传的 WorkBuddy 宿主补丁版本。
packageVersion	string	否	可选当前路由的专家包版本。服务端完成上架校验前，该值不可信。
connectorPackageVersion	string	否	可选 FBS 连接器传输包版本，仅为运行元数据，不能覆盖或证明当前专家包版本。
connectorContractVersion	string	否	可选 FBS 连接器协议契约版本。它独立于 connectorPackageVersion，服务端校验前不可信。
sourceRequestSource	string	否	宿主标准化前由调用方提供的原始 requestSource。probe 或 test 值必须保留可见，避免只读工具自动记录首次价值。
trafficClass	string	否	可选流量分类。仅在调用方具有权威依据时使用 probe、synthetic、diagnostic 或 natural；调用方声明不能提升产品归因。
sourceTrafficClass	string	否	服务标准化前的原始流量分类，保留用于审计和排除决策。
sampleClass	string	否	可选样本队列标签，用于可观测性分段和探测排除。
sourceSampleClass	string	否	服务标准化前的原始样本队列标签，保留用于审计。
testRunId	string	否	可选受控测试的唯一标识。测试记录始终不参与自然产品归因。
fbssTestRoute	string	否	可选命名的 FBS 受控测试路由，用于服务端关联和排除。
isSynthetic	unknown	否	可选受控测试标记。接受布尔值 true/false 或字符串 true/false；true 始终不参与产品归因。
traceId	string	否	可选标准化链路标识，仅用于宿主调用与服务证据关联。
clientTraceId	string	否	可选由宿主透传的客户端链路标识，用于观测和日志关联。
hostTraceId	string	否	可选 WorkBuddy 或 CodeBuddy 链路标识，仅作为宿主调用桥接证据。
hostRequestId	string	否	可选宿主请求标识，用于工具调用与服务日志关联。
hostMessageRequestId	string	否	可选宿主消息请求标识，用于重放关联。
traceparent	string	否	可选 W3C traceparent 请求头值，用于分布式链路关联。
traceparentTraceId	string	否	可选从 W3C traceparent 提取的链路标识。
mcpRequestId	string	否	可选回显的 JSON-RPC 请求标识，用于 MCP 调用关联。
requestTraceSource	string	否	可选链路字段派生来源标签，仅用于宿主调用关联。
chainFingerprint	string	否	可选由服务端签发的链路指纹，仅用于同绑定归因和日志关联。

返回字段

返回结构由服务提供方动态定义。

resource-plugin__fbs_scene_pack_query

第二步：仅在 skill_whoami 返回 nextTool=fbs_scene_pack_query 后调用。必须使用服务端下发的准确工具名，并原样透传 actionEnvelope.toolArguments。

输入参数

参数	类型	必填	说明
sessionRef	string	否	可选短会话引用（activate返回）；WorkBuddy宿主链式调用优先使用
sessionToken	string	否	可选JWT会话令牌；匿名阶段将返回激活/路由提示，仅在能保证原样传递时使用
packCode	string	否	服务端权益/场景包编码；专家团只掌握本地路线时可只传scenePackId
anonymousUserCodeHash	string	否	匿名用户编码哈希；用于增强匿名 route relay
serverBindingId	string	否	服务端匿名绑定ID；用于增强匿名 route relay
scenePackId	string	否	专家包本地场景包ID；用于把已确认路线穿过 scene-pack relay
entryId	string	否	可选服务端动作信封携带的标准化入口标识，用于意图归因连续性。
assetType	string	否	可选成果类型追踪，用于价值事件分段和后续激励路由。
intentFamily	string	否	意图族；用于把已确认业务意图穿过 scene-pack relay
profileSegment	string	否	画像分段；用于把已确认业务分层穿过 scene-pack relay
lifecycleStage	string	否	生命周期阶段；用于把已确认状态穿过 scene-pack relay
semanticSource	string	否	可选语义来源追踪，使后续使用、乐包和解锁流程保持归因一致。
personaCode	string	否	人格编码；用于把专家团已确认 persona 穿过 scene-pack relay
customizationLevel	string	否	定制等级；用于把专家团上下文穿过 scene-pack relay
leadAgent	string	否	专家团 leadAgent；用于把团队语义穿过 scene-pack relay
expertLoaded	unknown	否	可选宿主信号。接受布尔值 true/false 或字符串 true/false，部分宿主会将工具参数序列化为字符串。
extensionExpertId	string	否	我的专家扩展专家ID，仅用于观测与归因
extensionExpertVersion	string	否	我的专家扩展专家版本，仅用于观测与归因
extensionKind	string	否	扩展专家类型，当前固定 agent
extensionBatchId	string	否	多 Agent 批次ID，仅用于观测与归因
extensionRole	string	否	扩展 Agent 角色或模板ID，仅用于观测与归因
extensionAccessMode	string	否	扩展专家接入模式，如 shared-connector
templateId	string	否	内置深度模板ID，仅用于观测与归因
toolName	string	否	可选宿主调度提示。若宿主包装器已选定完整 MCP 工具名，应原样透传；服务端会忽略该字段的路由提示。
entrySurface	string	否	可选服务端动作信封携带的入口页面追踪，用于归因和后续链路完整性。
entryPromptCode	string	否	可选服务端动作信封携带的入口提示词追踪，用于归因和后续链路完整性。
expertEntryId	string	否	可选专家入口标识。当前展示的单个超级伙伴必须使用 fbsir-super-partner；fbsir-super-partner-group 是独立冻结的旧专家团队。通用 my_expert 页面不代表专家身份。
defaultPromptId	string	否	可选起始提示词标识，用于保持入口归因连续性。
cardActionId	string	否	可选起始卡片动作标识，用于保持入口归因连续性。
activeExpertEntryId	string	否	可选当前激活的专家入口标识，用于宿主后续链路兼容。
requestSource	string	否	可选来源追踪。真实 WorkBuddy 宿主调用使用 workbuddy；probe 或 test 等值会禁用首次价值自动记录。
hostType	string	否	可选宿主类型，例如 WORKBUDDY、WORKBUDDY_AI 或 CODEBUDDY。宿主以工具参数传递时，对应 x-fbss-host-type。
productTrack	string	否	可选产品线，例如 domestic 或 international。宿主以工具参数传递时，对应 x-fbss-product-track。
productId	string	否	可选产品归因标识。当前展示的单个超级伙伴必须使用 fbsir-super-partner；冻结旧团队标识不得用于或提升为当前单专家。
serviceProductId	string	否	可选服务产品别名。当前单个超级伙伴使用 workbuddy_super_partner_expert，但不能替代 productId=fbsir-super-partner。
packageName	string	否	可选宿主插件包名。当前单个超级伙伴包名为 fbsir-super-partner。
marketplace	string	否	可选当前专家包的市场标识，例如 experts。它仅为路由字段，不能单独作为上架证明。
channelTrack	string	否	可选产品渠道线。当前单个超级伙伴使用 super_partner；冻结旧团队使用 expert_team；my_expert 不能覆盖明确的产品或专家身份。
skillId	string	否	可选宿主提供的 WorkBuddy Skill 安装标识。它只表示实例提示，不是稳定的产品归因键。
channel	string	否	可选渠道，例如 workbuddy_cn 或 workbuddy_ai。宿主以工具参数传递时，对应 x-fbss-channel。
clientTrack	string	否	可选客户端路由标签，仅用于探测与转化分段，不能证明上架产品身份。
terminal	string	否	可选终端分类，例如 desktop 或 cloud，仅用于归因分段。
deviceType	string	否	可选宿主传递的设备类型，仅用于归因分段。
hostPlatform	string	否	可选宿主传递的平台信息，仅用于归因分段。
hostVersion	string	否	可选前一同绑定动作信封透传的 WorkBuddy 宿主版本。
hostPatchVersion	string	否	可选前一同绑定动作信封透传的 WorkBuddy 宿主补丁版本。
packageVersion	string	否	可选当前路由的专家包版本。服务端完成上架校验前，该值不可信。
connectorPackageVersion	string	否	可选 FBS 连接器传输包版本，仅为运行元数据，不能覆盖或证明当前专家包版本。
connectorContractVersion	string	否	可选 FBS 连接器协议契约版本。它独立于 connectorPackageVersion，服务端校验前不可信。
sourceRequestSource	string	否	宿主标准化前由调用方提供的原始 requestSource。probe 或 test 值必须保留可见，避免只读工具自动记录首次价值。
trafficClass	string	否	可选流量分类。仅在调用方具有权威依据时使用 probe、synthetic、diagnostic 或 natural；调用方声明不能提升产品归因。
sourceTrafficClass	string	否	服务标准化前的原始流量分类，保留用于审计和排除决策。
sampleClass	string	否	可选样本队列标签，用于可观测性分段和探测排除。
sourceSampleClass	string	否	服务标准化前的原始样本队列标签，保留用于审计。
testRunId	string	否	可选受控测试的唯一标识。测试记录始终不参与自然产品归因。
fbssTestRoute	string	否	可选命名的 FBS 受控测试路由，用于服务端关联和排除。
isSynthetic	unknown	否	可选受控测试标记。接受布尔值 true/false 或字符串 true/false；true 始终不参与产品归因。
traceId	string	否	可选标准化链路标识，仅用于宿主调用与服务证据关联。
clientTraceId	string	否	可选由宿主透传的客户端链路标识，用于观测和日志关联。
hostTraceId	string	否	可选 WorkBuddy 或 CodeBuddy 链路标识，仅作为宿主调用桥接证据。
hostRequestId	string	否	可选宿主请求标识，用于工具调用与服务日志关联。
hostMessageRequestId	string	否	可选宿主消息请求标识，用于重放关联。
traceparent	string	否	可选 W3C traceparent 请求头值，用于分布式链路关联。
traceparentTraceId	string	否	可选从 W3C traceparent 提取的链路标识。
mcpRequestId	string	否	可选回显的 JSON-RPC 请求标识，用于 MCP 调用关联。
requestTraceSource	string	否	可选链路字段派生来源标签，仅用于宿主调用关联。
chainFingerprint	string	否	可选由服务端签发的链路指纹，仅用于同绑定归因和日志关联。

返回字段

返回结构由服务提供方动态定义。

resource-plugin__skill_consume

第三步：仅在场景包卡片已实际交付或已确认持续使用后调用。在同一绑定链路中记录 first_value_completed 或 continued_use_completed，并携带服务端幂等键。

输入参数

参数	类型	必填	说明
sessionRef	string	否	短会话引用（activate返回）；WorkBuddy宿主链式调用优先使用
sessionToken	string	否	JWT会话令牌；仅在能保证原样传递时使用
packCode	string	否	—
skillCode	string	否	—
usageRecordId	string	否	—
authCode	string	否	—
packId	string	否	—
pointsRuleCode	string	否	—
pointsAmount	number	否	—
bizNo	string	否	—
autoCommit	boolean	否	—；默认值：false
voucherId	string	否	—
sourceEventCode	string	否	—
achievementCode	string	否	—
capabilityCode	string	否	—
unlockCapabilityCode	string	否	—
scenePackId	string	否	—
intentFamily	string	否	—
intentClass	string	否	—
lifecycleStage	string	否	—
profileSegment	string	否	—
anonymousUserCodeHash	string	否	—
serverBindingId	string	否	—
clientTraceId	string	否	可选由宿主透传的客户端链路标识，用于观测和日志关联。
toolName	string	否	可选宿主调度提示。若宿主包装器已选定完整 MCP 工具名，应原样透传；服务端会忽略该字段的路由提示。
entrySurface	string	否	可选服务端动作信封携带的入口页面追踪，用于归因和后续链路完整性。
entryPromptCode	string	否	可选服务端动作信封携带的入口提示词追踪，用于归因和后续链路完整性。
entryId	string	否	可选服务端动作信封携带的标准化入口标识，用于意图归因连续性。
semanticSource	string	否	可选语义来源追踪，使后续使用、乐包和解锁流程保持归因一致。
assetType	string	否	可选成果类型追踪，用于价值事件分段和后续激励路由。
expertEntryId	string	否	可选专家入口标识。当前展示的单个超级伙伴必须使用 fbsir-super-partner；fbsir-super-partner-group 是独立冻结的旧专家团队。通用 my_expert 页面不代表专家身份。
defaultPromptId	string	否	可选起始提示词标识，用于保持入口归因连续性。
cardActionId	string	否	可选起始卡片动作标识，用于保持入口归因连续性。
activeExpertEntryId	string	否	可选当前激活的专家入口标识，用于宿主后续链路兼容。
expertLoaded	unknown	否	可选宿主信号。接受布尔值 true/false 或字符串 true/false，部分宿主会将工具参数序列化为字符串。
eventType	string	否	价值事件阶段。优先使用 first_value_completed 或 continued_use_completed。
outcome	string	否	与 eventType 对齐的明确结果。至少提供 eventType 或 outcome 之一。
idempotencyKey	string	否	同一绑定链路中重复记录价值事件时使用的稳定去重键。
requestSource	string	否	可选来源追踪。真实 WorkBuddy 宿主调用使用 workbuddy；probe 或 test 等值会禁用首次价值自动记录。
hostType	string	否	可选宿主类型，例如 WORKBUDDY、WORKBUDDY_AI 或 CODEBUDDY。宿主以工具参数传递时，对应 x-fbss-host-type。
productTrack	string	否	可选产品线，例如 domestic 或 international。宿主以工具参数传递时，对应 x-fbss-product-track。
productId	string	否	可选产品归因标识。当前展示的单个超级伙伴必须使用 fbsir-super-partner；冻结旧团队标识不得用于或提升为当前单专家。
serviceProductId	string	否	可选服务产品别名。当前单个超级伙伴使用 workbuddy_super_partner_expert，但不能替代 productId=fbsir-super-partner。
packageName	string	否	可选宿主插件包名。当前单个超级伙伴包名为 fbsir-super-partner。
marketplace	string	否	可选当前专家包的市场标识，例如 experts。它仅为路由字段，不能单独作为上架证明。
channelTrack	string	否	可选产品渠道线。当前单个超级伙伴使用 super_partner；冻结旧团队使用 expert_team；my_expert 不能覆盖明确的产品或专家身份。
skillId	string	否	可选宿主提供的 WorkBuddy Skill 安装标识。它只表示实例提示，不是稳定的产品归因键。
channel	string	否	可选渠道，例如 workbuddy_cn 或 workbuddy_ai。宿主以工具参数传递时，对应 x-fbss-channel。
clientTrack	string	否	可选客户端路由标签，仅用于探测与转化分段，不能证明上架产品身份。
terminal	string	否	可选终端分类，例如 desktop 或 cloud，仅用于归因分段。
deviceType	string	否	可选宿主传递的设备类型，仅用于归因分段。
hostPlatform	string	否	可选宿主传递的平台信息，仅用于归因分段。
hostVersion	string	否	可选前一同绑定动作信封透传的 WorkBuddy 宿主版本。
hostPatchVersion	string	否	可选前一同绑定动作信封透传的 WorkBuddy 宿主补丁版本。
packageVersion	string	否	可选当前路由的专家包版本。服务端完成上架校验前，该值不可信。
connectorPackageVersion	string	否	可选 FBS 连接器传输包版本，仅为运行元数据，不能覆盖或证明当前专家包版本。
connectorContractVersion	string	否	可选 FBS 连接器协议契约版本。它独立于 connectorPackageVersion，服务端校验前不可信。
sourceRequestSource	string	否	宿主标准化前由调用方提供的原始 requestSource。probe 或 test 值必须保留可见，避免只读工具自动记录首次价值。
trafficClass	string	否	可选流量分类。仅在调用方具有权威依据时使用 probe、synthetic、diagnostic 或 natural；调用方声明不能提升产品归因。
sourceTrafficClass	string	否	服务标准化前的原始流量分类，保留用于审计和排除决策。
sampleClass	string	否	可选样本队列标签，用于可观测性分段和探测排除。
sourceSampleClass	string	否	服务标准化前的原始样本队列标签，保留用于审计。
testRunId	string	否	可选受控测试的唯一标识。测试记录始终不参与自然产品归因。
fbssTestRoute	string	否	可选命名的 FBS 受控测试路由，用于服务端关联和排除。
isSynthetic	unknown	否	可选受控测试标记。接受布尔值 true/false 或字符串 true/false；true 始终不参与产品归因。
traceId	string	否	可选标准化链路标识，仅用于宿主调用与服务证据关联。
hostTraceId	string	否	可选 WorkBuddy 或 CodeBuddy 链路标识，仅作为宿主调用桥接证据。
hostRequestId	string	否	可选宿主请求标识，用于工具调用与服务日志关联。
hostMessageRequestId	string	否	可选宿主消息请求标识，用于重放关联。
traceparent	string	否	可选 W3C traceparent 请求头值，用于分布式链路关联。
traceparentTraceId	string	否	可选从 W3C traceparent 提取的链路标识。
mcpRequestId	string	否	可选回显的 JSON-RPC 请求标识，用于 MCP 调用关联。
requestTraceSource	string	否	可选链路字段派生来源标签，仅用于宿主调用关联。
chainFingerprint	string	否	可选由服务端签发的链路指纹，仅用于同绑定归因和日志关联。

返回字段

返回结构由服务提供方动态定义。

resource-plugin__skill_activate

通过访问码激活 Skill 权益，返回后续调用所需的 sessionRef 和 sessionToken。仅在用户明确提供访问码，或身份识别/会话接力明确要求激活时使用，不得作为首轮业务步骤。

输入参数

参数	类型	必填	说明
accessCode	string	是	访问码，格式FBS-XXXX-XXXX-XXXX
skillCode	string	是	Skill编码
hostType	string	否	可选宿主类型，例如 WORKBUDDY、WORKBUDDY_AI 或 CODEBUDDY。宿主以工具参数传递时，对应 x-fbss-host-type。；默认值：WORKBUDDY；可选值：WORKBUDDY、DEVBUDDY、CODEBUDDY
anonymousUserCodeHash	string	否	可选匿名用户编码哈希；有 whoami 上下文时透传可避免试用激活身份分叉
serverBindingId	string	否	可选服务端绑定ID；有 whoami 上下文时透传可保持领取链连续性
scenePackId	string	否	专家包本地场景包ID；用于把 whoami 已确认路线穿过 activate relay
entryId	string	否	可选服务端动作信封携带的标准化入口标识，用于意图归因连续性。
assetType	string	否	可选成果类型追踪，用于价值事件分段和后续激励路由。
intentFamily	string	否	意图族；用于把 whoami 已确认业务意图穿过 activate relay
profileSegment	string	否	画像分段；用于把 whoami 已确认业务分层穿过 activate relay
lifecycleStage	string	否	生命周期阶段；用于把 whoami 已确认状态穿过 activate relay
packCode	string	否	服务端权益包编码；用于把已确认 packCode 穿过 activate relay
semanticSource	string	否	可选语义来源追踪，使后续使用、乐包和解锁流程保持归因一致。
personaCode	string	否	人格编码；用于把专家团已确认 persona 穿过 activate relay
customizationLevel	string	否	定制等级；用于把专家团上下文穿过 activate relay
leadAgent	string	否	专家团 leadAgent；用于把团队语义穿过 activate relay
expertLoaded	boolean	否	可选宿主信号。接受布尔值 true/false 或字符串 true/false，部分宿主会将工具参数序列化为字符串。
extensionExpertId	string	否	我的专家扩展专家ID，仅用于观测与归因
extensionExpertVersion	string	否	我的专家扩展专家版本，仅用于观测与归因
extensionKind	string	否	扩展专家类型，当前固定 agent
extensionBatchId	string	否	多 Agent 批次ID，仅用于观测与归因
extensionRole	string	否	扩展 Agent 角色或模板ID，仅用于观测与归因
extensionAccessMode	string	否	扩展专家接入模式，如 shared-connector
templateId	string	否	内置深度模板ID，仅用于观测与归因
toolName	string	否	可选宿主调度提示。若宿主包装器已选定完整 MCP 工具名，应原样透传；服务端会忽略该字段的路由提示。

返回字段

返回结构由服务提供方动态定义。

resource-plugin__skill_precheck

校验当前用户是否拥有指定场景包权益及足够积分。仅在身份或会话已明确后，用于显式权益或积分校验。

输入参数

参数	类型	必填	说明
sessionRef	string	否	短会话引用（activate返回）；WorkBuddy宿主链式调用优先使用
sessionToken	string	否	JWT会话令牌；仅在能保证原样传递时使用
skillCode	string	是	Skill编码
packCode	string	否	场景包编码
capacityCode	string	否	兼容旧参数，将作为packCode兜底
clientTraceId	string	否	可选由宿主透传的客户端链路标识，用于观测和日志关联。
toolName	string	否	可选宿主调度提示。若宿主包装器已选定完整 MCP 工具名，应原样透传；服务端会忽略该字段的路由提示。

返回字段

返回结构由服务提供方动态定义。

resource-plugin__skill_finish

更新使用记录的完成状态。仅在业务流程实际完成后调用，不用于首轮入口或首次价值阶段。

输入参数

参数	类型	必填	说明
sessionRef	string	否	短会话引用（activate返回）；WorkBuddy宿主链式调用优先使用
sessionToken	string	否	JWT会话令牌；仅在能保证原样传递时使用
usageId	string	是	—
status	number	是	—；可选值：1、2
voucherId	string	否	—
sourceEventCode	string	否	—
achievementCode	string	否	—
capabilityCode	string	否	—
unlockCapabilityCode	string	否	—
scenePackId	string	否	—
intentFamily	string	否	—
intentClass	string	否	—
lifecycleStage	string	否	—
profileSegment	string	否	—
anonymousUserCodeHash	string	否	—
serverBindingId	string	否	—
clientTraceId	string	否	可选由宿主透传的客户端链路标识，用于观测和日志关联。
toolName	string	否	可选宿主调度提示。若宿主包装器已选定完整 MCP 工具名，应原样透传；服务端会忽略该字段的路由提示。

返回字段

返回结构由服务提供方动态定义。

resource-plugin__skill_logout

主动注销当前会话。仅在用户明确要求退出登录或重置会话状态时调用。

输入参数

参数	类型	必填	说明
sessionRef	string	否	短会话引用（activate返回）；WorkBuddy宿主链式调用优先使用
sessionToken	string	否	JWT会话令牌；仅在能保证原样传递时使用
toolName	string	否	可选宿主调度提示。若宿主包装器已选定完整 MCP 工具名，应原样透传；服务端会忽略该字段的路由提示。

返回字段

返回结构由服务提供方动态定义。

resource-plugin__lebao_redeem

将本地 .FBS 乐包凭证兑换为福帮手站内积分或专家团权益。仅在已有明确乐包凭证载荷时使用，不属于首轮诊断主链。

输入参数

参数	类型	必填	说明
sessionRef	string	否	可选短会话引用（activate返回）
sessionToken	string	否	可选JWT会话令牌；仅在能保证原样传递时使用
voucherId	string	是	—
sourceSkillCode	string	是	—
sourceEventCode	string	是	—
rewardRuleCode	string	是	—
rewardType	string	否	—
rewardAmount	number	否	—
rewardPackCode	string	否	—
issuedAt	string	否	—
expiresAt	string	否	—
anonymousUserCodeHash	string	是	—
deviceBindingCodeHash	string	否	—
workspaceFingerprintHash	string	否	—
hostUserHintHash	string	否	—
issuer	string	是	—
nonce	string	是	—
payloadEncoded	string	是	—
payloadCiphertext	string	否	—
signature	string	是	—
clientTraceId	string	否	可选由宿主透传的客户端链路标识，用于观测和日志关联。
achievementCode	string	否	—
capabilityCode	string	否	—
unlockCapabilityCode	string	否	—
scenePackId	string	否	—
packCode	string	否	—
usageRecordId	string	否	—
usageId	string	否	—
intentFamily	string	否	—
intentClass	string	否	—
lifecycleStage	string	否	—
profileSegment	string	否	—
toolName	string	否	可选宿主调度提示。若宿主包装器已选定完整 MCP 工具名，应原样透传；服务端会忽略该字段的路由提示。

返回字段

返回结构由服务提供方动态定义。

resource-plugin__lebao_status

查询乐包兑换和匿名绑定状态（只读）。至少提供 voucherId、serverBindingId、anonymousUserCodeHash 之一；仅在已有绑定或价值证据后用于显式状态查询。

输入参数

参数	类型	必填	说明
sessionRef	string	否	可选短会话引用（activate返回）
sessionToken	string	否	可选JWT会话令牌；仅在能保证原样传递时使用
voucherId	string	否	乐包唯一凭证ID；三选一定位字段
serverBindingId	string	否	服务端绑定ID；三选一定位字段
anonymousUserCodeHash	string	否	匿名用户编码哈希；三选一定位字段
sourceEventCode	string	否	—
rewardPackCode	string	否	—
achievementCode	string	否	—
capabilityCode	string	否	—
unlockCapabilityCode	string	否	—
scenePackId	string	否	—
packCode	string	否	—
intentFamily	string	否	—
intentClass	string	否	—
lifecycleStage	string	否	—
profileSegment	string	否	—
clientTraceId	string	否	可选由宿主透传的客户端链路标识，用于观测和日志关联。
toolName	string	否	可选宿主调度提示。若宿主包装器已选定完整 MCP 工具名，应原样透传；服务端会忽略该字段的路由提示。

返回字段

返回结构由服务提供方动态定义。

resource-plugin__lebao_claim

将乐包归并到当前会话用户并触发服务端发奖。仅在服务端已将用户推进到权益或升级阶段时调用。

输入参数

参数	类型	必填	说明
sessionRef	string	否	短会话引用（activate返回）；WorkBuddy宿主链式调用优先使用
sessionToken	string	否	JWT会话令牌；仅在能保证原样传递时使用
voucherId	string	否	—
serverBindingId	string	否	—
anonymousUserCodeHash	string	否	—
sourceEventCode	string	否	—
rewardPackCode	string	否	—
achievementCode	string	否	—
capabilityCode	string	否	—
unlockCapabilityCode	string	否	—
scenePackId	string	否	—
packCode	string	否	—
intentFamily	string	否	—
intentClass	string	否	—
lifecycleStage	string	否	—
profileSegment	string	否	—
clientTraceId	string	否	可选由宿主透传的客户端链路标识，用于观测和日志关联。
toolName	string	否	可选宿主调度提示。若宿主包装器已选定完整 MCP 工具名，应原样透传；服务端会忽略该字段的路由提示。

返回字段

返回结构由服务提供方动态定义。

resource-plugin__lebao_drop

放弃或取消乐包权益。

输入参数

该远程 MCP 工具的参数结构由提供方在当前用户完成授权后返回。请在插件市场详情页的“插件工具”页签查看完整参数表。

返回字段

返回字段由服务提供方按当前工具版本定义。

使用约束

• 先在插件市场安装插件，再将其添加到智能体或工作流；插件参数由对应工具节点配置。
• 对会改变外部数据的工具（例如发送邮件、创建生成任务、领取权益或财务操作），应在智能体指令中要求用户明确确认后再执行。
• 调用失败时应检查授权状态、必填字段、提供方配额和网络可达性；不要用编造的数据替代工具结果。