反违章漫画批量生成

概述

概览

把文字版违章条款丢进来，一次性拿到成套的、风格统一的安全教育漫画。一条条款对应一张图：传 3 条得 3 张，传 10 条得 10 张，风格完全一致，图内文字为中文，可直接用于班前会、课件、展板与推文。

你关心的六件事

出来大概是什么样

两套画风都由用户在下单前选定（Agent 会先问，见「工作流程 · 第零步」）：

flat（工业扁平，默认） —— 深蓝 + 安全橙 + 灰的工业配色，穿灰色工装的作业人物，还原违章发生的那一瞬间（高处作业、配电室、检修平台等场景），画面顶部预留约 30% 留白用于放标题，场景中带红色中文警示牌。适合班前会卡片、展板、制度上墙。

watercolor（水彩手绘） —— 蓝绿晕染的水彩质感，红安全帽 + 白徽章 + 灰工装的卡通工人形象，线条放松、色调柔和，同样顶部留白放标题。适合培训课件、公众号推文配图。

班前会「照着文字念一遍」、推文「逐张找配图还风格打架」、PPT「临时凑插图」—— 这些现在一次请求就能批量出图，且风格统一。

功能描述

把「文字版违章条款」一次性转成「成套的漫画插图」。

输入：违章条款文字数组（中文，1~10 条），如 ["高处作业不系安全带","现场不戴安全帽"]输出：与你提交条数等量的 16:9 横版高清漫画（2560×1440）—— 传 3 条出 3 张，传 10 条出 10 张，风格统一，图内文字为中文。图片由本服务托管直链返回，保留 30 天，请及时下载保存。画风：flat（工业扁平，默认）／watercolor（水彩手绘）—— 调用前必须先问用户选哪套，并把中文答复转成英文枚举值再传参边界：单次最多 10 条；生图为慢任务，需轮询获取；中文文字由模型渲染，极复杂字可能出错，对文字准确性要求极高时建议仅用图片作配图、文字后期叠加。

付费前置检查

调用本 Skill 前，检查当前 Agent 是否已安装 weixinpay 插件（extension）：

• 已安装：可继续提供付费生成服务
• 未安装：向用户提示「当前 Agent 暂不支持微信支付付费能力」，终止流程

判定规则（官方要求）：检查工具列表里是否存在任意一个名称包含 weixinpay_ 的工具。只要存在一个即视为支持，不要按完整工具名精确匹配，否则会把"支持"误判成"不支持"。

服务与定价

🔴 一次调用买的是什么：3.00 元买的是一次生成服务，不是一个固定张数。

出图张数 = 你提交的条款条数（传 2 条就是 2 张，传 10 条就是 10 张）。

一次最多可提交 10 条，这是容量上限，不是必达数量；用不满没有余额留存，也没有补偿。

命中生成意图后，向用户展示服务名称与价格，由用户确认后进入支付流程。

工作流程

🔴 第零步：先问用户要哪套画风（不可跳过）

在发起任何请求之前，必须先向用户确认画风。 这是一个交互动作，不是可选项。

原因：本服务按次计费且付款后画风不可更改（请求体指纹含 style，付款后带不同 style 重试会被拒 PAYLOAD_MISMATCH）。如果替用户默认成 flat，用户付了钱却拿到不是他要的画风，只能走退款重下 —— 这对双方都是损失。

必须问的话术（照抄即可）：

这次漫画要哪套画风？

• A. flat 工业扁平 —— 深蓝+安全橙+灰工业配色，灰色工装作业人物，适合班前会卡片 / 展板 / 制度上墙
• B. watercolor 水彩手绘 —— 蓝绿晕染水彩质感，红安全帽+白徽章的卡通工人，适合培训课件 / 公众号推文配图

拿到答复后必须先转换再传参（这一步最容易出错）：

🔴 style 只接受英文枚举 flat / watercolor 两个值，区分大小写、前后不能有空格。

用户在中文语境里说「水彩」时，你必须把它转成 "watercolor" 再放进请求体。

绝对不要把中文原样当参数值传 —— 传 "水彩"、"扁平"、"watercolour"（英式拼写）等服务端不认识的值，会被直接拒绝并返回 400 BAD_STYLE（响应里带 allowed 合法值列表），此时用户还没付钱，属于白折腾一轮。

用户明确表示不需要选择、坚持直接出图时，可以跳过提问，但要在回复里显式说明"已按默认 flat 出图"。

