微信公众号图文自动生成与发布工作流

具体微信公众号的生成例子，可查看微信公众号：“海龙好东西”。

一、这个工作流做什么

输入一个内容主题范围（如"穿搭类"）、可选细分方向，再选填最多 5 张参考图片（比如自己拍的穿搭实拍、单品照），自动完成：

> 调研选题 + 挖评论区痛点 → 生成图文文章（可参照参考图）→ AI 文生图实际生成 4-5 张配图 → 配图插入文章并排版成带内联样式的 HTML 文件 → 上传草稿箱（可选自动发布）

在 AI 对话中执行时：节点 5 会实际调用文生图工具（如 image_gen，模型选 seedream）根据配图描述生成真实图片，节点 6 会把生成的图片 URL 插入到 HTML 对应位置，并输出一个 .html 文件交付给用户，可直接用浏览器打开后全选复制粘贴进公众号编辑器。

〇、支付门禁（强制前置，未付费不得生成文章）

这是付费版与免费版的唯一区别，也是最优先执行的步骤。 在执行第一章～第七章的任何创作动作之前，必须先完成下面的 probe → pay → complete → ack 四步付费闭环。只有第 ack 步拿到了 HTTP 200 且 fulfillment_confirmed=true 的服务资源，才允许开始选题、写作和配图；否则必须停止并向用户说明"尚未完成付费"，不得免费直出内容。

> 🚫 硬性规则：禁止向用户索要任何配置。
> RESOURCE_URL 已内置（见 0.1），不要询问用户服务地址，不要用 AskUserQuestion 问"谁来提供 RESOURCE_URL"。收到生成文章的请求后，直接从 0.2 probe 开始执行，唯一需要用户参与的环节是 0.3 的扫码付款。
> 用户唯一可能提供的输入是文章主题；主题为空时自行选题。主题会以 ?topic= 参数附加到资源地址上，服务端会把它传给文章生成。

0.1 配置变量

> 安全边界：本 skill 是买家侧实现，只包含上述三个变量，绝不包含商户私钥、sellerId、serviceId 等商家配置——那些属于服务端（pay-demo），不进 skill 包。

0.2 probe — 请求资源，获取 402 账单

不带任何凭证请求 RESOURCE_URL（主题非空时带 ?topic=<URL编码主题>），服务端返回 HTTP 402，完整账单在 payment-needed 响应头（Base64URL 编码）：

curl -s -D headers.txt "$RESOURCE_URL" -o /dev/null
# 期望：HTTP/1.1 402 Payment Required + payment-needed: eyJwcm90b2NvbCI6...

用 Node 解码账单为挑战文件（跨平台写法）：

node -e "const fs=require('fs');const h=fs.readFileSync('headers.txt','utf8');const m=h.split(/\r?\n/).find(l=>l.toLowerCase().startsWith('payment-needed:'));const j=JSON.parse(Buffer.from(m.split(':').slice(1).join(':').trim(),'base64url').toString('utf8'));fs.writeFileSync('challenge_bill.json',JSON.stringify(j));console.log('订单='+j.protocol.out_trade_no+' 金额='+j.protocol.amount)"

账单含 out_trade_no、amount（以后端服务定价为准）、goods_name、seller_signature(RSA2) 等。把金额和商品名如实告知用户后再进入 pay 步骤。

0.3 pay — 发起支付宝付款（moveToMobile）

alipay-bot 402-buyer-pay -f challenge_bill.json -r "$RESOURCE_URL" --json

成功返回：payScheme（支付宝拉起链接）、shortenUrl（短链）、mediaPaths（二维码 PNG 路径）、tradeNo（付款单号，后面回传凭证全靠它）、needPolling: true。

执行动作：把二维码图片展示给用户（复制到工作目录后交付），同时附上短链兜底，请用户用支付宝扫码付款。

0.4 等待支付完成 — 后台轮询

二维码展示给用户后立即启动本步轮询，不要停下来等用户说"付完了"（用户扫码需要时间，轮询本身最多等 6 分钟）：

alipay-bot poll-payment-status --launch-url "<payScheme原样传入>" --interval 5000 --max-attempts 72 --json

轮询结果 finalStatus=success 即支付完成（实测约 15 次×5 秒内感知）。若用户取消或超时，终止本次调用并如实告知，不得跳过门禁继续生成。

