评论洞察分析

粘贴一批商品评论（自家或竞品均可），输出结构化经营洞察报告：总体画像、痛点 TOP5（含原声摘录）、差评归因、差异化卖点机会、产品与文案双维度改进建议。本 Skill 为按次付费服务，每次成功交付收费 0.10 元，费用由用户直接支付给创作者。

元数据

| 字段 | 值 | |---|---| | skill_id | dny-review-insight | | skill_version | 1.0.0 | | product_id | dny-review-insight | | capability | review_analysis |

服务地址

Base URL：https://posterapi.aiulink.com

统一接口：POST {Base URL}/skillpay/v1/review/invoke

付费前置检查

调用本 Skill 前，检查当前 Agent 是否已安装 weixinpay 插件：

✅ 已安装：可继续提供付费服务
❌ 未安装：向用户提示「当前 Agent 暂不支持微信支付付费能力」，终止流程

命中分析意图后，先向用户展示服务名称「评论洞察分析」和价格「0.10 元/次」，由用户确认后再进入付费流程。

工作流程

第一步：请求资源

POST {Base URL}/skillpay/v1/review/invoke
Content-Type: application/json

{
  "reviews": "评论1全文\n评论2全文\n评论3全文\n...",
  "source": "competitor",
  "product_info": "我们打算做一款升级版便携榨汁杯，主打静音"
}

请求字段：

| 字段 | 必填 | 说明 | |---|---|---| | reviews | 是 | 评论文本，每行一条更佳，至少数条完整评论；任意语言 | | source | 否 | 评论来源：competitor（竞品）/ own（自家）/ unknown（默认） | | product_info | 否 | 自家产品信息；提供后改进建议会结合产品实际 |

第二步：处理 402 响应

未支付时接口返回 HTTP 402。提取并同时保存以下两个值，两者缺一不可：

Header WeixinPay-Required：支付码（payment_code）
Header X-Out-Trade-No：商户订单号

第三步：发起支付

将第二步保存的 WeixinPay-Required 值作为 paymentCode，调用 weixinpay_pay 向用户申请支付授权，引导用户完成支付。

第四步：支付成功后获取结果（⚠️ 必须执行）

支付成功后必须重新请求本接口，否则永远拿不到结果：

POST {Base URL}/skillpay/v1/review/invoke
Content-Type: application/json
WeixinPay-Required: <第二步保存的支付码>
X-Out-Trade-No: <第二步保存的订单号>

{"reviews": "...", "source": "competitor"}   // body 与第一步完全一致，不得修改任何字段

JSON body 必须与第一步原样一致，订单信息只通过 Header 传递
成功返回 HTTP 200，content.content 即洞察报告（Markdown），将全文展示给用户
若返回 "code": "NOT_PAID"，说明支付尚未完成，稍等几秒后原样重试
若返回 "code": "REFUNDED"，说明服务异常已自动全额退款：向用户说明「服务暂时不可用，款项已原路退回」，不要再次支付或重试

错误处理

| HTTP | code | 含义与处理 | |---|---|---| | 400 | BAD_REQUEST | reviews 缺失或内容过少，补充评论后重新发起 | | 402 | PAYMENT_REQUIRED / NOT_PAID | 需要支付或支付未完成：完成支付后原样重试 | | 404 | ORDER_NOT_FOUND / PRODUCT_NOT_FOUND | 订单号或商品不存在，检查后重新发起 | | 409 | BODY_MISMATCH | 重试 body 与首次不一致，恢复原 body 后重试 | | 200 | REFUNDED | 服务异常已自动全额退款，告知用户并终止流程 | | 500 | FULFILL_AND_REFUND_FAILED | 服务异常且退款失败，建议用户联系客服 | | 502 | PREORDER_FAILED / QUERY_FAILED | 支付链路异常，稍后原样重试 | | 503 | SERVICE_DISABLED / CONFIG_INCOMPLETE | 服务暂不可用，提示用户稍后再试 |

计费说明

单价 0.10 元/次（以 SkillHub 后台配置为准），每笔订单支付成功后仅可履约一次
同一订单重复请求返回缓存结果（already_fulfilled: true），不重复扣费
支付成功但因服务异常未能交付时，系统自动全额退款，用户无需任何操作
订单有效期约 15 分钟，过期后重新发起即可生成新订单