付费声明（Pay Skill · 按次计费 · 本 Skill 不是免费技能）

计费方式：按次付费（per_call），调用一次计费一次；单价 ¥14.90 / 次（price_fen = 1490，slug = gmai-live-review-131d）。

未支付不交付：交付物由包内引擎生成；引擎在校验支付凭证未通过时以退出码终止、不产出报告文件。本 Skill 不设免费额度、不提供免费试用（由代码强制执行）。

支付前仅可免费进行的：需求沟通与订单状态查询（status 免费查单，不产生费用）。

支付链路（X402）：本包内置 scripts/pay_gateway.py —— health（探活）→ probe（预下单，返回 HTTP 402 账单）→ 用户在对话内完成微信支付授权 → complete（带同一订单号 X-Out-Trade-No 重试，网关查单为 paid 后才放行交付）。

支付网关：https://viralclip-313815-12-1485772243.sh.run.tcloudbase.com（payment_service.json 含完整端点与价目）。

数据流与隐私说明

业务命令内置 X402 支付闸门：未支付时返回退出码 42 并打印 402 账单与下一步指引，不产出任何交付内容；
闸门提交的计费参数仅为固定服务标识（技能 slug 与子命令名），不包含你的业务原文；
订单号与支付状态由支付网关存储，用于查单、对账与防重复扣费；除订单处理外不作他用。

支付闸门（fail-closed，由包内引擎代码强制执行）

本技能的交付物由包内引擎生成，引擎在每次运行时校验支付凭证（--payment-proof X402-<订单号>）：

未检测到有效凭证或凭证格式无效时，引擎以退出码终止，不产出报告文件；
凭证有效性最终以支付网关查单为准（status=paid 才视为已支付）；
网关确认 paid 之前，交付文件不会生成——该行为由代码实现，不依赖对话判断；
支付工具不可用、后端超时、网络失败时，流程终止并提示，稍后重试即可（同一订单号重试不会重复扣费）。

交互流程按下方「付费调用流程」四步执行：第一步下单取凭证 → 第三步用户完成支付 → 第四步带同一订单号重试，网关确认后引擎正常产出交付文件。

前置检查：当前智能体是否支持微信 AI 支付

发起下单前，先检查你的可用工具列表中是否存在名称包含 weixinpay_ 的工具（存在任意一个即视为支持）。只以你的工具列表为证据，本文档提到的工具名不算；无法确认时按「不支持」处理。

支持：继续执行本技能的后续流程。
不支持：终止流程且不发起下单，向用户说明结论与解决办法：
- 合作智能体（如 WorkBuddy）：请升级智能体到最新版本后重试。
- 开放智能体（如 OpenClaw / DeepSeek Harness）：请访问 https://skillhub.cn/install/skillhub.md，安装 @tencent-adm/weixinpay-installer。
- 无法判断类型：请升级智能体或安装微信支付 AI 支付插件后重试。

前置检查不通过时同样终止流程并说明原因（引擎不产出文件）。

付费调用流程（四步，获得交付物的仅有途径）

本技能为付费 Pay Skill，单价 ¥14.90/次，付费后端 endpoint： https://viralclip-313815-12-1485772243.sh.run.tcloudbase.com/api/v1/gateway/orders（调用头 X-API-Key 由本包 payment_service.json 提供）本包内置可运行客户端 scripts/pay_gateway.py（纯标准库，免安装），四步与之一一对应。

第一步：请求资源（首次请求只带最小字段）

curl -sS -X POST https://viralclip-313815-12-1485772243.sh.run.tcloudbase.com/api/v1/gateway/orders \
  -H "Content-Type: application/json" \
  -H "X-API-Key: <payment_service.json 中的 api_key>" \
  -d '{"skill_slug":"gmai-live-review-131d"}'

首次请求只传最小字段（技能标识与必要的业务参数），不携带用户的隐私原文（最小化数据传输，保护用户隐私）。也可直接跑包内客户端：python scripts/pay_gateway.py probe