0.5 complete — 回传凭证，验付+履约（关键恢复命令）

alipay-bot 402-query-payment-status --out-shake-no <0.3返回的tradeNo> --resource-url "$RESOURCE_URL" --json

成功标志：resourceResponse.status=200，body 中 fulfillment_confirmed=true、out_trade_no 与本地账单一致、content 为服务资源内容。

实测踩坑（重要，按此排错）：
- --trade-no <支付宝交易号> 会报 BIZ_ORDER_NOT_FOUND 业务单不存在——必须用 --out-shake-no + 0.3 返回的 tradeNo（付款单号）。
- 对已付账单重跑 402-buyer-pay 会报 TRADE_ALREADY_PAID 交易单已支付过——这正是凭证未回传的表现，用上面的 402-query-payment-status 恢复即可，不要重新下单重复扣费。
- 服务端幂等：同一订单重复回传凭证不会重复扣费，返回历史履约结果（already_fulfilled=true）。

0.6 ack — 确认回执，放行创作流程

核对以下三点全部成立，本次付费闭环才算完成：
1. resourceResponse.status === 200
2. body.fulfillment_confirmed === true
3. body.out_trade_no === challenge_bill.json 里的 out_trade_no

通过后 → 进入第一章～第七章正常创作流程；不通过 → 停止并向用户展示具体错误。

二、开搭之前必须准备好的东西

1. 一个已完成微信认证的公众号（服务号或订阅号）——发布类接口目前只对认证账号开放，未认证账号调不通。
2. 登录微信公众平台 → "开发" → "基本配置"，拿到 AppID 和 AppSecret。
3. 同一页面配置 IP 白名单（按你使用的插件文档要求填对应 IP，否则草稿箱可能显示为空）。
4. 登录扣子（coze.cn），新建一个工作流。

三、节点设计

节点 1：开始（输入表单）

上传自己的穿搭实拍或单品照后，节点 2 的选题、节点 4 的正文、节点 5 的配图都会围绕这几张图展开；不上传就按纯话题调研的方式走。

这样设计的好处：表单化输入让用户每次跑工作流时只需要填几个框就能用；参考图当一等公民，是因为很多内容品类（穿搭、美食、家居）本质上是"图驱动"的，纯文字生成容易脱离实际素材。

节点 2：选题调研（插件：网页搜索 / 资讯类插件）

• 输入：topic_category、sub_direction
• 作用分两步：
  1. 搜"入秋穿搭"近期的热门文章、话题、单品关键词
  2. 再专门搜一轮"评论区""网友问""求助"这类词（有小红书类搜索插件更好），挖网友在穿搭笔记评论区 / 问答区问得比较多的问题（比如"微胖""显高""通勤"这类高频困扰），作为后面写文章要正面回应的"痛点"
• 输出：search_result、pain_points

为什么要单独挖评论区：光搜同类爆款文章容易写成"正确的废话"。网友实际在问的问题才是真正的内容缺口，把这些当痛点传给写作节点，文章才有针对性。

节点 3：选题与标题生成（大模型节点）

模型可选豆包、Kimi、通义千问，都在扣子"模型管理"里直接选，不用额外接 key。

• 输入：search_result、pain_points、topic_category、style_tone
• 系统提示词参考：

你是一名资深{topic_category}领域自媒体编辑。请基于以下调研信息和网友常问的问题，提出1个最适合公众号发布的选题方向和标题。要求：标题20字以内，优先回应网友真实关心的问题，突出实用性或反常识角度，不使用夸张诱导性表述；说明选择理由。

• 输出：title、topic_angle

节点 4：正文生成（大模型节点，模型同节点 3 三选一）

• 输入：title、topic_angle、pain_points、style_tone、ref_images（如有上传）
• 系统提示词参考：

请以"{title}"为题，写一篇适合微信公众号发布的图文文章正文。

要求：
- 全文原创，不得复制或改写任何具体来源文章的表述
- 优先逐一回应{pain_points}里网友关心的问题
- 如提供了参考图片，正文要结合图中单品/穿法具体展开，不要写成脱离图片的泛泛建议
- 800-1200字
- 分3-5个小标题，每个小标题下2-3段说明+建议
- 语言{style_tone}，避免生硬说教
- 结尾自然引导关注和互动，不使用夸张承诺

