头条爆款文章全流程写手（Pay Skill 付费版）
一、付费模式（支付宝 AI 按量付费 · A2M 协议）
本包为 Pay Skill：按次收费（支付宝渠道）。支付、验付、收银一律复用支付宝官方能力（alipay-bot CLI + 官方 alipay-payment-skill），本包不实现支付逻辑、不接触任何密钥、不代收款项。
- 服务端点：
POST {SERVICE_URL}/invoke（{SERVICE_URL}由 SkillHub 后台「服务地址」字段注入） - 付费闸口：服务端未收到有效
Payment-Proof时一律返回HTTP 402 + Payment-Needed（RSA2 签名的 Base64URL 账单），此时不返回任何正文内容 - 单次调用价格：由发布者在 SkillHub 发布表单填写（0.01–50 元/次，仅作展示）；实际扣费以服务返回的
402 + Payment-Needed账单金额为准，两者必须一致，否则用户无法完成支付 - 幂等：同一
Payment-Proof在有效期内只生效一次；重复请求返回已缓存的交付结果 - 包内实现：
scripts/toutiao-paid.mjs—— A2M 编排脚本（probe → pay → complete），与下方文本流程完全等价；运行环境无 Node 时按文本流程执行
二、付费前置检查（必做，第一步）
发起下单前，检查当前 Agent 的可用工具列表中是否存在支付类工具（alipay_* / weixinpay_*，带前缀的也算；只以工具列表为证据，文档中提到的工具名不算；无法确认时按"不支持"处理）：
- 支持：继续执行后续流程。
- 不支持：终止且不下单，仅告知用户结论与解决办法（合作智能体：升级到最新版本；开放智能体：从 SkillHub 安装官方「支付宝 AI 付」Skill；无法判断：升级智能体或安装支付插件后重试）。不向用户解释检查过程、不出现具体工具名、不引导站外转账。
三、服务说明
- 接口：
POST {SERVICE_URL}/invoke - 请求体：
{"task": "用户的原始写作需求"} - 产出：完整文章包（markdown）：选题方案 + 正文 + 标题排序表 + 配图方案 + 发布清单
四、工作流程（严格按顺序执行）
第一步：请求资源（probe）
POST {SERVICE_URL}/invoke
Content-Type: application/json
Body: {"task": "用户的原始写作需求，保持用户原话，不要改写"}
脚本等价命令：
node scripts/toutiao-paid.mjs probe --task "<原始写作需求>" --state-dir .state
第二步：处理 402 响应（首次调用必然返回）
若响应为 HTTP 402，从 Payment-Needed 响应头 取 Base64URL 账单并解码，向用户展示商品名与金额（amount 元），发起支付宝按量付费流程。账单中的 out_trade_no 需保留备用。此时没有正文返回，属正常行为，不是失败。
第三步：完成支付宝支付，取得 Payment-Proof
将 Payment-Needed 账单交给支付宝支付扩展完成收银（由用户本人扫码或免密支付，Agent 只编排、不代付）。支付完成后扩展返回 Payment-Proof 支付凭证（含 payment_proof、trade_no、client_session）。必须等用户确认支付完成再进入下一步。
第四步：携带 Payment-Proof 重试（complete，⚠️ 最易遗漏）
POST {SERVICE_URL}/invoke
Content-Type: application/json
Payment-Proof: {支付扩展返回的 Payment-Proof 凭证原值}
Body: {"task": "与第一步完全一致的原始请求"}
⚠️ 铁律：Body 必须与第一步完全一致；Payment-Proof 凭证原样透传，不得拆改或重新构造。 不带凭证重试拿不到结果。
第五步：核验交付
- 返回
200：校验响应头Payment-Validation（解码后validated=true且resource_id与响应体一致），然后把content字段的完整文章包交付给用户。 - 返回
502（FULFILLMENT_CONFIRM_FAILED）：用同一 Payment-Proof 原样重试，服务端会继续履约确认，不要重新发起支付。 - 返回
402：支付未完成或凭证无效，重新走第二至四步。 - 返回重复
already_fulfilled=true：说明该凭证已用过，直接交付缓存的文章包即可。
支付完成后向用户说明
- 每次调用独立计费；如需修改重写，请把修改要求一次性说清，服务端会按新任务计费
- 文章包可直接粘贴到头条创作后台发布
五、交互约定
- 用户只给主题 → 直接走完整文章包产出，不要多轮反问（按次计费，成本敏感）
- 用户没有任何主题 → 先在对话内免费问 3 个问题（方向/读者/想表达的观点），拿到答案后再发起付费调用
- 轻量环境下：先给选题与结构（免费对话确认），确认后再发起付费调用出全文
六、发布前自测
以非商家收款账号的支付宝账号，在支持支付宝 AI 付的客户端发起一次真实调用，确认「probe 402 → 支付 → complete 200」全链路通过即可发布。