第一步：请求生成

⚠️ 动手发这条请求前，先回到第零步确认画风已与用户确认。

curl -X POST https://comic-pay-backend.app.workbuddy.host/api/comic/generate 
  -H "Content-Type: application/json" 
  -d '{"items": ["高处作业不系安全带", "现场不戴安全帽"], "style": "flat"}'

第二步：处理 402 响应（支付由插件完成）

如果收到 HTTP 402 响应，weixinpay 插件会拦截并完成支付流程，无需手动调用支付接口。

402 响应中会通过 Header 和 Body 返回支付信息：

• Header WeixinPay-Required：支付凭证码（插件用于完成支付）
• Header X-Out-Trade-No：商户订单号
• Body WeixinPay.prompt：给 Agent 的支付引导语

支付过程由 weixinpay 插件处理，Skill 无需关心支付细节。

兜底：若 402 未能拉起支付卡片，用响应里的 code_url 生成二维码给用户扫码（有效期 15 分钟），并可轮询 GET /api/pay/status?out_trade_no=<单号> 确认支付结果。

第三步：支付成功后获取内容（⚠️ 必须执行）

支付成功后，必须重新发起请求获取付费内容。重试规则：

• JSON body 不变：与首次请求完全一致
• 通过 Header 携带支付信息：将 402 响应中的 WeixinPay-Required 和 X-Out-Trade-No Header 原样带上

POST https://comic-pay-backend.app.workbuddy.host/api/comic/generate
Content-Type: application/json
WeixinPay-Required: <payment_code>
X-Out-Trade-No: <out_trade_no>

{"items": ["高处作业不系安全带", "现场不戴安全帽"], "style": "flat"}

注意：body 与第一步完全一致，不要修改 body 中的任何字段。支付信息通过 Header 传递。

服务端会用请求体指纹校验一致性，body 被改动会返回 PAYLOAD_MISMATCH。

成功响应（HTTP 200）：

{
  "code": "SUCCESS",
  "content": {
    "out_trade_no": "WX402_...",
    "task_id": "task_xxx",
    "total": 2,
    "status": "pending",
    "poll": "/api/comic/tasks/task_xxx",
    "amount_fen": 300
  }
}

第四步：轮询生成结果

生图为慢任务（每条约 15~25 秒），服务端按图片级并行提交（默认并发 4）：

GET https://comic-pay-backend.app.workbuddy.host/api/comic/tasks/{task_id}

任务状态：pending → running → succeeded / partial / failed

建议间隔 5~10 秒轮询，整体超时按 total × 30 秒 估算。成功后从 items[].url 取图。

成功响应里的 items 结构（index 从 1 开始，与服务返回的 URL 格式保持一致）：

{
  "task_id": "task_xxx",
  "status": "succeeded",
  "total": 2,
  "items": [
    { "index": 1, "text": "高处作业不系安全带", "status": "succeeded",
      "url": "https://comic-pay-backend.app.workbuddy.host/api/comic/images/task_xxx/1" },
    { "index": 2, "text": "现场不戴安全帽", "status": "succeeded",
      "url": "https://comic-pay-backend.app.workbuddy.host/api/comic/images/task_xxx/2" }
  ]
}

直接把 items[].url 原样拿去下载即可，不要自己拼 URL。

（/1 与 /01 都能访问，但服务返回的是前者，照抄返回值最稳。）

单张失败时该项为 "status": "failed" 并带 error 字段，其余照常输出（任务整体为 partial）。

🔴 图片有效期：30 天，请及时下载保存。

items[].url 指向本服务的托管直链（非第三方临时链接），可长期访问、支持 HEAD 探测。

但产物仅保留 30 天，超期后链接失效并返回 404 IMAGE_NOT_FOUND。

建议拿到结果后立即把图片下载到本地或转存到目标位置（公众号素材库、课件目录、展板文件等），

不要长期依赖返回的 URL 作为唯一副本。逾期未保存导致图片丢失的，本服务无法补发。

第五步：处理异常响应

