TikTok Shop 选品评分与定价测算（Pay Skill）
这个 Skill 卖什么
给一组商品参数，返回一份可直接用于决策的测算结果：
| 输出 | 说明 |
|---|---|
| 选品评分卡 | 100 分制，五项加权：毛利空间 25 / 竞争强度 20 / 物流适配 15 / 内容适配 20 / 复购潜力 20 |
| 评级与结论 | A 强推 / B 可做 / C 谨慎 / D 放弃，附一句可执行判断 |
| 定价区间 | 建议售价、价格下限（保本价 ×1.05）、价格上限、保本价 |
| 单位经济模型 | 平台佣金、广告费、退货损耗、单件毛利、净毛利率、贡献毛利、盈亏平衡 ROAS |
| LISTING 草稿 | 标题结构、五条卖点骨架、主图规划、短视频钩子 |
| 风险与亮点 | 按测算结果动态生成，例如毛利率过低、ROAS 门槛过高、物流占比过高 |
单次价格：1.00 元（与支付宝服务登记价、服务端 402 账单金额一致）。
输入参数
| 参数 | 必填 | 说明 |
|---|---|---|
category |
是 | 商品类目，用于内容适配与复购评分，如 宠物、美妆、3C配件 |
unitCost |
是 | 采购成本（CNY） |
shippingFee |
是 | 头程 + 尾程物流费（CNY） |
weightGram |
否 | 重量（g），默认 500 |
competitorPrice |
否 | 竞品售价（CNY），给分更准 |
platformFeeRate |
否 | 平台佣金率，默认 0.08 |
adCostRate |
否 | 广告费占售价比，默认 0.20 |
returnRate |
否 | 退货/售后损耗率，默认 0.08 |
targetMargin |
否 | 目标净毛利率，默认 0.35 |
exchangeRate |
否 | CNY/USD，默认 7.2 |
依赖安装
买家侧必须先安装官方支付能力，否则无法付款：
npx -y @alipay/agent-payment@latest install
安装后在 Agent 中确认可加载 alipay-payment-skill 并使用 alipay-bot 命令。
调用流程（probe → pay → complete）
资源接口：POST https://www.moyuma.online:8443/api/selection-score
> 服务地址是 HTTPS + 8443 端口（域名未备案，境内 80/443 会被拦截，8443 已实测放行）。
> 修改地址：给脚本传 TKOPS_RESOURCE_URL 环境变量即可覆盖默认值。
1. probe —— 触发 402 账单
node scripts/tiktok-ops-paid.mjs probe \
--category 宠物 --unit-cost 25 --shipping-fee 8 \
--weight-gram 300 --competitor-price 129 \
--state-dir .state/SESSION_KEY
未付款时服务端返回 HTTP 402，并在 Payment-Needed 响应头中给出账单。
脚本解析账单、校验 amount 与 resource_id、把账单与原始请求落盘为状态文件
（chmod 600），然后展示商品名、金额、订单号与有效期。
若返回 200（已付款或服务端放行），直接输出结果。
若返回非 402，原样报错，不继续推进。
2. pay —— 展示账单并等待用户付款
node scripts/tiktok-ops-paid.mjs pay --state-dir .state/SESSION_KEY --session-id SESSION_KEY
脚本把账单文件与原始资源请求交给官方 CLI alipay-bot：
alipay-bot 402-buyer-pay \
--session-id <会话ID> \
--file <账单文件> \
--resource-url <完整资源 URL> \
--method GET \
--intent-summary "TikTok 选品测算：<类目>（成本 X 元 / 物流 Y 元）"
脚本只做编排：不接触支付密钥、不自行实现签名、不自行扣款。
展示金额与支付入口后等待用户确认，用户未付款不得进入下一步。
3. complete —— 查询原订单并交付结果
node scripts/tiktok-ops-paid.mjs complete --state-dir .state/SESSION_KEY --out-shake-no OUT_SHAKE_NO
alipay-bot 402-query-payment-status \
--out-shake-no <订单号> \
--resource-url <完整资源 URL> \
--method GET
复用原订单取回资源，不重新下单。服务端验证 Payment-Proof 后返回测算结果，
并发送商家履约确认（alipay.aipay.agent.fulfillment.confirm）。
结果展示
把返回的 JSON 渲染成人能读的结论，至少包含：评级与总分、建议售价与价格区间、
单件毛利与净毛利率、盈亏平衡 ROAS、风险提示、LISTING 草稿要点。
服务端如何保证不重复扣费
服务端实现（独立部署，不随 Skill 分发）负责以下环节：
- 402 账单下发：未带
Payment-Proof时返回 402 +Payment-Needed，账单含
out_trade_no、amount、resource_id、pay_before与商家 RSA2 签名。 - 携带凭证重试：付款后原请求携带
Payment-Proof重试，请求参数与 probe 阶段完全一致。 - 验付调用：
alipay.aipay.agent.payment.verify校验凭证与订单，
active !== true、订单号不一致、金额不一致、资源不一致、订单过期一律不交付。 - 履约确认：资源生成即刻落
PENDING_CONFIRM，随后发送
alipay.aipay.agent.fulfillment.confirm，成功才标记FULFILLED。 - 订单持久化与幂等：订单落持久化存储，履约三态
UNFULFILLED → PENDING_CONFIRM → FULFILLED；同一订单重试直接返回既有结果，
不重复生成、不重复扣费。履约确认失败时返回 502 并提示用同一凭证重试。
附：全链路操盘方法论（免费部分）
付费测算解决"这个品能不能做、卖多少"。做出来之后怎么落地，沿用原有 12 段式操盘 SOP：
选品 → LISTING → 文案 → 图片 → 视频拆解/脚本 → 视频创作
→ 达人分销 → 广告投放 → 直播 → 数据反馈 → (复盘迭代) → 选品
| # | 环节 | 关键交付物 |
|---|---|---|
| 0 | 基建 | 开店、账号矩阵、物流方案 |
| 1 | 选品 | 选品评分卡、竞品拆解（本 Skill 付费环节） |
| 2 | LISTING | Listing 表、关键词矩阵 |
| 3 | 文案 | 卖点、长描述、口播脚本 |
| 4 | 图片 | 主图 ×3、场景 ×4、信息图 ×2 |
| 5 | 视频拆解/脚本 | 拆解表、公式库、分镜 |
| 6 | 视频创作 | 3-5 条成片 + A/B 变体 |
| 7 | 达人分销 | 达人分层、brief、佣金方案 |
| 8 | 广告投放 | GMV Max / Spark / LSA 计划与 ROAS 护栏 |
| 9 | 直播 | 直播 SOP、时段节奏、复盘 |
| 10 | 数据反馈 | 日看板、周复盘、A/B 结论 |
| 11 | 物流客服 | 履约方案、库存预警、客服 SOP |
| 12 | 合规风控 | 合规清单、类目资质 |
详细步骤、KPI、常见坑与首周启动计划见 references/workflow.md；
可直接复用的模板见 references/templates.md。按需加载，避免撑爆上下文。
工具路由：图片 → ecommerce-img-gen；视频/特效 → 3D模型与视频特效；
市场数据 → FastMoss / Kalodata / PipiAds / TikTok Creative Center；
合规与物流框架 → kuajing-master。
排错
| 现象 | 处理 |
|---|---|
alipay-bot: command not found |
执行 npx -y @alipay/agent-payment@latest install 后重试 |
| probe 返回非 402 | 原样展示状态码与响应体，不推进支付；检查服务地址是否登记一致 |
402 缺 Payment-Needed |
服务端未正确下发账单，终止流程并提示服务端排查 |
| pay 后 complete 无结果 | 用同一 --out-shake-no 重试；状态不明先查单，不重复付款 |
| 履约确认失败（502） | 结果已生成，用同一凭证重试即可，不会重复扣费 |
| 金额与页面展示不符 | 核对三处：支付宝登记价、服务端 402 账单、SkillHub 展示价，三者须一致 |
未付款一律不交付结果；状态不明时先查原订单；不因回执失败要求用户重新付款。
