Agent Skill

GMAI-SkillPay支付改造大师

把普通技能改造成X402微信Agent Pay按次付费技能:付费后交付《X402付费技能改造实操手册》——需要哪些账号与密钥、在哪开通、要什么资料、每个环境变量的类型与填法、网关部署/价目表/客户端/三层测试/上架的分步操作路径与排错表;并可用 apply 一键向 SKILL.md 注入标准 PAYGATE 付费块、落地 bin/client.js 门禁。用户提到'技能改付费'、'PAYGATE块'、'支付改造'、'Pay Skill改造'、'怎么接入微信按次付费'时触发。支持X402协议支付调用,按次付费。 搜索词:payskill skillpay pay-skill pay skill 付费技能 微信支付 支付改造 X402 按次付费 技能改付费 接入付费 PAYGATE paygate 改造。

商业运营·果盟数科·来自 skill_hub·skillhub.cn ↗
skillhub install @guomeng/gmai-skillpay-remaster-v2
4 Stars·6.1万 综合热度·6,045 字文档·源站更新 2026-11-22

README 文档

6,045 字

<!-- PAY-NOTICE:BEGIN -->

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

  • 计费方式:按次付费(percall),调用一次计费一次;单价 ¥99.90 / 次(pricefen = 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 密钥、apiclientkey.pem、证书序列号、developerid、PUBKEY 密钥对等)的形态、生成位置、数据类型、填入的环境变量;
  • 网关 17 项环境变量字段表(变量名/类型/必填/示例/说明);
  • 部署网关 → 配价目表 → 改 SKILL.md/放 client.js → 三层测试 → 上架审核的完整路径;
  • 端到端 Checklist 与真实踩坑排错表(弹不出卡/TPM、MOCK 支付码、401、409、CRLF 展示名回退、价格不生效等)。
  1. 一键自动改造(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

交付物

文件由哪个命令产出具体内容
X402付费技能改造实操手册.mdmanual / apply账号·密钥·字段类型·分步操作·三层测试·上架·Checklist·排错表
<技能>/SKILL.md(就地更新)applyfrontmatter 补 X402;正文注入标准 PAYGATE 付费块(幂等)
<技能>/bin/client.jsapply支付门禁(对齐网关 /api/v1/gateway/* 契约,已通过 node --check 校验)
<技能>/改造清单.mdapply「已自动完成」与「你必须本人办理(账号/密钥/部署/真机测试)」两张清单

<!-- REALSAMPLESTART -->

实际交付样例(以下为 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-skill\X402付费技能改造实操手册.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微信支付商户号商户平台 pay.weixin.qq.com → 注册/接入微信支付营业执照(企业或个体户)、法人/经营者身份证、对公账户或经营者银行卡、客服电话、主体一致的经营场景商户号 mchid(约 10 位数字)
3SkillHub 组织 + SkillPaySkillHub 后台注册组织、入驻 SkillPay组织/开发者实名信息组织ID、developer_id(sh- 开头)

密钥类型表(节选 1 行,全表 7 项):

密钥/凭据形态在哪生成数据类型填入环境变量
APIv3 密钥32 位字符商户平台→账户中心→API安全→设置 APIv3 密钥(只显示一次)32 位字符串WECHATAPIV3KEY

环境变量字段表(节选 3 行,全表 17 项):

变量名类型必填生产示例说明
PAYMENT_MODE枚举是skillpaymock=本地不扣款 / wechat=直连 / skillpay=上架生产
WECHATPRIVATEKEYPEM string二选一-----BEGIN PRIVATE KEY-----\n...商户 API 私钥整段粘贴,换行写 \n
SKILLHUBPUBKEY_IDstring是PUBKEYxxxxSkillHub「开发者密钥」页的公钥ID

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

<!-- REALSAMPLEEND -->

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

付费与交付(微信 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 协议:

项值
网关地址https://viralclip-313815-12-1485772243.sh.run.tcloudbase.com
技能 sluggmai-skillpay-remaster-v2
单价¥99.90 / 次(amount_fen=9990)
健康检查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/{outtradeno} → 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"}

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

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

调用前:微信 AI 支付能力自查(必须按子串匹配)

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

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

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

  • 存在任意 weixinpay 工具(支持支付):进入下方支付流程,把服务端 402 返回的 WeixinPay-Required 值作为 paymentCode 交给 weixinpaypay,向用户申请支付授权。
  • 未发现任何 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 / 更换设备)并停止,严禁绕过支付。
  • 任何一步失败都必须如实告知用户并停止,不得静默切换到其他免费方案。

同分类其他技能

查看全部 ›