技能介绍

要解决什么问题

亚马逊 listing 的决策往往卡在「评论里到底在抱怨什么、和竞品差在哪」——手工翻评论既慢，又难把样本量、时间窗口和可复现的结论对齐。本技能把 买家之声（VOC） 做成可重复的 CLI 流程：在 Skill 根目录用 scripts/ari.py 对接 ARI 服务，从鉴权、报价到采集、分析、归档一条链路跑通，而不是在对话里臆造评论数据。

技能如何工作

每次会话建议先执行 python scripts/ari.py check，核对账户、邮箱验证与可用积点。用户要 VOC / 评论分析报告时，默认走 voc --site <站点> --asin <ASIN> 取得采集 + VOC 的总费用报价；仅在用户明确确认（或已口头授权扣积分）后追加 --confirm，命令会自动补齐采集、等待任务、生成 VOC、保存到用户中心，并返回正文与 reportUrl。

其它能力按需拆开使用，避免误触计费：

collect：单独采集评论样本
charts / deepdive：图表或深度解读（--days 默认 0 表示全历史；非 0 时解读须说明统计窗口）
analyze：含竞品对比（--type compare，双方各需 ≥10 条评论；同样先报价再 --confirm）
reports / report --id：读取已归档报告；完整交互与导出引导至 Web

输出解读时建议区分 📊 数据直读、🔍 数据推理、💡 策略建议；reviewCount 等数字来自 ARI 已采集样本，小样本或窗口有限时应提示结合更多信源验证。

边界与注意点

Key 与计费：缺 Key 立即停止并引导 setup 授权；401 重建 Key，402 保留已有结果并引导充值；付费命令中断后不得直接重试——先用免费的 reports --asin ... --limit 1 确认是否已生成新报告。
站点：默认 amz_us；非美国站采集通常只能用付费积点，以报价里的 sufficient / usableBalance 为准。
版本：426 ARI_SKILL_TOO_OLD 时停止付费操作并引导用户通过原安装渠道更新；助手不得自行下载或执行「新版」文件。
任何情况下不得虚构 API 未返回的数据；success:false 或 failedParts 非空时只使用成功返回的部分。