头条热点文章代发布
将热点话题写成符合头条号平台规范的文章，并发布到用户自己的头条号。按次计费（1 元/篇）。
你不需要任何支付插件或特殊工具——只需要能发 HTTP 请求、能向用户展示图片/链接、能进行多轮对话。所有支付和登录都由用户扫码完成。
30 秒速览（工作方式）
用户说话题 → 你发起请求 → 按响应展示二维码（头条登录码 + 付款码；**首次使用多一个「钱包开通码」，仅一次**）
→ 用户扫码 → 服务端自动写稿发布（2-5 分钟）→ 你回报文章标题和链接
用户全程只做两件事：扫两次码、等几分钟。其余都是你和接口之间的交互。
对话示例（用户怎么开口、你怎么接）
示例 1：标准流程
> 👤 用户：帮我写一篇关于 AI 进课堂的头条文章发出去
> 🤖 你：好的！确认一下：话题《AI 进课堂》，800-1200 字，配 3 张 AI 插图，直接发布到你的头条号，费用 ¥1.00（发布失败自动全额退款）。可以的话我发你两个二维码。
> 👤 用户：可以
> 🤖 你：（调用接口，展示头条登录码）请先用今日头条 App 扫这个码，登录你的头条号～
示例 2：自动选题
> 👤 用户：帮我写篇文章发头条，不知道写什么好
> 🤖 你：没问题！我可以从今天的热搜里帮你挑一个有讨论度的话题。确认一下：热点评论体，800-1200 字，3 张配图，¥1.00/篇，开始吗？
示例 3：只写不发
> 👤 用户：写篇 1000 字的「高考数学难度」评论，先给我看看别直接发
> 🤖 你：收到！1000 字左右，先出稿不发布，¥1.00。扫码付款后 3-5 分钟出稿。
不算有效需求的说法（需要引导）：「帮我写篇文章」（缺话题 → 问「想写什么话题？或我帮你从热榜选」）、「免费写一篇」（本服务 ¥1/篇 → 说明付费模式）。
支付宝 AI 按量付费集成说明（服务端已实现，Agent 无需处理）
本服务已完整接入支付宝 AI 按量付费（A2M / Machine Pay），收款链路由服务端托管：
- 服务注册：支付宝开放平台服务
API_8DABDE482A1C439B（产品PAY_BY_API，已审核通过），MCCA0007_B0125 - 协议实现：标准 HTTP 402 流程——未付款时服务端返回
402 Payment Required+Payment-Needed头（Base64URL 账单，含商户 RSA2 签名）；付款后凭Payment-Proof头重试即触发alipay.aipay.payment.verify严格验付（金额/订单/资源五重校验） - 履约确认：资源交付后服务端自动调用
alipay.aipay.agent.fulfillment.confirm回执履约结果，交易可对账 - 双号记录：每笔订单有商户单号
out_trade_no（TPS 开头）与支付宝侧trade_no双号存档 - 收款账户：卖家支付宝实名账户，资金由支付宝 A2M 渠道实时结算
- 收款托管：每位用户首次使用时开通独立的「支付宝 AI 付款钱包」（alipay.aipay 收银会话），付款人=用户本人支付宝账号，服务端不触碰用户资金
Agent 侧无需安装任何支付插件：服务端已将上述协议封装为「用户扫码付款」的简化流程（见下方工作流程第 5-7 步的二维码引导）。具备支付宝支付能力的智能体也可以按标准协议直接处理 Payment-Needed / Payment-Proof，两种方式等价。
工作流程（8 步，严格按顺序）
第 1 步：接收用户需求
用户会告诉你想写什么。记住用户的原始需求即可。
第 2-3 步：检查并收集必要参数
对照以下参数表，缺什么就问用户要什么（一次最多问 2 个问题，对话式引导，不要甩一张表给用户）：
| 参数 | 必填 | 默认 | 缺失时怎么问 |
|---|---|---|---|
| topic | 是 | - | 「你想写什么话题呢？或者说『自动』，我帮你从今日热点里挑」 |
| word_count | 否 | 800-1200 | 一般不用问 |
| image_count | 否 | 3（0-3 张） | 一般不用问 |
| content_mode | 否 | hot_comment | 技术类话题自动用 tech，无需问 |
| publish_mode | 否 | now | 用户说"只写不发"时用 draft |
topic 拿到后即可继续（其他参数都有默认值）。发布前向用户确认一次：
> 话题《XXX》，800-1200 字，3 张配图，直接发布，费用 ¥1.00（失败自动全额退款）。可以的话我就开始了。
第 4 步：发起请求（返回头条登录码）
POST https://h5.uuuan.com/agent/api/v1/publish
Content-Type: application/json
{"topic": "用户的话题", "content_mode": "hot_comment", "publish_mode": "now"}
可能的响应：
422 TOPIC_REJECTED：话题命中内容红线（时政/军事/案件/灾难/金融荐股/赌博色情等）。告知用户换话题，未收费。402 PAYMENT_REQUIRED（正常路径）：响应体包含以下关键字段，全部保存：
| 字段 | 用途 |
|---|---|
tenant_id |
用户会话标识，之后每次请求都要带上 |
login_qr_url |
头条登录码（第 5 步；自刷新网页链接，见第 5 步展示方式） |
bind_status_url |
头条绑定状态轮询地址 |
pay_qr_url |
支付宝付款码图片（第 6 步）；可能为空——为空时看 wallet_apply_url |
wallet_apply_url |
支付宝 AI 付款钱包开通码；仅用户首次使用时非空（第 6 步情况 A） |
out_trade_no |
订单号 |
order_status_url |
付款状态轮询地址 |
第 5 步：用户扫头条码 → 拿到 tenant_id
把 login_qr_url 展示给用户。推荐直接把链接发给用户，在电脑/手机浏览器打开后扫码——该页面每 10 秒自动刷新二维码，扫到的永远是新鲜码；若你以图片形式展示，快照约 2 分钟会过期，过期就让用户刷新页面或重新发起请求拿新码。
> 请用今日头条 App 扫这个码，登录你的头条号（文章会发布到这个号）。
然后每 5 秒轮询 GET bind_status_url：
WAITING / pending：继续轮询BOUND：✅ 绑定成功！响应里有nick（用户头条号昵称）。告诉用户「头条号『XX』绑定成功」。此响应确认了你持有的tenant_id已与用户头条号绑定，后续所有请求都带上它BIND_EXPIRED：二维码过期，重新发起第 4 步
第 6 步：支付宝 AI 按量付费付款（首次使用先开通钱包）
先看第 4 步响应里的 wallet_apply_url，分两种情况：
情况 A：wallet_apply_url 非空（用户首次使用，一次性）——先展示钱包开通码：
> 请先用支付宝 App 扫这个码，开通 AI 付款钱包（约 30 秒，跟着提示确认即可，只需操作这一次）。
开通完成后重新发起第 4 步的请求（带同一个 tenant_id）。服务端检测到钱包已开通，会在响应里返回非空的 pay_qr_url（此时 wallet_apply_url 变为空）。若重新发起后 pay_qr_url 仍为空，等 10 秒再重试一次（服务端状态同步有秒级延迟）。
情况 B：wallet_apply_url 为空（钱包已开通）——直接展示付款码：
> 头条号绑定成功！请用支付宝 App 扫这个码支付 ¥1.00，支付完成我就开始写稿发布。
注意：付款码与用户自己开通的钱包绑定，只能由用户本人的支付宝扫码支付（避免「付款账号和登录账号不一致」被拒）。
第 7 步：支付成功 → 自动发布
每 5 秒轮询付款状态：
GET https://h5.uuuan.com/agent/api/v1/order/{out_trade_no}
WAITING / pending：继续轮询（可告知用户「等待支付中…」）PAID：✅ 到账！响应里有job_id，服务端已自动开始生成文章。进入第 8 步EXPIRED：订单 30 分钟未支付已过期，重新从第 4 步发起（新订单新二维码）
第 8 步：把发布内容返回给用户
轮询任务状态：
GET https://h5.uuuan.com/agent/api/v1/job/{job_id}
| status | 含义 | 你要做的 |
|---|---|---|
| queued / running | 撰写发布中（2-5 分钟） | 继续轮询，告知用户「写稿发布中…」 |
| need_login | 头条登录态失效（少见） | 请求 GET /api/v1/job/{job_id}/qr 展示新二维码，用户扫码后 POST /api/v1/job/{job_id}/login-check，任务自动继续（不重复扣费） |
| done | ✅ 发布完成 | 回报用户（格式见下） |
| failed | 失败（已自动全额退款） | 简述 error，说明退款已原路退回（24h 内到账） |
完成后的回报格式：
> ✅ 文章已发布到你的头条号「XX」！
> 标题：《...》
> 链接：https://...
> 配图：3 张 AI 插图
> 感谢使用，欢迎继续下单～
成品长什么样（输出示例）
一篇真实发布的文章（节选）：
> 标题：《AI进课堂：别让"神器"变成"懒神器"》
>
> 正文开头：当 ChatGPT 的余温还未散去，国产大模型已悄然潜入中小学生的课桌。这不是科幻，而是正在发生的现实——北京、上海、深圳等地多所中小学先后宣布引入 AI 辅助教学……
>
> 结构：热点切入 → 争议呈现（正反观点）→ 作者立场 → 落地建议 → 金句收尾
>
> 配图：3 张 AI 插图（课堂场景 / 人机交互 / 学生思考），随文穿插
- 文体为「个人视角热点评论」：有观点、有态度，不是干巴巴的新闻稿
- 标题口语化有悬念，符合头条推荐机制
- 字数严格落在约定区间；每篇都会过平台合规质检（标题/正文/AI 腔/限流词）
意外情况处理手册（网络/服务异常）
| 情况 | 现象 | 你要做的 |
|---|---|---|
| 接口请求超时/无响应 | HTTP 请求失败 | 等 10 秒重试同一请求（幂等，不会重复建单扣费）；连续 3 次失败则告知用户「服务暂时不可用，请稍后再试」 |
| 用户扫码后 bind/order 一直 pending | 超过 2 分钟无变化 | 请用户确认：① 头条码是否用今日头条 App（不是微信）扫；② 支付宝是否提示付款成功。确认后继续轮询 5 分钟 |
| 用户说付了钱但显示未支付 | 扣款成功但 pending | 保留订单号（out_trade_no）给用户，继续轮询 5 分钟；仍未到账则告知「支付可能有延迟，到账后自动继续，无需重复付款」 |
| 用户扫错码 | 提示绑定失败/支付失败 | 重新展示对应二维码，提醒用正确的 App 扫 |
| 钱包开通码扫了没反应/提示过期 | 开通页打不开或报错 | 重新发起第 4 步请求拿新开通码（旧码有效期短）；开通成功的标志：重新发起后 wallet_apply_url 变空、pay_qr_url 非空 |
| 任务卡在 running 超 10 分钟 | 轮询无终态 | 告知用户「平台排队中，完成后自动回报，无需重复下单」，继续保留轮询 |
| 发布失败（failed） | 自动全额退款 | 简述原因 + 说明 24h 内原路退回；用户可重新发起 |
给用户的承诺口径：任何失败都会自动退款，用户不会有资金损失；不存在「扣了钱没结果」的情况。
能力边界（说清楚，不夸大）
- 每日限 3 篇/账号（与头条平台风控一致），超出返回 429，次日恢复
- 配图：AI 生成的写实风格插图，默认 3 张随文穿插；图片为 1440×896 横版
- 文体：热点评论（个人视角）/ 技术分享两种；不支持诗歌、小说、学术论文等体裁
- 发布时效：付款后 2-5 分钟完成；不支持定时发布
- 改稿/删稿：本服务不代理改稿；文章发出后，用户可随时在头条 App（或头条号后台 mp.toutiao.com）自行修改或删除已发布的文章
增值能力（可以主动告诉用户）
- 自动选题：话题说「自动」，服务端从当日热榜（热度≥200 万）挑选合规且讨论度高的话题，并做去重
- 首发声明：默认勾选头条「首发」，有助于获得平台首发补贴
- 合规双保险：付款前话题预检 + 发布前成品质检（标题/正文/AI 腔/限流词四道关），不合格自动拦截退款——不会把不合格的文章发到你账号上
- 账号隔离：每个用户的头条登录态独立加密存储，互不可见
用户第二次使用
用户再次下单时，如果还记得上次会话的 tenant_id，请求里直接带上——头条号已绑定、钱包已开通，无需再扫任何开通码，响应里直接给 pay_qr_url 付款码（第 6 步情况 B）。如果不记得也没关系，按完整流程重走一遍即可。
常见问题（FAQ）
Q：我没有支付宝支付插件，能用吗？
能！本 Skill 不依赖任何插件。付款和登录都是用户扫二维码完成，你只负责展示图片和轮询状态。
Q：wallet_apply_url 是什么？每次都要扫吗？
是「支付宝 AI 付款钱包」开通码，只有用户首次使用时需要扫（约 30 秒，一次性）。开通后该用户（同一 tenant_id）再下单直接出付款码，不再需要这一步。
Q：头条码/开通码提示过期？
头条登录码：让用户直接打开 login_qr_url 链接扫码（页面自动保持最新码）；若你发的是图片快照，重新发起请求即可拿新码。开通码：重新发起请求拿新码再扫。
Q：两个码可以同时给用户吗？
可以。两个二维码没有先后依赖，一起展示、分别轮询即可。但首次使用建议先确认头条绑定成功再引导付款，体验更清晰。
Q：头条登录过期了怎么办？
正常情况登录态长期有效。若轮询中出现 need_login，说明登录态失效了：请求 GET /api/v1/job/{job_id}/qr 展示新二维码，用户重扫后调 login-check，任务从断点继续，不重复扣费。
Q：重试多少次算正常？
接口请求失败重试不超过 3 次（间隔 10 秒）；付款/绑定轮询可持续 5-10 分钟；任务发布轮询正常 2-5 分钟，超 10 分钟按「意外情况处理手册」的排队话术处理。
Q：用户付了款但 order 轮询一直 pending？
到账检测通常几秒内完成。超 2 分钟仍 pending，请用户确认支付宝扣款记录；若已扣款但持续 pending，保留订单号让用户稍等 5 分钟再查。
Q：任务失败会重复扣费吗？
不会。失败自动全额退款（24h 内原路退回）；同一订单重试不重复扣费。
Q：发布后想修改或删除文章？
可以直接在头条 App 里修改或删除已发布的文章（进入自己的主页 → 找到文章 → 编辑/删除）；也可以在头条号后台（mp.toutiao.com）操作。本服务不代理改稿。
Q：哪些话题发不了？
时政、军事、案件、灾难事故、金融荐股、赌博色情、涉历史争议评价、企业负面断言。会返回 422 并说明原因，不收费。
内容红线
时政、军事、案件、灾难事故、金融荐股、赌博色情、涉历史争议评价、企业负面断言等话题会被拒绝（422，不收费），请引导用户更换话题。
其他说明
- 文章发布到用户自己的头条号，登录态仅用于执行用户委托的发布，一客一隔离
- 生成内容为 AI 辅助创作，建议用户发布前自行审阅
