配图

路由

完整长文从选题到发布 → aws-wechat-article-main；图片消息/九宫格等多图推送 → aws-wechat-sticker。

读取文章中的配图标记，按 Type × Style 体系生成图片。专注于长文配图，贴图请用 sticker。

脚本目录

Agent 执行：确定本 SKILL.md 所在目录为

{baseDir}

skills/aws-wechat-article-images/

scripts/image_create.py

.aws-article/config.yaml

image_model

aws.env

IMAGE_MODEL_API_KEY

配置检查 ⛔

任何操作执行前，必须按 首次引导 执行其中的 「检测顺序」。检测通过后才能进行以下操作（或用户明确书面确认「本次不检查」）：

从选题到发布的前置规则见 aws-wechat-article-main/SKILL.md；本 skill 只描述配图步骤。

图片模型：

image_model

provider

base_url

model

default_size

default_quality

config.yaml

IMAGE_MODEL_API_KEY

aws.env

.aws-article/env.example.yaml

交互约定：可提示用户上述项是否已填；一条龙下通常已通过

validate_env.py

Type × Style 体系

Type（画面构成）× Style（视觉风格）自由组合。

完整风格库、兼容矩阵、预设组合、prompt 模板：见 shared/image-styles/ 目录。

工作流

配图进度：
- [ ] 第1步：环境检查 + 本篇约束与文章
- [ ] 第2步：解析配图标记
- [ ] 第3步：确定风格
- [ ] 第4步：生成配图方案
- [ ] 第5步：展示方案并等待确认 ⛔
- [ ] 第6步：生成图片（**脚本失败时**见同节「调用失败」分支，勿静默吞掉报错）
- [ ] 第7步：插入文章

第1步：环境检查 + 本篇约束与文章

• 全局：读

  .aws-article/config.yaml

  —

  cover_aspect

  、

  cover_style

  、

  image_density

  、

  caption_style

  、

  default_image_style

  、

  multi_image_count

  、

  tone

  等以之为准（完整字段见 articlescreening-schema.md 与

  config.example.yaml

  ）。
• 本篇：若同目录有

  article.yaml

  ，可读取

  cover_image

  等本篇字段；与

  config.yaml

  同名字段时本篇优先（与写稿侧合并规则一致）。
• 读取

  article.md

  （或当前流程规定的正文来源）。

第2步：解析配图标记

提取所有

![类型：描述](placeholder)

实证

.aws-article/assets/

可用素材库：

• .aws-article/assets/screenshots/

  — 可直接复用的产品/系统截图。优先用于「实证」「界面」类图片；如含敏感信息请打码后使用。

第3步：确定风格

风格加载优先级：

1. 用户指定（「用水彩风」）

2. config.yaml

   的

   default_image_style

   （若有）

3. .aws-article/presets/image-styles/

   下的自定义风格
4. fallback：根据正文与

   config.yaml

   的

   tone

   自动推荐（规则见 auto-selection.md），默认「扁平矢量」

全文统一风格。完整风格库：shared/image-styles/styles.md

第4步：生成配图方案

为每张图生成方案（类型、风格、prompt 要点）。

图片内文字：画面中出现的文字必须为中文。在 prompt 里直接写出要显示的中文文案（如「传统对话AI」「OpenClaw」），禁止只写 “labels in Chinese” 或 “Chinese or English OK”，否则模型会生成英文。

Prompt 构建：shared/image-styles/prompt-construction.md

第5步：展示方案并等待确认 ⛔

第6步：生成图片

生成方式（优先级）：

1. 优先：调用专用生图 API（

   scripts/image_create.py

   ）— 依赖

   config.yaml

   的

   image_model

   +

   aws.env

   的

   IMAGE_MODEL_API_KEY

2. 降级：当前 Agent 多模态 / 仅出 prompts — 仅当环境未就绪、用户接受 main「本次例外」、或已按本节下方「调用失败」表格处理（网络重试后仍失败等）时

必须告知用户当前使用的方式：

• 已配置且调用脚本 →

  ℹ️ 使用 image_create.py 调用专用生图模型（{model}）

• Agent 生图 / 仅 prompts →

  ℹ️ 本次未走 image_create.py（原因：…）

⛔ 未调用专用 API 时的终点：只做到第 4 步（或第 5 步）。产出

imgs/prompts/*.md

imgs/README.md

aws.env

config.yaml

image_create.py batch

article.html

调用专用 API 时（在仓库根执行，

{baseDir}

imgs/

python {baseDir}/scripts/image_create.py batch drafts/YYYYMMDD-slug/imgs/prompts/ -o drafts/YYYYMMDD-slug/imgs/

单张：

python {baseDir}/scripts/image_create.py generate imgs/prompts/01-cover.md -o imgs/01-cover.png

连通性自检：

python {baseDir}/scripts/image_create.py test

图片规格：references/specs.md

image_create.py

调用失败时（智能体必选分支）

只要执行了

image_create.py

运行脚本后须把终端 stderr 中的具体报错摘要给用户（含

❌

【配置/认证】

网络错误（可重试）

URLError

网络错误（可重试）

【配置/认证】

config.yaml

image_model

aws.env

IMAGE_MODEL_API_KEY

【请求参数】

config.yaml

禁止：配置明显错误时静默改用 Agent 却不说明；网络降级后不告知「本次未走专用生图」。

第7步：插入文章

仅当已生成图片时执行：替换 placeholder 为实际图片路径，输出到

imgs/

修复 HTML 的触发条件：仅当在

article.html

href="placeholder"

<a>

<img>

过程文件

article.md

.aws-article/config.yaml

article.yaml

imgs/