【去AI味，用大白话写——这一条最重要】
- 像跟闺蜜/朋友聊天一样自然地写，想到哪说到哪，但逻辑要清楚
- 绝对不要用"首先、其次、再次、最后、综上所述、值得注意的是、值得一提的是、由此可见、不仅如此、与此同时"这类AI高频书面连接词
- 不要每段都排比、不要刻意对仗、不要用"让我们一起""希望这篇文章能帮到你"这类套话
- 多用短句，少用长难句；可以用口语化表达、偶尔用反问句（"你说是不是？""谁还没踩过这个坑？"）
- 可以用"说实话""讲真""我跟你说""别不信""过来人告诉你"这类真人分享的口吻
- 举例子要具体，不要说"很多人都有这个问题"，要说"我当时就是这样""我闺蜜生完跟我吐槽"
- 读起来要像一个有经验的人在跟你唠嗑，而不是机器在输出标准答案

• 输出：article_body

全文原创是硬要求：不要设计成"扒一篇同类爆款然后 AI 仿写"的模式，容易踩版权红线。调研阶段拿到的是话题 / 趋势 / 网友提问，不是某一篇具体文章的内容。

节点 5：AI 文生图配图（实际生成图片，不只是描述）

• 输入：article_body 中各小标题、ref_images（如有上传）
• 作用分两步：

第一步：为每张图写出生图提示词
- 先根据文章结构确定配图数量：封面 1 张 + 每个小标题各 1 张，通常共 4-5 张
- 为每张图写一段详细的文生图提示词，包含：画面主体、场景、风格（如"温馨插画风格""暖色调写实风"）、构图、光线、色彩基调
- 封面图（第1张）提示词特殊要求：必须根据全文内容和标题生成对应风格的画面，画面中要预留文字区域，并明确写上"图片上加上文字，文字内容为：{title}，字体清晰醒目，与画面风格协调，放在画面上方或下方留白处"。封面图是公众号头图，标题文字是必须有的，不能只生成纯画面
- 正文配图（第2张起）：不加文字，保持画面干净，围绕对应小标题的内容生成
- 有参考图（ref_images）时，提示词中要明确描述参考图里的单品 / 人物 / 场景特征，让生成图围绕参考图展开，而不是凭空生成不相关的内容
- 输出配图清单：每张图的编号、对应文章位置、生图提示词

第二步：调用文生图模型实际生成图片
- 在 AI 对话环境中执行时，使用 image_gen 工具（模型选 seedream_4.5 或 seedream_5.0_pro），将上一步的每条提示词作为独立请求并行调用，一次生成全部 4-5 张图
- 图片尺寸规范：
- 封面图（第1张）：width=2350, height=1000（2.35:1 电影宽银幕比例，公众号头图最佳比例）。封面图必须根据全文内容和标题生成对应风格的画面，且图片上要加上文章标题文字——文字内容就是 {title}，字体清晰醒目、与画面风格协调，通常放在画面上方或下方的留白区域，确保在手机上缩小后仍能看清标题
- 正文配图（第2张起）：width=1080, height=1350（4:5 竖版，适合手机阅读）或 width=1024, height=1024（1:1 方图）。正文配图不加文字，保持画面干净
- 在扣子平台执行时，使用扣子自带的"图像生成"节点（模型选豆包·SeeDream），把上传的参考图作为"参考图"参数传入，用"循环节点"包住跑多次
- 生图失败或无生图能力时，退回输出"配图描述"文字供用户手动找图，但必须在交付说明中明确标注哪些图未生成

• 输出：image_list（包含每张图的：编号、对应文章位置、生图提示词、生成的图片 URL 或本地路径）

配图插入位置规范（节点 6 会用到）：
- 第 1 张（封面图）→ 插入在文章大标题之后、正文第一段之前
- 第 2 张起 → 每张插入在对应小标题的标题文字之后、该小节正文段落之前
- 图片下方不加图注（公众号排版通常不加），如需要可用小字灰色标注