第二步：处理 402 响应（订单号与凭证传递）

返回 HTTP 402 说明需要付费，从响应中提取以下字段供后续步骤使用：

| 来源 | 字段 | 用途 | |---|---|---| | 响应 Header | WeixinPay-Required | 支付凭证 → 第三步交给微信支付 | | 响应 Header | X-Out-Trade-No | 订单号 → 第四步回传 | | 响应 Body | 账单文案（含金额） | 向用户说明本次需支付 ¥14.90 |

⚠️ 保留第一步的原始 body 原文，第四步需逐字重发（同一订单号重试不会重复扣费）。

第三步：发起支付（支付触发）

将 WeixinPay-Required 的值作为 paymentCode，向用户申请支付授权：

若你的工具列表中存在名为 weixinpay_pay 的支付工具：调用 weixinpay_pay({ "paymentCode": "<WeixinPay-Required 的值>" })。
若不存在该工具（WorkBuddy 等合作智能体由系统接管）：系统会自动检测 WeixinPay-Required 并弹出支付卡片，无需也不应手动调用任何支付工具，等待用户在卡片上确认即可。
WeixinPay-Required 为一次性支付凭证，仅供支付工具使用，无需向用户展示，也不写入持久化日志。
用户取消支付后要求重新支付：先与用户确认是哪一笔订单，再用上次相同的凭据调用 mcp__weixinpay__weixinpay_retry_pay（传 paymentCode）。

第四步：支付成功后重试获取交付物（⚠️ 必须执行，最易被遗漏）

支付成功必须携带订单号重新请求一次，这是拿到交付物的唯一途径。body 与第一步逐字一致：

curl -sS -X POST https://viralclip-313815-12-1485772243.sh.run.tcloudbase.com/api/v1/gateway/orders \
  -H "Content-Type: application/json" \
  -H "X-API-Key: <payment_service.json 中的 api_key>" \
  -H "X-Out-Trade-No: <第二步保存的订单号>" \
  -d '{"skill_slug":"gmai-live-review-131d"}'

不携带订单号重试 = 永远拿不到交付物。 支付成功不等于已拿到内容，必须执行本步。
返回 HTTP 200 即代表付款已验真，此时才可进入本技能的正式交付流程。
幂等：同一 X-Out-Trade-No 重复请求不会重复扣费。
包内客户端等价命令：python scripts/pay_gateway.py complete --out-trade-no <订单号>

免费查单与异常处理

python scripts/pay_gateway.py status --out-trade-no <订单号>   # 查单免费，不产生费用

| 情况 | 动作 | |---|---| | 网络错误 / 超时 / 非 402 且非 200 | 告知"服务暂时不可用，请稍后重试"，终止 | | 402 支付未完成 | 支付尚未完成，等用户完成支付后再执行第四步 | | 订单凭证过期（约 1 小时） | 从第一步重新发起下单 | | 500 服务端错误 | 用同一凭据重试，不会重复扣费 | | 网关健康检查 | python scripts/pay_gateway.py health（GET /healthz，免密钥） |

任何异常都按 fail-closed 处理：如实告知用户并终止流程，引擎在未确认支付前不产出交付文件。

果盟精选 1229（直播复盘报告生成器）（Pay Skill）

核心能力

直播不是播完就完。本技能输入本场四项核心指标（GPM、停留时长、互动率、转粉率），对照诊断规则生成复盘报告与改进清单，让你知道“差在哪、下周改什么”。

| 指标 | 是什么 | 诊断判据 | |---|---|---| | GPM | 千次观看成交金额 | ≥1000 优 / 600~1000 良 / <600 弱 | | 停留时长 | 人均观看分钟 | ≥90s 优 / 45~90s 良 / <45s 弱 | | 互动率 | 评论/点赞÷场观 | ≥8% 优 / 3~8% 良 / <3% 弱 | | 转粉率 | 新增粉丝÷场观 | ≥4% 优 / 2~4% 良 / <2% 弱 |

