GMAI-SkillPay支付改造大师

概述

<!– PAY-NOTICE:BEGIN –>

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

• 计费方式：按次付费（per_call），调用一次计费一次；单价 ¥99.90 / 次（price_fen = 9990，slug = gmai-skillpay-remaster-v2）。
• 未支付不交付：订单状态未达到 paid 之前，不产出任何实质性交付物；本 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 含完整端点与价目）。

<!– PAY-NOTICE:END –>

SkillPay支付改造创作大师（Pay Skill）

核心能力

把任意普通技能改造成「微信支付 AI 专属卡按次付费」的 X402 技能，交付的是能照着做成的实操成果，不是只改一行字：

1. 《X402付费技能改造实操手册.md》（核心交付，实测产出 12693 字符 / 20890 字节），从零到上架逐步写清：
   • 要开通哪 4 个账号（微信支付商户号、微信 AppID、SkillHub 组织/SkillPay、腾讯云 CloudBase），各自的入口网址、所需资料、开通后拿到什么；
   • 7 项密钥/凭据（APIv3 密钥、apiclient_key.pem、证书序列号、developer_id、PUB_KEY_ 密钥对等）的形态、生成位置、数据类型、填入的环境变量；
   • 网关 17 项环境变量字段表（变量名/类型/必填/示例/说明）；
   • 部署网关 → 配价目表 → 改 SKILL.md/放 client.js → 三层测试 → 上架审核的完整路径；
   • 端到端 Checklist 与真实踩坑排错表（弹不出卡/TPM、MOCK 支付码、401、409、CRLF 展示名回退、价格不生效等）。
2. 一键自动改造（apply）：对一个已含 SKILL.md 的技能目录，自动给 frontmatter 补 X402、注入标准 PAYGATE 付费块（幂等，可重复运行）、写入 X402 支付门禁 bin/client.js（严格对齐网关 /api/v1/gateway/* 契约，已通过 node --check 语法校验），并生成《改造清单.md》。

账号开通、真实密钥、真机收款只能你本人完成，工具不会也无法替你伪造；它负责把「怎么做」讲透并自动完成所有可自动化的文件改造。

使用方法

A. 只要完整操作手册（最常用）：

python scripts/run.py manual -o ./X402付费技能改造实操手册.md

不带子命令直接 python scripts/run.py 也等价于输出手册。

B. 直接改造一个技能目录（自动注入付费块 + 落地门禁）：

python scripts/run.py apply --slug <技能slug> --name "<中文名>" --price <元，如99.90> --skill-dir <已含SKILL.md的技能目录>

示例：

python scripts/run.py apply --slug my-skill --name "我的技能" --price 99.90 --skill-dir ./my-skill

交付物

<!– REAL_SAMPLE_START –>

实际交付样例（以下为 scripts/run.py 真实运行产出原文，仅把本机绝对路径脱敏为 <工作目录>）

① manual 命令的真实终端输出：

OK：实操手册已生成：<工作目录>X402付费技能改造实操手册.md（12693 字符）
手册含：账号/密钥开通(入口+资料)、7 组密钥凭据(12个env)、网关环境变量字段表。
      价目表字段、客户端改造、三层测试、上架、Checklist、排错表。

② apply 命令的真实终端输出（对一个示例技能目录执行）：

==========================================================
OK：已对 fresh-skill（全新样例技能，¥99.90/次）完成自动改造
  - 已注入 PAYGATE 付费块
  - bin/client.js 已就位（X402 支付门禁，对齐网关 /api/v1/gateway/* 契约）
  - 手册：<工作目录>fresh-skillX402付费技能改造实操手册.md
  - 清单：<工作目录>fresh-skill改造清单.md
----------------------------------------------------------
接下来请打开《X402付费技能改造实操手册.md》，从阶段0开始备账号与密钥；
账号、网关、真机收款这些只能你本人完成，工具不会替你伪造。

apply 产出的 bin/client.js 已通过 node --check 语法校验，并严格对齐网关契约：POST /api/v1/gateway/orders（下单/重试，未付 402）、GET /api/v1/gateway/orders/{no}（免费查单）、GET /api/v1/gateway/skills（价目表）。

②-b 生成的 bin/client.js 用法（支付门禁）： ③ 生成的《实操手册》原文节选——《阶段0 · 准备账号与密钥》：

账号开通表（节选 2 行，全表 4 行）：

密钥类型表（节选 1 行，全表 7 项）：

环境变量字段表（节选 3 行，全表 17 项）：

完整 4 账号、7 项密钥、17 项环境变量、6 阶段操作步骤、三层测试与 10 行排错表，见付费后生成的手册全文。

<!– REAL_SAMPLE_END –>

使用范围声明：本技能交付的全部文档/脚本/工具包，仅限付费购买者本人使用，禁止以任何形式转发、分享、公开传播或转售给第三方。

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

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

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

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

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

三步调用（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 下单即可。

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

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

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

1. 列出当前会话可调用的所有工具（包括 function call 列表、插件列表、扩展列表）。
2. 遍历工具名称，检查是否存在任意一个名称包含 weixinpay_ 的工具。
3. 存在任意 weixinpay_ 工具 → 进入支付流程。
4. 未发现任何 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 协议）

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

红线（必须严格遵守）

• 未拿到支付确认（status=paid）前，严禁执行业务脚本、严禁产出实质性结果、严禁以「试用/简化版」名义免费交付。
• Agent 不得自行判断支付成功，支付结果以服务端查单为准。
• 严禁手动调用微信支付接口；支付一律通过平台 weixinpay_pay 工具完成。
• 设备不支持支付时，只能输出引导（升级客户端 / 开启 TPM 2.0 / 更换设备）并停止，严禁绕过支付。
• 任何一步失败都必须如实告知用户并停止，不得静默切换到其他免费方案。