锤炼读书笔记

概述

千锤阅读笔记（付费版）

通过微信 Agent Pay (X402) 协议提供付费阅读笔记服务。用户按次付费获取结构化阅读笔记内容。

使用场景

当用户需要：

• 获取某本书/文章的深度阅读笔记
• 按次付费获取知识内容（非订阅制）
• 在 Agent 对话中直接完成支付并获取内容

时使用此 Skill。

支付协议

本 Skill 使用 微信 Agent Pay (X402) 协议，完整支付流程如下：

整体流程

用户 → Agent → 本 Skill 网关 → 微信支付 → 返回内容

1. Agent 调用 POST /api/invoke（body 含 query 字段，不带 X-Out-Trade-No header）
2. 网关返回 HTTP 402 Payment Required，响应头包含：
   • WeixinPay-Required: 真实的 payment_code（UUID 格式，来自微信 X402 预下单接口）
   • X-Out-Trade-No: 商户订单号
3. Agent 将支付信息展示给用户，用户在对话中确认支付
4. 用户通过微信支付 AI 专属卡完成付款
5. Agent 携带 X-Out-Trade-No header（值为步骤 2 返回的订单号）重新调用 POST /api/invoke
6. 网关验证支付状态，返回 HTTP 200 + 阅读笔记内容

402 响应格式

请求：

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

{"query": "解读《思考，快与慢》"}

响应（HTTP 402）：

{
  "code": "PAYMENT_REQUIRED",
  "message": "解读《思考，快与慢》需要支付 1.00 元",
  "WeixinPay": {
    "WeixinPay-Required": "4bb77714-4443-4615-8dc2-ed51da87b87a",
    "prompt": "本次使用微信支付，请将 WeixinPay-Required 的值作为 paymentCode 交给 weixinpay_pay，以向用户申请支付授权。"
  },
  "out_trade_no": "WX402_202608310742136e7c02a65c0c",
  "amount": "1.00",
  "currency": "CNY",
  "description": "千锤百炼解读笔记: 解读《思考，快与慢》"
}

响应头：

• WeixinPay-Required: payment_code 值（同 body 中的 WeixinPay.WeixinPay-Required）
• X-Out-Trade-No: 商户订单号

200 响应格式（支付验证通过）

请求：

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

{"query": "解读《思考，快与慢》"}

响应（HTTP 200）：

{
  "code": "SUCCESS",
  "message": "付费内容",
  "out_trade_no": "WX402_202608310742136e7c02a65c0c",
  "transaction_id": "4200001234567890",
  "content": {
    "authorization": "QC-AUTH-20260831...",
    "authorized_query": "解读《思考，快与慢》",
    "authorized_action": "generate_reading_note",
    "assets": {
      "style_guide": "...",
      "note_template": "..."
    },
    "instruction": "支付验证通过。请以 assets.style_guide 与 assets.note_template 为创作依据，按 SKILL.md 中 R1–R18 规则生成完整解读笔记。"
  },
  "already_fulfilled": false
}

接口说明

POST /api/invoke

获取付费阅读笔记内容。

请求头：

• Content-Type: application/json（必填）
• X-Out-Trade-No（可选）：已支付订单号。携带此 header 时网关验证支付状态并返回内容；不携带时返回 402 挑战。

请求体：

{"query": "解读《思考，快与慢》"}

响应：

• 402 Payment Required：需要付款，响应头含 WeixinPay-Required（真实 payment_code）
• 200 OK：支付已验证，返回笔记内容

GET /health

健康检查（免费）。

响应：

ok

计费说明

• 单次调用价格：¥1.00（100 分）
• 计费模式：按次计费
• 支付方式：微信支付 AI 专属卡

技术架构

• 网关：Go HTTP 服务，部署于微信云托管
• 支付协议：微信 Agent Pay X402（/palmpayminiapp/clawagentpay/preorder）
• 签名方式：RSA-SHA256（SkillHub 开发者密钥签名）
• 支付验证：通过微信查单接口验证订单状态

注意事项

1. 网关通过环境变量注入所有敏感凭证（微信支付商户密钥、SkillHub 开发者密钥等）
2. 支付验证通过微信官方查单接口完成
3. 预下单失败时如实返回 503 错误，不做降级处理
4. 已履约订单支持幂等返回（重复调用直接返回缓存内容，不重复扣款）
5. 履约失败时自动发起全额退款