为什么要实际生成图片而不是只给描述：用户要的是一篇能直接用的完整图文，不是"文章+配图建议"的半成品。实际生成图片并插入 HTML，用户拿到后可以直接预览效果、复制粘贴，省去了自己找图和排版的步骤。

节点 6：HTML 排版（代码节点 / 文件生成，图片直接插入）

• 输入：title、article_body、image_list
• 作用：把文章正文和节点 5 生成的实际图片组装成一个带内联样式的完整 HTML 文件，图片以 <img src="..."> 方式直接插入到对应位置，用户用浏览器打开后全选复制即可粘贴进公众号编辑器。
• 输出：formatted_html（HTML 字符串）+ 一个 .html 文件（保存到工作目录并通过 present_files 交付给用户）

图片插入规则（严格按此顺序）：
1. 文章大标题 <h1> 之后 → 插入封面图（image_list[0]），居中显示
2. 每个 <h2> 小标题之后 → 插入该小节对应的配图（image_list[1]、image_list[2]……依次对应），居中显示
3. 如果某张图生成失败，在对应位置插入一行灰色小字提示"（此处建议配图：[配图描述]）"，不要留空白
4. 图片统一加 width: 100%; max-width: 100%; height: auto; border-radius: 8px; display: block; margin: 16px auto; 样式

HTML 排版规范（内联样式，不依赖外部 CSS）：

HTML 文件结构模板：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>{title}</title>
</head>
<body style="margin: 0; padding: 0; background: #f5f5f5;">
<div style="max-width: 677px; margin: 0 auto; padding: 20px 16px; background: #fff; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'PingFang SC', 'Hiragino Sans GB', 'Microsoft YaHei', sans-serif; color: #333; line-height: 1.8;">

<h1 style="...">{title}</h1>

<img src="{封面图URL}" style="..." alt="封面图">

<p style="...">正文第一段……</p>

<h2 style="...">小标题一</h2>
<img src="{配图1URL}" style="..." alt="小标题一配图">
<p style="...">正文……</p>

<h2 style="...">小标题二</h2>
<img src="{配图2URL}" style="..." alt="小标题二配图">
<p style="...">正文……</p>

<!-- 更多小标题和配图依次排列 -->

<p style="...结尾互动引导...">你待产包里最后悔买的是什么？评论区聊聊～</p>

</div>
</body>
</html>

交付方式：将 HTML 内容写入 .html 文件（文件名用文章标题的拼音或简短英文，如 daichanbao_article.html），保存到工作目录后通过 present_files 工具交付。同时在回复中说明：用浏览器打开该文件 → 全选（Ctrl+A）→ 复制（Ctrl+C）→ 粘贴到公众号编辑器即可，图片会自动上传到公众号素材库。

这样做的好处：用户拿到的不是一段需要自己拼图片的 HTML 代码，而是一个可以直接在浏览器里预览完整效果（文字+图片+排版）的文件，确认无误后一键复制粘贴，省去了手动插图和调整样式的步骤。

节点 7：上传素材（插件：微信公众号"新增永久素材"接口）

• 输入：image_list 中的图片
• 输出：media_id_list

节点 8：创建草稿（插件：微信公众号"新建草稿"接口）

• 输入：title、formatted_html、封面 media_id
• 输出：draft_media_id

节点 9：条件判断 + 发布（插件：微信公众号"发布"接口）

• 仅当 auto_publish = true 时执行
• 输出：publish_status

自动发布默认关掉：发布是不可逆操作，让内容先进草稿箱人工审核，等用户明确说"跑稳定了"再讨论打开。

节点 10：结束

• 输出：draft_media_id、publish_status、title

四、需要去插件商店搜索安装的插件

五、建议的测试顺序

1. auto_publish 固定为 false，先跑几次
2. 分别测试"不传参考图"和"传 1-5 张自己的穿搭照"两种情况，看文章和配图是否贴合参考图
3. 去草稿箱确认格式、图片是否正常
4. 稳定后再考虑打开自动发布

六、踩过坑的设计原则

新需求来的时候，不管换什么主题（美食、母婴、家居、旅行），以下原则都适用：

1. 表单化输入，参考图当一等公民：开始节点尽量做成用户能直接填的表单（主题范围、细分方向、语气、是否自动发布这几项是标配），如果内容支持配图 / 参考素材，加一个"参考图上传"选项（几张为宜），并在后面每个相关节点里明确说"如果有参考图，就参照着写 / 参照着生成"——不要假设内容一定是纯文字驱动的。