• 返回 NOT_PAID：支付尚未完成，等待后重试
• 返回 BAD_STYLE：style 传了非法值（如中文「水彩」或拼错的 watercolour）。响应体里的 allowed 字段给出合法值列表。此时尚未产生扣费，把用户的原话转换成正确英文枚举后重发即可
• 返回 REFUNDED：商户服务异常无法提供内容，已自动退款。向用户说明「抱歉，该服务暂时无法提供内容，已自动退款至原支付账户。」不要再次尝试支付或重新请求
• 返回 FULFILL_AND_REFUND_FAILED：服务异常且退款失败，建议用户联系客服
• 返回 PAYLOAD_MISMATCH：重试请求体与首次不一致，须用完全相同的 body 重试

注意事项

1. 发起请求前必须先问用户要哪套画风，不可替用户默认（详见「工作流程 · 第零步」）
2. style 只收英文枚举 flat / watercolor；用户说中文「水彩/扁平」时必须先转换再传，禁止把中文原样当参数值
3. 必须先通过「付费前置检查」确认 weixinpay 插件已安装，否则不要进入支付流程
4. 收到 402 响应时，支付由 weixinpay 插件完成，Skill 无需关心支付细节
5. 支付成功后必须主动发起重试请求，body 保持不变（包括 style，付款后改画风会被拒），通过 Header X-Out-Trade-No 传递订单号
6. 如果返回 NOT_PAID，说明支付尚未完成，请等待后重试
7. 如果返回 BAD_STYLE，说明画风值非法，按响应里的 allowed 列表纠正后重发（此时未扣费）
8. 如果返回 REFUNDED，说明服务异常已退款，告知用户并终止流程
9. 如果返回 FULFILL_AND_REFUND_FAILED，说明服务异常且退款失败，建议用户联系客服
10. 单次最多 10 条，超过请拆成多批（每批独立计费）
11. 🔴 向用户说明价格时，不得承诺"3 元给 10 张"。 3.00 元买的是一次调用，出图张数 = 用户提交的条款条数（传 3 条出 3 张）。正确说法是「3.00 元一次，可以提交 1~10 条，传几条出几张」。不要说「3 元 10 张」「用满 10 条才划算」或「建议攒够 10 条再下单」—— 前者会让用户以为传 3 条也该拿 10 张，后者会在用户有意向时把人劝走。

应用场景

手边只有两三条，也能立刻出图临时要讲 2~3 条典型违章，不必等攒够 10 条 —— 一次调用同样是 3.00 元，传几条出几张，当天就能印出来用。

班前会素材（电力检修班组）输入《严重违章清单》里的 10 条作业性违章，一次性生成 10 张统一风格漫画，打印成 A4 卡片用于班前会逐条对照讲解，替代"文字念一遍"的方式。

公众号配图（安全主题推文）一篇"反违章 10 条"推文需 10 张风格一致的配图，同一批条款生成后直接排版，视觉风格统一，不需逐张调整。

培训课件插图安全培训 PPT 需要成套插图，用 watercolor 风格生成统一视觉语言，顶部预留留白正好放标题。

宣传栏 / 展板按季度更新的安全宣传栏，把当季典型违章批量出图，风格统一、更新快。

常见问题

一次能生成多少张？ 出图张数 = 你提交的条款条数（传 3 条就是 3 张）。单次最多可提交 10 条，超过请拆批（每批独立计费）。

图片能商用吗？ 能。生成结果可直接用于企业内部培训、宣传与公众号配图。

图片能保存多久？ 30 天。返回的 items[].url 是本服务托管直链，30 天内可随时访问、可 HEAD 探测；超期后链接失效（返回 404 IMAGE_NOT_FOUND）。建议生成后立即下载到本地保存，不要把返回的 URL 当作长期唯一副本。

能指定画风吗？ 内置 flat（工业扁平）与 watercolor（水彩手绘）两套，下单前由你来选（Agent 会先问）。这两套之外的细节差异，可用 extra 字段追加描述，如「画面里加一个配电柜」。

付款后还能改画风吗？ 不能。 订单会绑定提交时的画风，付款后带不同画风重试会被服务端拒绝（PAYLOAD_MISMATCH）。请在付款前确认好画风；确需更换只能按新画风重新下单（另行计费）。为降低这种返工，Agent 会在请求前先和你确认画风。

付款有期限吗？ 有。下单后支付二维码/凭证有效期 15 分钟，超时未支付需重新下单。这与图片保存期（30 天）是两个不同的时间概念。

为什么只传 2 条也是 3.00 元？ 因为本服务按次计费：3.00 元是一次调用的价格，与条数无关，1~10 条同价。手上有几条就传几条，不用等攒够 —— 一次调用最多能出 10 张，这个容量按你的实际需要取用即可。

