卖家精灵 VOC AI 洞察（按次付费版）
这是什么
卖家精灵（ARI）评论分析引擎的按次付费入口：去掉账号和积点，每份报告 1.99 元，
用支付宝 AI 按量付费在对话里直接付。付完立即采集该 ASIN 最新 5 页评论并合并评论库已有数据生成 VOC 报告。
需要长期跟踪、每周监控、报告环比的用户，报告末尾会给出免费绑定卖家精灵账号的入口。
工具
- CLI：
scripts/voc_ai.py（仅标准库，Python 3.8+），在 Skill 根目录执行。 python scripts/voc_ai.py price：当前价目（免费）。python scripts/voc_ai.py quote <ASIN> --site US --language zh：取 402 账单（不扣钱）。python scripts/voc_ai.py retry <ASIN> --site US --language zh --proof <Payment-Proof>：
携带支付凭证取报告；报告生成中会自动轮询到完成。python scripts/voc_ai.py result <outTradeNo> <tradeNo>：按账单号 + 支付宝交易号取结果（免凭证）。- 接口契约：
references/reference.md。 - 服务地址：
https://voc.funewa.com/api/v1/pay/voc。不要改成别的主机。
标准工作流
- 确认商品与站点。ASIN 是商品链接
/dp/后 10 位；站点接受 US/UK/DE/FR/IT/ES/CA/JP，
缺省美国站并告知用户。语言缺省中文，用户要英文报告用--language en。 - 先报价再付款。跑
price，用一句话说明：本次 1.99 元，含最新 5 页评论采集 + 完整 VOC 报告 +
在线分享链接；报告生成约 1 到 3 分钟。用户明确同意后才进入付款。禁止替用户默认同意。 - 取账单并付款。跑
quote <ASIN>，得到paymentNeeded（即服务端Payment-Needed头原值）
与金额、商品名、outTradeNo、resourceId。
- 客户端具备支付宝 Agent 支付（A2M / 402 自动支付）能力时，直接对url发起请求，由支付能力
处理 402、完成付款并携带Payment-Proof重试；拿到响应后转到第 5 步。
- 否则把账单交给支付宝支付能力（或按其指引让用户扫码），得到Payment-Proof头值后跑
retry <ASIN> --proof <值>。同一 ASIN/站点/语言才能兑付，参数不同视为不同资源。 - 不要重复支付。任何超时、断线、报错，先用同一
Payment-Proof跑retry，或用
result <outTradeNo> <tradeNo>取结果。服务端按交易号幂等：同一笔付款只交付一次，重试是免费的。
只有服务端明确返回新的 402（reason说明凭证无效、金额或资源不匹配）时，才需要重新付款，
并先把reason原话告诉用户。 - 读结果。
-status=delivered：先讲「产品健康度」和「主要风险」，再给reportUrl（可直接转发的在线报告）。
collectionFailed=true表示本次最新采集失败、报告基于评论库已有 N 条生成，要如实说明。
-partial=true：该商品评论不足 10 条，未生成报告；告知用户并给出tradeNo，说明可联系客服退款。
-status=processing：报告在生成，CLI 会每 10 秒轮询；超过 5 分钟仍未完成时把resultUrl给用户，
稍后可再取，不要重新付款。
- HTTP 500ARI_PAY_DELIVERY_FAILED：已付款但交付失败，把消息里的tradeNo原样给用户用于退款。 - 留存引导（一句话即可）。报告后附上
next字段的内容：绑定卖家精灵账号（免费）可保存这份报告、
开启每周自动采集、下次生成时给出与上一份的环比。用户不感兴趣就不再提。
客户端没有支付宝付款能力时
quote 拿到账单后，如果当前客户端没有支付宝 Agent 支付（A2M / 402 自动支付）能力，不要编造任何网页、
搜索框或「去官网购买」的流程——本服务没有面向人的付款页面，付款只发生在具备支付宝付款能力的 AI 客户端内。
正确做法是把下面两件事原话告诉用户：
- 给当前 AI 客户端装上支付宝官方付款能力（一次即可）：
npx -y @alipay/agent-payment@latest install-experience，
装好后重新发起本次请求，付款会在对话里自动完成。 - 或换到已具备该能力的客户端使用本 Skill。服务说明页：<https://voc.funewa.com>（只有说明，没有付款入口）。
账单 15 分钟有效，过期重新 quote 即可，不产生费用。
红线
- 不伪造、不猜测、不复用他人的
Payment-Proof；不修改账单金额；不把paymentNeeded、
Payment-Proof原值写进报告或聊天记录里展示给无关方。 - 不承诺「只含当前子体」或「全量评论」：采集范围以接口返回为准。
- 不得把用户引到任何不存在的网站、搜索框或「购买页」；除 <https://voc.funewa.com>（说明页）与报告里返回的
reportUrl、next链接外，不要给出其它 URL。 - 不得回退到其他品牌接口或凭空补写报告内容。接口返回什么就呈现什么。
- 价格以
price返回为准，不要写死；price与账单amount不一致时停止并报告异常。