2. 调研不能只看"热门文章"，要挖真实提问：光搜同类爆款文章容易写成正确的废话。多加一步，去评论区 / 问答区挖网友实际问的问题，把这些当"痛点"传给写作节点，要求正文优先回应这些痛点——这样写出来的东西才有针对性。

3. 大模型和生图能力，优先用平台自带的：无代码平台（扣子等）通常自带多个大模型可选（不需要用户自己申请 API key），也自带支持"传参考图"的图像生成节点。设计时先确认这些原生能力够不够用，只有覆盖不到时才建议去插件商店找第三方插件——这样用户少踩"装插件、配 key"的坑。

4. 正文生成必须要求"全文原创"：不要设计成"扒一篇同类爆款文章然后 AI 仿写"的模式，容易踩版权红线。调研阶段拿到的应该是话题 / 趋势 / 网友提问，不是某一篇具体文章的内容，写作节点的提示词里要明确写"不得复制或改写任何具体来源文章的表述"。

5. 涉及健康 / 安全 / 金钱类内容，提示词里加免责表述：比如母婴、医美、理财类选题，系统提示词要求"措辞谨慎、避免绝对化结论、必要时提示咨询专业人士"，不要求模型说得斩钉截铁。

6. 自动发布默认关掉：只要工作流最后一步是"发布到公众号"这类不可逆操作，对应的开关参数默认给 false，让内容先进草稿箱人工审核。

7. 改一个节点的输入输出时，顺手检查下游有没有跟着更新：比如给"开始"节点加了参考图参数，后面用到正文生成、配图的节点也要相应加上这个输入，并在提示词里体现出来——不然文档内部会自相矛盾，用户拿去给平台生成时容易漏掉这层关联。

8. 正文要用大白话，去掉AI味：写作节点的提示词里必须明确要求用人类自然语言、口语化表达。禁用"首先/其次/综上所述/值得一提的是/由此可见"这类AI高频书面连接词，禁用排比堆砌和"让我们一起"这类套话。多用短句、口语化表达、反问句，像真人在跟朋友唠嗑一样分享经验。这一条比文笔优美更重要——读者一眼就能看出是不是AI写的，AI味重的文章没人愿意看完。

9. 封面图必须是2.35:1且带标题文字：公众号头图用2.35:1（2350×1000）的电影宽银幕比例，视觉冲击力最强。封面图不能只生成纯画面，必须在图片上加上文章标题文字，字体清晰醒目、与画面风格协调，放在画面上方或下方留白区域。这样分享到朋友圈或聊天时，别人不用点进去就能看到标题，点击率更高。

七、参考模板

references/workflow_template.md 是一份已经打磨过好几轮反馈的完整示例（母婴类公众号，从选题调研到发布），结构和本文档一致：开始（表单 + 参考图上传）→ 选题调研（含评论区痛点挖掘）→ 选题标题生成（多模型可选）→ 正文生成 → AI 文生图（实际生成 4-5 张配图，含生图提示词和尺寸规范）→ HTML 排版（图片插入对应位置，输出带内联样式的 .html 文件）→ 上传素材 → 建草稿 → 条件发布 → 结束。

新需求来的时候，复制这份结构，替换主题相关的具体内容（选题方向、提示词里的行业措辞、准备工作里的平台账号类型），节点数量和分工一般不用大改。需要时读取该文件获取完整母婴类提示词和参数细节。

八、SkillPay 付费改造（支付宝 AI 按量付费协议）

本技能可作为 Pay Skill（付费 Skill） 上架 SkillHub，按次计费（默认 ¥2/次）。付费链路基于 支付宝 AI 按量付费协议，由后端服务（pay-demo）承担 402 账单下发、验付与履约确认。用户通过 Agent 调用本技能时，先完成支付宝付款，验付通过后才生成公众号文章。

