xhs-product-trend-fit
功能描述
用户在宣传一款商品到 xhs 之前，想知道：我的商品对应什么方向，在 xhs 上有没有热度？有没有爆款笔记可以参考？应该怎么宣传？
skill 输入商品信息（图片必填 + 介绍文字），自动完成：
- 识别商品关联的品类/风格/场景方向（LLM 子会话，图片读不了自动退化用文字）
- 用 3~6 个候选搜索词逐个搜索 xhs，判断该方向近 2 周的热度趋势
- 重新组织为 1 个明确的「宣传方向」（不是搜索词），由 2~4 篇真实爆款笔记（赞≥100）支撑
- 对支撑该方向的爆款笔记逐个深入拉取（封面图、标题、正文、互动数、评论区信号）做分析
- 输出 结论文本（data.md）+ 全量数据（res.json）：商品方向 + 按方向的热度趋势判断 + 素材参考（爆款笔记详解 + 分维度爆款分析）；可交付的 HTML 报告由服务端渲染入口从 res.json 确定性生成（同输入同哈希，见 wc3-app 渲染服务）
前置条件
- wc3-chrome 扩展 + Relay 服务已启动（Extension Relay HTTP API 端口 3459），Chrome 已登录 xhs 更稳
- 本地 pipeline 服务运行中（子会话经
wc3-code.mjs代跑，端口 3460） - Node.js >= 22（使用原生 fetch / import.meta.dirname）
使用方式
node skill.mjs [input.json 路径]
# 或：node skill.mjs （自动读 CWD 下 input.json；无 input.json 时用默认值）
input.json 入参：
| 字段 | 必填 | 说明 |
|---|---|---|
product_image |
是 | 商品图片本地路径（用于方向识别；子会话读不了图会自动退化用文字，不阻塞流程） |
product_desc |
是 | 商品介绍文字，建议含品类/材质/风格/适用场景/目标人群 |
output_dir |
否 | 产出 res.json（全量数据，可直接交服务端渲染 HTML 报告）/ data.md（人读结论文本）的目录，默认 /tmp/xhs-product-trend-fit-output |
付费服务（SkillPay 按量付费）
本地免费结论不变：按上述方式运行 skill，产出 data.md + res.json，免费。
在此基础上，额外提供 0.3 元/次 的按量付费服务：把 res.json 提交到付费服务端点，支付成功后返回可交付的可视化 HTML 分析报告（商品图内嵌、素材卡带原文链接、确定性渲染，同输入同 sha256）。
服务端点：https://skillpay.webclaw3.com（长期有效；如不可达，向服务方确认最新地址）
调用流程概要（完整协议见 references/pay-service.md，Agent 必须先读该文件再执行）：
POST /api/task提交 res.json → 返回 task_id 与资源地址GET /demo/a2m/resource?task=<task_id>首次请求返回 402 Payment-Needed（响应头 Payment-Needed 为 base64url 账单：订单号 / 0.3 CNY / RSA2 签名）——即待支付账单- 按支付宝 AI 付协议支付（probe 探单 → pay → Payment-Proof 凭证），真实购买由买方 AI 平台在对话内引导用户完成
- 携带
Payment-Proof凭证重试同一地址 → 服务端验付通过返回 200 + 完整 HTML 报告 - 服务端自动
fulfillment.confirm上报履约回执；订单落库、按 task_id 幂等——重试不重复扣款
失败语义与上下文预算提示：见 references/pay-service.md（凭证无效仍 402；报告约 1.2MB，建议转存文件再展示路径）。