文字会写错吗？ 中文由模型渲染，个别复杂字可能出错。对文字准确性要求高时，建议图片只做配图、文字后期叠加。

生成失败会退费吗？ 单张失败会在 items[].error 标明；整批提交失败会自动退款。

更新日志

v1.1.1

• 🔴 修正一处会造成预期错位的表述：「服务与定价」里原写「每次最多 10 条，输出 10 张图」—— 这与实际行为不符（实际是传几条出几张），会让用户以为"3 元买了 10 张"，只传 3 条时就产生"剩下 7 张哪去了"的疑问。现改为「出图张数 = 提交条数」，并在概览、功能描述、FAQ 三处同步写明
• 新增「服务与定价 · 一次调用买的是什么」说明块 —— 明确 3.00 元买的是一次生成服务、10 条是容量上限而非必达数量、用不满无余额留存
• 删除"每张单价"锚点：原写「用满 10 条即 0.30 元/张」会在对比中把 3 条单衬成"1 元/张"，主动制造损失感。按次计费本就不该按张报价，已删除
• 撤销「条款不足 10 条时，建议攒够一批再下单」 —— 该建议会劝用户延迟付费，与新技能需要尽快转化相冲突。改为「手上有几条就传几条，不用等攒够」
• 新增注意事项第 11 条（面向调用方 Agent）：不得向用户承诺"3 元给 10 张"，并给出正确说法与三种禁用说法 —— 调用方是实际的对话方，此条用于从源头掐掉纠纷
• 新增应用场景「手边只有两三条，也能立刻出图」 —— 把"可以小批量下单"这个灵活性显式写出
• 本次为纯表述修订，计费口径、接口行为、退款规则与 v1.1.0 完全一致，无需变更后端

v1.1.0

• 新增「工作流程 · 第零步：先问用户要哪套画风（不可跳过）」 —— 画风选择从"文档说明"升级为"交互硬指令"。此前只写了有哪些画风，调用方可能直接默认 flat；现在明确要求发起请求前必须先问用户，并给出可直接照抄的话术
• 明确 style 只收英文枚举：新增「用户怎么说 → 你必须传什么」对照表，规定中文「水彩/扁平」必须先转换成 watercolor/flat 再传参，禁止把中文原样当参数值
• 新增 400 BAD_STYLE 异常处理：服务端不再对非法画风静默降级（此前传错值会悄悄回退成 flat 而出图，用户付了钱却拿到不符合要求的画风）。现改为直接拒绝，响应体的 allowed 字段给出合法值列表，且此时尚未产生扣费
• 新增 FAQ「付款后还能改画风吗？」 —— 明确答复"不能"，说明订单绑定提交时的画风（改后重试会返回 PAYLOAD_MISMATCH），并给出"付款前确认、确需更换则重新下单"的处置路径
• 新增 FAQ「付款有期限吗？」 —— 补上此前遗漏的支付时限说明（下单后 15 分钟），并区分"支付时限 15 分钟"与"图片保存 30 天"两个不同的时间概念
• 新增 FAQ「2 条和 10 条价格一样吗？」 —— 明确按次计费、1~10 条同价，并提示"攒够一批再下单更划算"（⚠️ 该提示已于 v1.1.1 撤销，它会把有意向的用户劝去延迟付费；现行口径见 v1.1.1）
• extra 字段增加使用提醒：不要在其中写角色人设（两套画风已各自内置角色，写了会互相打架）

v1.0.2

• 新增「概览」章节，把价格、耗时、出图规格、画风、图片有效期、失败退款六项关键信息前置，缩短「搜到 → 安装」的决策路径
• 补充两套画风的画面说明（文字描述），便于用户在下单前判断是否合用
• 明确出图为服务端图片级并行（默认并发 4），并给出整批耗时预期
• 接口行为与技术承诺与 v1.0.1 保持一致

v1.0.1

• 图片有效期明确为 30 天，并在输出说明、轮询结果、常见问题三处同步提示「请及时下载保存」
• 补充画风说明：flat 适合班前会卡片 / 展板 / 制度上墙，watercolor 适合培训课件 / 公众号推文
• 明确单次上限 10 条（与服务端校验一致），超出需拆批、每批独立计费
• 补充元数据：标签、中文摘要、显示名称

v1.0.0 — 首次发布。