> ✅ 2026-09-18 已完成本地集成：参照项目位于 %USERPROFILE%\alipay-aipay-projects\pay-demo（Node.js + Express + alipay-sdk@4.14.0），协议控制流已按官方契约实现并通过语法/守卫校验，沙箱端到端联调与签约入驻按 8.0 的流程推进。
> ✅ 2026-09-19 买家侧门禁已实装并生产验证：本 skill 第〇章即买家侧 probe/pay/complete/ack 的可执行实现，已在生产环境完成两笔真实 ¥0.01 交易全链路验证（402 下单 → 扫码支付 → 验付 → 履约确认 → 资源交付）。

8.0 接入工具链：用 alipay-aipay 技能跑全流程（不要手写协议）

安装（Agent 环境执行一次）：

npx -y @alipay/alipay-aipay@latest install

• 安装位置：C:\Users\<用户>\.agents\skills\alipay-aipay（macOS/Linux 同理在 ~/.agents/skills/）。
• Windows 环境注意：
• 该 npm 包安装器会尝试 spawn sh 安装 alipay-cli，环境缺 sh 时报 spawn sh ENOENT；此时按 manifest 手动装 CLI：从 https://opengw.alipay.com/alipaycli/manifest 取 windows_amd64 产物，下载为 %USERPROFILE%\.local\bin\alipay-cli.exe 并校验 SHA256。
• Windows 没有快速沙箱：需要用户到支付宝 AI 付站点（https://aipay.alipay.com）"一站式接入-技术集成"页获取沙箱资料（沙箱 APPID、支付宝公钥、应用公钥、与语言匹配的应用私钥、沙箱账号），由用户交给 Agent 写入项目配置；生产私钥和密码严禁提供给 Agent。
• 正式集成/沙箱测试/签约入驻统一走 alipay-aipay 技能自身的 runtime 流程（full_process 根意图，产品 aipay），不要脱离该技能手搓 MCP 调用或自拟消息。

8.1 支付协议流程（后端服务必须实现）

付费服务端（pay-demo/server.js）实现以下完整协议，缺一不可：

1. 402 账单下发：Agent 首次请求资源接口（GET /demo/a2m/resource）且未携带 Payment-Proof 请求头时，服务端返回 HTTP 402，并在 Payment-Needed 响应头中下发 Base64URL 编码账单。账单 protocol 含 out_trade_no、amount（¥2.00）、currency=CNY、resource_id、pay_before、seller_signature、seller_sign_type=RSA2、seller_unique_id；method 含 seller_name、seller_id、seller_app_id、goods_name、seller_unique_id_key=seller_id、service_id。
2. 携带凭证重试：用户付款后，Agent 携带 Payment-Proof 请求头（Base64URL 编码，含 protocol.payment_proof、protocol.trade_no、可选 method.client_session）重试同一资源接口。
3. 验付调用：服务端调用支付宝接口 alipay.aipay.agent.payment.verify（bizContent: trade_no、payment_proof、可选 client_session），校验 code=10000、active=true、返回 amount 与本地订单一致、out_trade_no 与本地订单一致、resource_id 与请求资源一致；任一不符返回 402 让智能体重新支付，不得返回资源。
4. 履约确认：验付通过并生成资源后，调用 alipay.aipay.agent.fulfillment.confirm（bizContent: trade_no）确认履约，确认成功后才把订单标记为最终完成并返回资源；确认失败允许同一 Payment-Proof 重试，避免资源已生成但平台未记录履约。
5. 订单持久化与幂等：服务端在返回 402 前持久化订单（out_trade_no、resource_id、金额、状态、过期时间）；同一订单重复携带 Payment-Proof 时不得重复扣费或重复生成资源，返回历史履约结果。

商家签名规则（实测契约）：seller_signature 按 key 字典序拼接 amount、currency、goods_name、out_trade_no、pay_before、resource_id、seller_id、service_id，RSA-SHA256 本地签名，不请求支付宝服务端。

