Skill Pay 快速上架
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @xigou/f-publish
技能介绍
把付费服务接进 AI Agent 的真实底座
想把已有 API、知识库或报告生成服务包装成能被 AI Agent 直接调用、按次付费的 Pay Skill,不是简单加一行 pay_skill: true 就能上线。真机联调时,最常卡的不是业务逻辑,而是协议契约和支付链路:AI 拿到资源先收到 HTTP 402,需要带 payment_code 重试;微信支付要过 Native 下单、异步回调验签、订单查单、测试退款等环节;SKILL.md 的 frontmatter 与工作流要和后端签名严格对齐,否则会出现 未进行 X402 协议改造、file type not allowed、签名失败 等 8 类高频错误。这套资料就是围绕“把已有付费服务安全改造成 SkillHub Pay Skill”这条完整链路拆出来的实战笔记。
它具体怎么工作
- X402 协议骨架:
4 段架构、5 行签名串、L1/L2 两层结构,让 AI Agent 先付后取,避免把 sensitive 资源放到无鉴权 prompt 里。 - 微信支付商户接入:从
pay.weixin.qq.com拿商户号,接Native 下单、查单、退款、回调,并强制 HTTPS + systemd 部署,而不是放在单机脚本里跑。 - SkillHub 开发者密钥:生成并保存
SKILLHUB_DEVELOPER_ID、SKILLHUB_PUB_KEY_ID、私钥,用于平台侧验签和 AI 预下单。 - 后端服务模板:基于
mch-demo,Go/Java 双栈起步,真正需要改的往往只有amount金额和executeBusiness业务函数,SDK 集成、签名、AI 预下单直接复用 demo。 - SKILL.md 改造模板:frontmatter 加
pay_skill: true与x402_compliant: true,工作流收敛为 4 步:请求资源→处理 402→触发支付→重试获取内容;value_intro放描述首位,方便平台稳定抓取。 - 8 大报错速查:覆盖协议未改造、zip 内含
.service/.sh/.env被拒、5 行签名串换行错误、payment_code超时、微信回调 401 证书验证失败、MCH_APIV3_KEY导致退款失败、pub_key_id不匹配、测试退款 query 必须严格传trigger_refund等场景。
适用边界与注意点
适合已经具有 真实后端服务 的付费 API、API 代理、报告生成、知识付费场景;也适合想理解 X402 底层机制、做 WeixinPay 与 SkillHub 集成的商户。不太适合纯 LLM 工作流、命令合集类技能(如 git 命令集合)、配置类技能(如 Hermes profile)或免费知识分享,这些更应发布为普通 Skill。真机联调前,建议先按材料中 5 步路径推进:申请商户号与密钥 → 基于 mch-demo 改造后端 → HTTPS + systemd 部署并配置回调 → 上传 zip 并升级为 Pay Skill → 等待 1–3 工作日审核;测试时优先用 test_refund 验证链路,避免直接拿真实订单反复调试。
使用场景
- 已有付费 API 或报告生成服务,需要封装为 AI Agent 可调用、按次计费的 Pay Skill
- 微信支付商户接入时,要完成 Native 下单、异步回调验签、订单查询和测试退款联调
- SKILL.md 改造时,需要补全 pay_skill / x402_compliant 字段和 4 步请求-支付-重试工作流
- 遇到 file type not allowed 或签名失败时,需要排查 zip 内容、签名串换行和密钥配对
适合人员
- 已有付费 API 或服务的后端开发者,想把业务接入 AI Agent 并按次收费
- 做 Skill 商业化的工程师,需要打通微信支付与 SkillHub Pay Skill 的完整链路
- 微信支付商户侧的接入人员,要完成商户号、密钥、HTTPS 和回调地址配置
- 对 X402 协议感兴趣、希望理解 L1/L2 两层结构和签名机制的技术工程师