使用方法

# 单件：复盘报告 + 改进清单
python scripts/run.py manual --gpm 820 --stay 55 --interaction 6.2 --fans 2.8 --revenue 16400 --orders 210

# 全套：复盘报告 + 指标基准表
python scripts/run.py all --gpm 820 --stay 55 --interaction 6.2 --fans 2.8

| 参数 | 默认 | 说明 | |---|---|---| | --gpm | 820 | 千次观看成交金额（元） | | --stay | 55 | 人均停留（秒） | | --interaction | 6.2 | 互动率（百分比，如 6.2 表示 6.2%） | | --fans | 2.8 | 转粉率（百分比） | | --revenue | 16400 | 本场成交额（元） | | --orders | 210 | 本场订单数 | | --outdir | 当前目录 | 输出目录 |

交付物

| 子命令 | 产出文件 | 内容 | |---|---|---| | manual | 直播复盘报告（本场）.md | 核心指标 → 诊断结论 → 改进清单 → 下周目标 | | all | 上述 + 指标基准表.md | 四指标分级基线 + 行业参考 |

实际交付样例（以下为 `scripts/run.py` 真实运行产出原文）

① 单件产出（实测产出 1514 字符，mock 支付闭环）：

$ python scripts/run.py manual
OK：直播复盘报告已生成：…\直播复盘报告（本场）.md（1514 字符）
口径：GPM=820 ｜ 停留=55s ｜ 互动=6.2% ｜ 转粉=2.8% ｜ 客单价=78.1 元

② 参数校验的真实行为（防呆生效）：

$ python scripts/run.py manual --interaction abc
错误：--interaction 'abc' 不是合法数字。
（示例：python scripts/run.py manual --gpm 820 --stay 55 --interaction 6.2 --fans 2.8）   [exit=1]

付费与交付（微信 AI 专属卡 · ¥14.90/次）

本技能为 SkillHub Pay Skill，按次计费，支付由 SkillHub + 微信支付 Agent Pay 体系处理：云托管服务端完成微信下单与 X402 预下单，本 Skill 包内直接提供可运行的支付服务接入客户端 scripts/pay_gateway.py（纯标准库，直连云端支付网关完成 probe → pay → complete 三段真实链路），调用方无需在本地配置任何支付密钥。

费用由用户直接支付给服务提供方，SkillHub 仅提供展示与平台服务，不作为收款方。

支付服务接入（本包内含可运行客户端）

本技能的支付服务由云端支付网关提供，包内 scripts/pay_gateway.py 即为官方调用客户端（纯标准库、无需安装依赖），字段级对齐微信支付 Agent Pay X402 协议：

| 项 | 值 | |---|---| | 网关地址 | https://viralclip-313815-12-1485772243.sh.run.tcloudbase.com | | 技能 slug | gmai-live-review-131d | | 单价 | ¥14.90 / 次（amount_fen=1490） | | 健康检查 | GET /healthz → 200 {"ok":true,"payment_mode":"skillpay"} | | ① 取账单 | POST /api/v1/gateway/orders（Header X-API-Key）→ 402 + 响应头 WeixinPay-Required（支付码）、X-Out-Trade-No（订单号） | | ② 用户授权 | WeixinPay-Required 作为 paymentCode 交给 weixinpay_pay，弹出微信支付卡片由用户确认 | | ③ 支付后重试 | 同一请求体 + Header X-Out-Trade-No → 网关查单确认到账 → 200 放行履约 | | 免费查单 | GET /api/v1/gateway/orders/{out_trade_no} → pending_payment / paid |

三步调用（Agent 直接照此执行）：

