文章插图生成器（Article Illustrator）

分析文章内容，识别最优插图位置，并基于「类型 × 风格」一致性系统生成图像。

安装

OpenClaw / Moltbot / Clawbot

npx clawhub@latest install article-illustrator

严禁事项

• 切勿将隐喻进行字面化视觉呈现（例如：若文章中写“电锯切西瓜”，应可视化其背后的核心概念，而非字面场景）
• 切勿生成与内容无实质关联的通用装饰性图像
• 切勿跳过设置确认步骤（第 3 步）
• 切勿在未与用户确认类型（type）、密度（density）和风格（style）前开始生成
• 切勿在未基于内容需求逐一定位并说明每处插图必要性的前提下创建插图

两个核心维度

类型与风格可自由组合：例如 --type infographic --style blueprint

类型选择指南

风格选择指南

完整风格规范及兼容性矩阵详见：references/styles.md

基于内容的自动类型/风格推荐

工作流程

第 1 步：预检

1. 确定输入类型 —— 文件路径或粘贴文本
2. 确定输出目录 —— 检查用户偏好设置或向用户确认：
   • {article-dir}/ —— 与原文档同目录
   • {article-dir}/illustrations/ —— 插图子目录（推荐）
   • illustrations/{topic-slug}/ —— 独立目录
3. 检查已有图像 —— 若已存在图像，询问用户：补充 / 覆盖 / 重新生成
4. 确认文章更新方式（仅限文件输入）—— 更新原文档，或创建副本 {name}-illustrated.md
5. 加载偏好设置 —— 检查项目根目录或用户主目录下是否存在 EXTEND.md

第 2 步：内容分析

必须插图化的内容：核心论点（强制）、抽象概念、数据对比、流程/工作流。

应跳过的内容：字面化隐喻、纯装饰性场景、通用型插图。

第 3 步：设置确认（必需）

通过一次调用完成结构化提问（共 3–4 个问题）：

• Q1 — 类型（Type）：给出推荐选项 + 其他可行备选
• Q2 — 密度（Density）：极简（1–2 张）、均衡（3–5 张，推荐）、丰富（6+ 张）
• Q3 — 风格（Style）：基于类型/内容兼容性矩阵推荐
• Q4 — 语言（Language）（仅当原文语言与用户语言不一致时触发）

第 4 步：生成插图大纲

保存为 outline.md，含 YAML 前置元数据（type、density、style、count），以及每张插图的详细信息：位置、用途、视觉内容描述、文件名。

第 5 步：生成图像

1. 按 references/prompt-construction.md 规范构建提示词（prompt）
2. 将提示词保存至 prompts/illustration-{slug}.md
3. 按顺序逐张生成，每张完成后报告进度
4. 若某张失败：重试一次；若仍失败，则记录日志并继续后续生成

第 6 步：终稿整合

在对应段落后插入图像引用：

![描述](illustrations/{slug}/NN-{type}-{slug}.png)

输出汇总报告，包含文章路径、所用设置、插图总数及各插图插入位置。

输出目录结构

illustrations/{topic-slug}/
├── source-{slug}.{ext}
├── outline.md
├── prompts/
│   └── illustration-{slug}.md
└── NN-{type}-{slug}.png

提示词构建原则

高质量插图提示词必须包含以下六项要素：

1. 优先明确版式结构 —— 描述构图、区域划分、视觉流向
2. 嵌入具体数据/标签 —— 使用文章中真实出现的数值、术语
3. 定义视觉关系 —— 各元素之间的连接、层级、逻辑关系
4. 语义化配色 —— 基于意义选择颜色（如红色=警告、绿色=高效）
5. 风格化特征 —— 线条处理、纹理质感、整体氛围
6. 指定宽高比 —— 末尾注明比例及复杂度等级

禁止事项：模糊描述、字面化隐喻、缺失关键标签、添加通用装饰元素。

各类型完整提示词模板详见：references/prompt-construction.md

类型 × 风格兼容性矩阵

++ 高度推荐 | + 兼容 | - 不推荐

使用示例

# 自动选择类型与风格
illustrate path/to/article.md

# 指定类型
illustrate path/to/article.md --type infographic

# 指定类型与风格
illustrate path/to/article.md --type flowchart --style notion

# 指定密度
illustrate path/to/article.md --density rich

扩展支持

通过 EXTEND.md 文件实现自定义配置：

• 项目级配置：.article-illustrator/EXTEND.md
• 用户级配置：$HOME/.config/article-illustrator/EXTEND.md

支持配置项：水印、默认类型/风格、自定义风格、语言、输出目录等。

修改操作

参考文档