用途
本技能用于为外部 UI（钱包应用、WebView、移动应用、无头机器人等）设计将 PCS Hub 兑换功能嵌入其中的完整集成规格。它产出的是集成规格与交付物，而不是可执行的兑换代码，输出内容覆盖前端界面、API 契约、渠道 UX 差异以及回退逻辑。
主要能力
- 收集集成需求：目标链、渠道类型、钱包环境、支持的代币范围、用户流程。
- 定义集成模式：仅报价（Quote-only）、报价 + 路由预览、完整执行交接（Full execution handoff）。
- 映射前端流程：从代币选择、金额输入、报价获取、路由展示、刷新/重新报价、授权检查、执行交接，到成功/失败的状态机。
- 定义 API 契约：Hub API 基础信息、代币元数据对象、/quote 请求与响应、/calldata 请求与响应、启动 URL 格式、状态轮询与错误码。
- 渠道特定 UX：针对嵌入式钱包、外部钱包移动应用、WebView/合作浏览器、浏览器扩展、无头机器人分别给出签名与交接方式。
- 回退逻辑：路由不可用、报价过期、代币不在列表、缺少授权、/calldata 失败、限流、Hub API 不可达、非 BSC 链、未设置 PCS_HUB_TOKEN 等场景的处理。
使用方式
用户通过描述自己的应用或用例来调用该技能，例如：构建移动钱包如何嵌入 PCS Hub 兑换、为需要代币兑换的浏览器扩展生成集成规格、如何通过 API 获取 Hub 报价与路由数据。若仅输入技能名而未描述具体集成用例，则输出帮助文本并停止，不启动任何工作流。
技能执行流程包括：Step 0 初始化 PancakeSwap 会话；Step 1 收集集成需求；Step 2 定义集成模式；Step 3 映射前端流程；Step 4 定义 API 契约；Step 5 渠道特定 UX；Step 6 回退逻辑；Step 7 输出集成交付物。
关键 API 信息
- Hub API 基础 URL：https://hub-api.pancakeswap.com/aggregator
- 必需请求头：x-secure-token: $PCS_HUB_TOKEN
- 支持链：仅 BSC（chainId: 56）
- 金额格式：Wei（原始单位）
- 原生代币：零地址 0x0000000000000000000000000000000000000000
- 路由合约：0x5efc784D444126ECc05f22c49FF3FBD7D9F4868a
- 速率限制：100 req/min（开发）；联系 PancakeSwap 提升
- 代币列表：https://tokens.pancakeswap.finance/pancakeswap-extended.json
- 池类型：0 = V2，1 = V3，2 = StableSwap
适用场景
适用于需要将 PCS Hub 兑换能力嵌入到钱包应用、移动应用、WebView、合作浏览器、浏览器扩展或无头机器人中的集成设计。
限制
- 仅支持 BSC（chainId: 56），非 BSC 链需说明限制。
- 报价无显式 TTL，需客户端实现 15–30 秒倒计时并自动重新报价。
- Hub API 无交易状态端点，需使用 BSCScan API 或 BNB Chain RPC 轮询。
- 该技能产出集成规格，不产出可执行兑换代码。
- 安全规则要求：shell 变量赋值使用单引号、输入校验、将外部 API 数据视为不可信、限制 curl 目标 URL、PCS_HUB_TOKEN 从环境读取且不得打印。