# 1) 取账单（未支付，返回 402，不扣费）
python scripts/pay_gateway.py probe --payload '{"需求参数":"..."}'
# 2) 把输出的 WeixinPay-Required 交给 weixinpay_pay 请用户授权（本脚本不接触支付密钥）
# 3) 用户支付后带订单号重试，网关查单通过即放行
python scripts/pay_gateway.py complete --out-trade-no <X-Out-Trade-No> --payload '{"需求参数":"..."}'

现场验证（可直接复制执行）：

curl -s https://viralclip-313815-12-1485772243.sh.run.tcloudbase.com/healthz
# {"ok":true,"payment_mode":"skillpay"}

订单幂等：同一 out_trade_no 重试不会重复扣费，履约只执行一次；未支付订单约 1 小时自动过期，过期后重新 probe 下单即可。

单价：¥14.90 / 次（以 SkillHub 后台配置为准）
计费单元：每次完整服务需求，支付确认后开始服务
免费操作：支付前的需求沟通、订单状态查询

前置检查：微信 AI 支付能力自查（必须按子串匹配）

请先自查本次会话实际可调用的工具列表，判断是否支持微信 AI 支付。具体操作：

列出当前会话可调用的所有工具（包括 function call 列表、插件列表、扩展列表）。
遍历工具名称，检查是否存在任意一个名称包含 weixinpay_ 的工具。
存在任意 weixinpay_ 工具 → 进入支付流程。
未发现任何 weixinpay_ 工具 → 按下方智能体类型分支处理。

注意：必须按子串匹配。不同智能体暴露的支付工具集合与命名前缀不同，存在任意一个名称包含 weixinpay_ 的工具即视为支持。若检查某个特定的完整工具名（如 weixinpay_pay），会在部分智能体上把"支持"误判为"不支持"。

存在任意 weixinpay_ 工具（支持支付）：进入下方支付流程，把服务端 402 返回的 WeixinPay-Required 值作为 paymentCode 交给 weixinpay_pay，向用户申请支付授权。
未发现任何 weixinpay_ 工具（不支持），按智能体类型分支处理：
- 合作智能体（WorkBuddy）：提示用户升级智能体到支持微信 AI 支付的版本（Windows ≥ 5.5.2 / Mac ≥ 5.1.1），升级后重启客户端重试。
- 开放智能体（OpenClaw / DeepSeek Harness）：提示将从 SkillHub 下载并安装「微信 AI 支付 Skill」，安装完成后重试。
- 无法判断智能体类型：兜底提示"请升级智能体或安装微信 AI 支付插件后重试"。
- 用户拒绝安装或升级时，如实告知并停止流程；支付未完成时引擎不产出交付物。

支付流程（X402 协议）

Agent 调用本 Skill，未支付时服务端返回 HTTP 402，响应头携带 WeixinPay-Required（支付码）与 X-Out-Trade-No（订单号）。
Agent 将 WeixinPay-Required 的值作为 paymentCode 交给 weixinpay_pay，客户端自动弹出支付卡片（微信 AI 专属卡），用户在手机微信确认扣款。
用户支付后，Agent 用与首次完全一致的请求原样重试，携带同一订单号（X-Out-Trade-No）；服务端查单确认到账后返回 200，方可执行业务并交付结果。
同一订单重试不会重复扣费；若返回 NOT_PAID / 仍为 402，说明支付尚未完成，等待后用同一订单号继续重试，不重新下单。

第一步返回的 HTTP 402 响应 body（JSON 样例，Agent 按此结构解析；字段以实际返回为准）：

{
  "code": "PAYMENT_REQUIRED",
  "message": "需要支付后才能使用果盟精选 1229（直播复盘报告生成器）服务",
  "WeixinPay": {
    "WeixinPay-Required": "<支付码，同响应头 WeixinPay-Required>",
    "prompt": "本次使用微信支付，请将 WeixinPay-Required 的值作为 paymentCode 交给 weixinpay_pay，以向用户申请支付授权"
  },
  "out_trade_no": "<订单号>",
  "amount": "15.90",
  "currency": "CNY"
}

