技能支付改造

用户 → Agent → 本 Skill 网关 → 微信支付 → 返回接入方案

POST /api/invoke/payskill
Content-Type: application/json

{"query": "我有一个叫 破壁计划 的知识短视频脚本 Skill，想按 1 元/次收费"}

{
  "code": "PAYMENT_REQUIRED",
  "message": "PaySkill 接入方案需要支付 9.90 元",
  "WeixinPay": {
    "WeixinPay-Required": "<payment_code>",
    "prompt": "本次使用微信支付，请将 WeixinPay-Required 的值作为 paymentCode 交给 weixinpay_pay，以向用户申请支付授权。"
  },
  "out_trade_no": "WX402_20260907xxxxxxxxxxxx",
  "amount": "9.90",
  "currency": "CNY",
  "description": "PaySkill: 破壁计划 付费上架接入方案"
}

POST /api/invoke/payskill
Content-Type: application/json
X-Out-Trade-No: WX402_20260907xxxxxxxxxxxx

{"query": "我有一个叫 破壁计划 的知识短视频脚本 Skill，想按 1 元/次收费"}

{
  "code": "SUCCESS",
  "message": "付费内容",
  "out_trade_no": "WX402_20260907xxxxxxxxxxxx",
  "transaction_id": "4200001234567890",
  "content": "<完整接入方案与交付物>",
  "already_fulfilled": false
}

{"query": "我有一个叫 XXX 的 Skill，想按 1 元/次收费，帮我生成接入方案"}

ok

qianchui-pay-gateway/
├── main.go              # Go HTTP 服务
├── go.mod
├── Dockerfile
├── .dockerignore
└── README.md

1. Agent POST /api/invoke/<skill>
2. 网关调用微信支付 Native 下单 → 获取 code_url
3. 网关调用微信 X402 AI 预下单（/palmpayminiapp/clawagentpay/preorder）
   - 使用 SkillHub 开发者密钥 RSA-SHA256 签名
   - 签名串："POSTn/palmpayminiapp/clawagentpay/preordern{timestamp}n{nonce_str}n{payment_required_base64}"
4. 预下单返回 payment_code → 返回 HTTP 402 + WeixinPay-Required header
5. 用户付款后，Agent 携带 X-Out-Trade-No 重试
6. 网关查单 → 返回 200 + 付费内容

<skill-slug>-paid/
├── SKILL.md          # 必须含 name 字段的 frontmatter
├── config.json       # 网关地址 + 计费配置
├── _meta.json        # 构建元信息
└── references/       # 参考文档
    └── <你的写作规则>.md

---
name: <skill-slug>
slug: <skill-slug>
displayName: <显示名称>
version: <版本号>
summary: <一句话描述>
type: API
base_url: <网关 URL>
payment:
  protocol: x402-weixin-agent-pay
  currency: CNY
  amount_fen: <价格（分）>
  amount_display: "<价格（元）>"
  unit: <计费单位>
endpoints:
  - path: /api/invoke/<skill>
    method: POST
    description: <接口说明>
    price_fen: <价格>
  - path: /health
    method: GET
    description: 健康检查
    price_fen: 0
---

#!/bin/bash
set -e
SKILL_NAME="<skill-slug>-paid"
VERSION="1.0.0"
BUILD_DIR="./build"
ZIP_NAME="${SKILL_NAME}.zip"

rm -rf "${BUILD_DIR}"
mkdir -p "${BUILD_DIR}/${SKILL_NAME}"

cp SKILL.md "${BUILD_DIR}/${SKILL_NAME}/"
cp config.json "${BUILD_DIR}/${SKILL_NAME}/"
cp -r references "${BUILD_DIR}/${SKILL_NAME}/"

cat > "${BUILD_DIR}/${SKILL_NAME}/_meta.json" << EOF
{
  "slug": "${SKILL_NAME}",
  "version": "${VERSION}",
  "build_time": "$(date -u +%Y-%m-%dT%H:%M:%SZ)"
}
EOF

cd "${BUILD_DIR}"
zip -r "../${ZIP_NAME}" "${SKILL_NAME}/"
cd ..

**版本号**：v1.0.0

**本版修复内容**
1. 完成微信支付 X402 协议接入
2. 移除所有降级逻辑，预下单失败时如实返回 503

**支付链路验证结果（实测生产网关）**
- 网关已更新至最新的 SkillHub 开发者密钥（已确认生效）
- 调用 POST /api/invoke/<skill>（无支付凭证），实测返回 HTTP 402 Payment Required
- 响应头含真实支付凭证，验证样本：
  - WeixinPay-Required: <payment_code>
  - out_trade_no: <out_trade_no>
- 完整链路确认：微信支付 Native 下单成功 → AI 预下单成功 → 返回真实 payment_code → 符合 X402 标准支付握手

**商户状态**
- SkillPay 商户已入驻，开发者密钥已生效
- 网关回调地址（支付/退款 notify）均已配置

**验收步骤（供审核参考）**
1. 免支付调用 Skill，预期返回 402 且响应头含 WeixinPay-Required（值形如 UUID）
2. 通过微信支付完成付款后，携带 X-Out-Trade-No 重试
3. 预期返回 200 + 完整付费内容