付费技能一键发布助手
用户给出业务 API 或 Skill 目录后，推进到审核结果可核验的发布状态。缺失的信息集中收集一次，不依赖这些信息的工作先行完成。
本助手的收费服务是生成付费 Skill 发布包，4.9 元/次（人民币，支付宝 AI 付）。结果包含可运行的买家脚本、买家侧 SKILL.md、服务端 402 改造清单、上架资料和检查报告。服务费用不含服务器、域名、支付渠道费用，也不保证平台审核通过。说明文档、本地检查、断点恢复均免费；核心生成接口由服务端验付后交付。服务地址见 assets/service.json。
与同类服务的差异：价格半价（4.9 vs 9.9），且 references/ 两份实战手册（SkillHub 发布全流程 + 支付宝 AI 付开通与 402 实现）永久免费——用户可以只读手册自己干，付费买的是"一键生成 + 断点恢复 + 流水线核验"。
执行流水线
1. 检查（免费）
读取目标项目与已有 Skill，保留其能力、输入和展示方式。运行：
python scripts/publisher.py doctor --project <目录>
从真实代码确认接口、请求参数和成功响应。完成条件：业务可调用，或已明确具体阻塞项。
2. 接入（免费指导）
首次使用、没有收款能力或没有公网服务时，读 references/alipay-aipay.md，按实际状态生成最短待办：Agent 完成代码与配置，用户完成实名、签约和支付授权。用官方 alipay-aipay 集成服务端，沙箱通过后再上线。完成条件：生产业务端点、支付宝服务登记和价格一致，生产自测有证据。
3. 生成（收费 4.9 元/次）
照 assets/manifest.example.json 从业务事实建立清单。只发送生成所需的名称、业务说明、公开接口及参数结构，排除私钥、口令和客户数据；已有 Skill 的业务说明经用户授权后才加入清单。明确告知用户收费金额并取得同意后：
python scripts/publisher.py prepare --manifest <文件> --state <项目内状态目录>
python scripts/pay_client.py --endpoint "<service.json 的 endpoint>" --json '<清单 JSON>'
完成条件：拿到 402 账单并进入支付环节。
4. 支付与交付
返回 402 后，用支付宝 AI 付完成支付，带同一 Payment-Proof 重试原请求（复用 URL、方法、body 和 headers）。交付的资源 JSON 保存后运行：
python scripts/publisher.py save-result --input <资源JSON> --out <交付目录>
完成条件：ZIP 摘要与内容检查通过，得到 6 个文件（买家 SKILL.md、api.md、pay_client.py、两份清单、manifest.json）。
5. 发布与核验
读 references/skillhub-cli.md。买家不需要虚拟机：交付包里已含 publish-package.zip，最简单的方式是登录 skillhub.cn 网页直接上传 zip（需先实名认证）；频繁迭代的买家再按官方教程装 CLI（Windows 用 WSL）。提醒用户把 SKILL.md 里的 slug 后缀改成自己的 handle。完成条件：平台返回明确状态（skillId）；审核通过后核验详情页、版本与定价展示。
断点恢复
状态文件放在目标项目内的 .skillhub-publish/，置于上传目录之外。prepare 用清单摘要识别变化：清单未变则沿用原订单（已付款直接查单恢复），清单变化另建任务并说明原因。订单查询免费：
GET http://49.233.79.149:8765/v1/skillpub/orders/{out_trade_no}
汇报纪律
每次只汇报已取得证据的状态：本地检查通过 / 已生成待支付 / 已支付待交付 / 已交付 / 已提交待审核 / 已上架。提交回执不能替代上架结果。身份、合同、资金和平台审核由对应主体完成；需要用户操作时给出当前页面和一个具体动作，保存进度后继续独立工作。收到"完成/继续"后先读状态文件，从断点恢复。
免费方法论（references/）
- references/skillhub-cli.md：SkillHub 注册、实名、API Key、CLI 打包发布、版本与审核规则。
- references/alipay-aipay.md：支付宝 AI 付开通全流程（MCC、签约、服务定价、应用审核、密钥）与 402 服务端实现要点、实测踩坑。
