发布 Pay Skill 流程（Pay Skill Publisher）
这是什么
本 Skill 同时是指南和Pay Skill 本身：
- 指南：讲清如何把任意普通 Skill 改造成支付宝「AI 按量付费」Pay Skill 并发布到 SkillHub。
- 付费交付物：用户支付成功后，云端把内置的「通用 Pay Skill 模板工程」（
server/template/
整套可运行脚手架）打包返回。用户只需替换业务函数、改说明、打包部署，即可上线自己的付费 Skill。
核心价值：把"从零搭付费后端 + 对齐支付宝合约 + 过审"这件重复且易错的事，变成一次按次付费的调用。
后端服务（付费资源地址）
本 Skill 的模板生成引擎部署在商户自建后端（不随下载包分发），付费资源地址：
<部署后公网地址>/generate
调用方式：POST 该地址，Header 携带 Payment-Proof（支付凭证）。
当 Agent 调用本 Skill 时（支付宝 402 按量付费流程）
- 理解用户需求（想做成什么样的付费 Skill、交付什么）。
POST上述服务地址；未带支付凭证时返回 402 +Payment-Needed（金额 ¥0.99）。- 支付宝「AI 付」在对话内展示账单，用户确认支付。
- Agent 携带
Payment-Proof重试；后端验签通过后，把server/template/整套模板工程打包返回 ZIP。
发布 Pay Skill 的完整流程（指南核心）
阶段一：改造普通 Skill 为 Pay Skill
- 架构选型：自托管端点（微信云托管 / SCF / FC）vs 平台沙箱。推荐自托管——
生成引擎只在商户后端，下载包不含源码，无Payment-Proof拿不到产物（防白嫖）。 - 四要素实现（后端必须对齐支付宝官方《付费改造最佳实践指南》）：
① 402 + Payment-Needed 账单（RSA2 商家签名）② Payment-Proof 验签
③ 履约确认fulfillment.confirm（异步 + 重试 + 补偿）④ 订单持久化 + 幂等。
详见references/pay-protocol.md。 - 瘦客户端
scripts/pay_skill.py：只连商户后端，不含生成逻辑。 - 打包安全：
server/绝不进上传包；用_localtools/pack_skillhub_upload.py（白名单 + 敏感串自检）
和pack_cloudhosting_zip.py（拒绝 .env/pem/key）打包。
阶段二：部署后端（自托管端点）
- 微信云托管（或 SCF/FC）新建服务 → 上传云托管包 → 监听端口 8080。
- 配置环境变量（8 项支付宝凭证 +
SKILL_PRICE_YUAN+ADMIN_TOKEN）；
私钥等务必填真实值，中文占位符会导致/generate502。 - aipay 入驻（
aipay.alipay.com）：产品开通 → 服务注册（拿service_id）→ 密钥配置
（应用公钥登记、支付宝公钥回填 env）。 curl -X POST <端点>收到 402 + Payment-Needed 即部署成功。
阶段三：SkillHub 提审（4 步）
见 references/skillhub-submit.md（逐字段清单）。
资源
scripts/pay_skill.py— 瘦客户端（下载模板工程 ZIP）。server/template/— 付费交付的模板工程（四要素后端 + 业务钩子 + 瘦客户端 + 打包脚本 + 文档），不在上传包内。references/pay-protocol.md— 四要素与官方 A2M 合约。references/skillhub-submit.md— SkillHub 提审 4 步逐字段。references/common-pitfalls.md— 发布流程常见坑与自检清单。_localtools/pack_skillhub_upload.py/pack_cloudhosting_zip.py— 打包 + 安全自检。
注意事项
- 防盗版：模板生成引擎只在商户后端，源码不随包分发；卸载/复制本包都不含引擎。
- 定价 ¥0.99/次（模板价值高）；若改价，务必三处同步：云托管 env
SKILL_PRICE_YUAN、
aipay 服务注册单价、SkillHub 计费页单价。 - 价格 / 通道 / 计费模式以 SkillHub 发布表单填的为准。