SDK 实测要点（alipay-sdk@4.14.0，Node.js）：
- 导入方式为命名导出：const { AlipaySdk } = require('alipay-sdk')（以实际安装版本的类型定义为准，勿照抄旧示例）。
- 非 Java 语言私钥固定用沙箱返回的 appPrivatePkcsKey（PKCS#1）原始字符串，禁止 PEM 包装/格式转换；SDK 配置用公钥模式（alipayPublicKey）。
- 生成商家签名时用原生 crypto 临时构造 PKCS#1 密钥对象（createPrivateKey({format:'der',type:'pkcs1'})），不写回配置。
- 沙箱网关 https://openapi-sandbox.dl.alipaydev.com/gateway.do（默认），生产显式设 ALIPAY_GATEWAY=https://openapi.alipay.com/gateway.do；沙箱 service_id 固定 api_mock_service_id，生产替换为服务市场真实 serviceId。
- 沙箱联调金额固定 ¥0.01（官方示例 amount='0.01'，沙箱收银接口会校验账单金额与 mock 服务定价一致，下发自定义金额会收到 SERVICE_PRICE_MISMATCH）；生产金额按服务市场注册单价配置。
- 履约确认必须带重试：沙箱实测支付完成后交易同步到 alipay.aipay.agent.fulfillment.confirm 有短暂延迟，期间网关直接返回 HTTP 404；对 confirm 做 3 次、间隔 2 秒的重试即可规避。确认失败时服务端应保留资源与 PENDING_CONFIRM 状态，允许同一 Payment-Proof 重试。
- 沙箱账号信息（商家 PID、买家 userId）在支付宝开放平台「沙箱」页（https://open.alipay.com/develop/sandbox）获取，不在 AI 付控制台；Windows 上 curl -o /dev/null 会解析为当前盘根的 C:\dev\null，预建 C:\dev 目录可让官方测试脚本正常工作。

协议调用命名约定（Agent 侧 Skill 调用付费服务的标准步骤名）：probe（探测资源接口、获取 402 账单）→ pay（向用户发起支付宝付款）→ complete（携带 Payment-Proof 完成验付与履约）→ ack（确认履约回执与资源交付）。买家侧的可执行实现见本技能第〇章（含实测命令、参数与踩坑排错），本节仅描述服务端契约。

8.2 支付成功后交付内容

验付与履约确认通过后，服务端返回 resource_id、content（支付成功确认 + 本次调用令牌）及 Payment-Validation 响应头（trade_no、out_trade_no、validated=true、resource_id）。Agent 收到 HTTP 200 且 Payment-Validation 有效后，继续按本技能第一至七章执行公众号文章生成流程。

计费口径：单次调用金额以后端 402 账单的 amount 为准（买家侧无权也无须指定金额）。SkillHub 上架口径为 ¥2.00/次，因此后端服务定价必须同步改为 ¥2.00（当前生产测试配置为 ¥0.01，正式上架前改价并重启服务）。

8.3 后端服务部署

• 参照实现：%USERPROFILE%\alipay-aipay-projects\pay-demo
• server.js：完整 A2M 控制流（402 → 验付 → 幂等履约 → 确认 → 交付）
• config.js：读取项目根 .alipay-sandbox.json（缺配置时明确失败退出，不回退占位值）
• order-store.js：文件持久化订单仓储（原子写入，out_trade_no/trade_no 唯一约束防重复履约）
• 沙箱配置文件 .alipay-sandbox.json（必须加入 .gitignore）：

{
  "appIds": ["沙箱APPID"],
  "alipayPublicKey": "支付宝公钥（沙箱）",
  "appPrivatePkcsKey": "应用私钥 PKCS#1 原始字符串（无 PEM 头尾）",
  "sellerId": "2088 开头的商家账号"
}

• 生产部署：迁移到腾讯云轻量服务器等公网主机（https://你的域名/demo/a2m/resource，必须 HTTPS），配置替换为生产应用密钥与真实 serviceId，建议 PM2 守护 + Nginx 反向代理 + SSL。
• 沙箱端到端联调用 alipay-aipay 技能的 a2m precheck + a2m run --auto-complete --require-payment-validation，不要手写测试脚本。

8.4 签约入驻与 SkillHub 上架

签约入驻（签约定价、服务注册，获得生产 serviceId）：
1. 前置：alipay-cli 可用（alipay-cli version 正常）+ 支付宝商家账号授权登录（按 alipay-aipay 技能 Onboarding 流程生成授权页，用户扫码完成授权）。
2. 在支付宝 AI 付站点（https://aipay.alipay.com）完成产品签约与服务注册，把服务市场返回的真实 serviceId 替换掉 api_mock_service_id，并替换生产密钥后重新联调一遍。

SkillHub 上架配置：