注意：amount 为元字符串（如 "19.90"，不是分）；WeixinPay.WeixinPay-Required 与响应头同名，取其值交给 weixinpay_pay。

支付边界（由服务端与引擎代码强制）

未拿到支付确认（status=paid）前，引擎不执行业务脚本、不产出结果文件（fail-closed，代码强制）。
支付结果以服务端查单为准，status=paid 才视为已支付。
支付统一通过平台 weixinpay_pay 工具完成，无需手动调用微信支付接口。
设备不支持支付时，输出引导（升级客户端 / 开启 TPM 2.0 / 更换设备）并停止流程。
任一步骤失败都如实告知用户并停止；未支付状态下不产出交付物。

输出契约与质量标准

输出契约：业务命令在支付确认后产出交付文件（见「交付物」节），UTF-8 编码；文件结构=口径说明/分层定义/配置表格/执行节奏/复盘指标/免责校准声明，各章节均为实质内容、无占位骨架；权益面额与周期阈值随 --category/--aov/--sleep-days 参数化变化。

质量标准：

合格：支付闸门验证通过（真实支付或 mock 闭环），四件套文件落地、章节完整、无空骨架；
优秀：在合格基础上，话术可直接复制发送（替换点已标注），指标与基准可对照自店数据执行复盘；
不合格：闸门未通过仍产出文件、交付文件存在占位符/空章节、面额与参数不符——任一命中即不得交付。

发布前自检清单

[ ] zip 内全部 .py 编译通过，无语法错误；
[ ] frontmatter slug/displayName/version/amount_fen 与 payment_service.json 一致；
[ ] SKILL.md 与 payment_service.json 的网关端点完全一致；
[ ] 未支付调用业务命令被闸门拦截（退出码 42，无产物落地）；
[ ] 支付确认后（或 mock 闭环）调用业务命令产出交付文件；
[ ] 交付文件含口径说明与校准声明章节；
[ ] 禁串扫描零命中（无私测密钥/无旧品牌/无未声明端点）；
[ ] SKILL.md 样例字符数与真跑产物复算一致。

能力边界与适用范围

本技能（果盟精选 1229（直播复盘报告生成器））基于内置行业经验口径离线计算，不接入实时平台数据，不能替代平台后台与账户的真实数据；下列场景不适用本技能，本技能输出存在经验口径的天然局限，不得作为唯一决策依据：

本技能产出为复盘模板与诊断建议，基于通用直播运营方法论，未接入平台实时数据与行业数据库。
指标基线为通用参考值，不同品类差异较大，须结合本店类目与历史数据校准。
实际效果受货品、主播、流量结构共同影响，本技能不承诺具体提升幅度。
涉及功效、医疗、保健等表述须有合规依据，禁止虚假宣传与极限词。
本技能不替代平台合规审核与专业数据分析，重大经营决策请结合多方数据。

常见问题（FAQ）

问：怎么开始使用？ 答：支付后在技能目录运行 python scripts/run.py manual --outdir 输出目录。未支付会被闸门拦截并返回 402 账单；支付后带同一订单号（X-Out-Trade-No）原样重试即可交付。

问：怎么计费、价格多少？ 答：本技能单价 ¥14.90/次（amount_fen=1490 分），按次计费；支付前仅需求沟通与订单状态查询免费，未支付不产出任何交付物。

问：交付物是什么、能直接用吗？ 答：按 GPM/停留时长/互动率/转粉率四项指标生成直播复盘报告与改进清单，附诊断规则与达标基线。产物为 Markdown 成品文件（含口径说明、参数化表格与执行清单），可直接使用，标注替换位的数据请换成你店铺的真实数据。

问：结果能保证吗？ 答：引擎按内置经验口径离线计算，未接入实时数据，结果为决策参考、不构成收益承诺；请结合自身真实数据校准后再执行。