采购决策分析（按量付费）

> 单次价格：¥2.99　|　计费单位：一次调用　|　货币：CNY

本 Skill 是一个 A402（HTTP 402 Payment Required）付费资源的买家侧接入包。
调用时若未付款，服务端返回 HTTP 402 与账单；付款后重试同一请求即取得结果。

一、能做什么

报价归一化对比 / TCO / 加权评分 / 库存补货 / 进口 landed cost。

核心特点：全部为确定性算法，与本地脚本结果逐字节一致，不依赖大模型、不受随机性影响。结果中的每个数字都能手工复算。

> 五种模式的 payload 结构见 references/params.md。

二、调用流程（三步）

前置：npm install -g @alipay/agent-payment，并确认 alipay-bot check-wallet 返回 status: bound。
（依赖安装与排错细节见 references/usage.md）

第 1 步：probe —— 触发 402 账单

node scripts/paid-runner.mjs probe \
  --state-dir .state/my-session \
  --session-id my-session

按配置里的 URL / 方法 / 头 / 请求体发起请求。

• 返回 200 → 已付款或免费，直接交付结果；
• 返回 402 → 提取 Payment-Needed 响应头，原样存为 .state/.../payment-needed.txt，
  输出账单摘要（商品名 / 收款方 / 金额 / 订单号 / 付款截止时间）。

👉 此时必须向用户展示商品名、收款方、金额、用途，并取得确认。

第 2 步：pay —— 用户扫码授权

node scripts/paid-runner.mjs pay \
  --state-dir .state/my-session \
  --intent-summary '原始请求：<用一句话说明这次要做什么>'

把账单文件与原始资源请求交给官方 CLI（alipay-bot 402-buyer-pay），由 CLI 展示支付入口并等待用户扫码。

> ⚠️ 不得代扫、不得改写二维码/链接，必须原样交给用户。
> ⚠️ 支付后重试必须携带与 probe 完全一致的原始请求参数。

第 3 步：complete —— 查询并交付结果

node scripts/paid-runner.mjs complete \
  --state-dir .state/my-session \
  --out-shake-no 'ORDER_...'

用订单号查询原订单，继续原始资源请求。服务端验证付款凭证后返回结果并完成商家履约确认。

成功路径不追加独立买家回执 —— 官方 CLI 取得非空资源后会自行按流程发送。
绝不因回执失败要求用户重新付款。

三、结果展示

以 quote 模式为例：

📊 报价归一化对比（基准：现供应商 ¥13.60）

供应商    ｜ 含税单价 ｜ 年成本      ｜ TCO 排序
─────────┼──────────┼────────────┼────────
甲        ｜ ¥15.00   ｜ ¥300,000   ｜ ③
乙        ｜ ¥14.20   ｜ ¥284,000   ｜ ②
丙        ｜ ¥13.80   ｜ ¥276,000   ｜ ① ← 推荐

⚠️ 风险提示：
  · 丙方价格最低但需确认最小起订量与交期
  · 甲方的账期优势（60 天）未计入 TCO，如需请补充参数

展示要求：
1. 结论先行 —— 先给推荐结果，再给明细；
2. 每个数字可溯源 —— 保留原始返回字段，不要四舍五入后再展示；
3. 风险单独列出 —— 不藏在表格里。

四、注意事项

1. 价格以服务端账单为准。 本文档标注的 ¥2.99 是登记价；
   实际金额以 402 响应里的 amount 字段为准，两者应保持一致。
2. 不修改账单原文。 payment-needed.txt 必须原样保存与传回，
   解码仅供展示判断，不得改写后提交。
3. 付款是高敏动作。 必须向用户清晰展示金额与用途并取得确认，
   不得静默发起真实付款。
4. 不实现自己的签名逻辑。 全部交给官方 CLI 与官方依赖。
5. 直接运行脚本即可。 脚本会自行定位所在目录与配置，内置默认值；无需任何前置检查或环境准备。
6. 询问用户意图时，选项不要超过 4 个。 部分宿主环境的选择工具会截断
   超出的选项。本服务有 5 个模式，请先合并为 ≤4 组，或在用户首轮答复后
   再补充询问剩余模式。

更多资料

> 以下文件仅在需要深入排查时查阅，日常调用无需打开。