article-illustrator

文章智能配图

分析文章结构与内容，识别需要视觉辅助的位置，生成风格灵活的配图。

任务目标

• 分析文章结构和内容，逐段识别需要配图的位置
• 为每个配图位置生成详细的配图计划和提示词
• 使用图像生成能力创建符合风格规范的插画
• 将图片插入到文章对应位置

触发条件

用户明确要求：

• "给文章配图"
• "为文章生成插图"
• "添加配图"
• "为这篇文章生成一些图片"

工作流程

步骤一：获取文章内容

根据用户提供的信息获取文章：

• 本地路径：读取指定 Markdown 文件
• URL：自动下载 Markdown 内容到临时位置

步骤二：分析配图需求

逐段分析文章，识别需要配图的位置。

配图的三种作用：

1. 信息补充：帮助理解抽象概念（如"小步迭代"用滑板→自行车→汽车演进图）
2. 概念具象化：将抽象观点转化为具体画面，让读者一眼就懂
3. 引导想象：营造氛围、激发联想，增强阅读体验

适合配图的内容：

• 抽象概念需要视觉化
• 流程/步骤需要图示
• 对比关系需要可视化
• 核心观点需要强化
• 场景描述需要引导想象
• 情绪/氛围需要烘托

不需要配图的内容：

• 已经很直观的描述（如代码示例、具体数字）
• 简单的列表枚举
• 引用的原话

配图数量（按文章长度）：

• 每个主要章节至少考虑 1 张，优先选择核心观点和抽象概念
• 开头/结尾可酌情增加 1 张（如需要氛围烘托）
• 原则：宁多勿少，视觉内容能显著提升阅读体验

步骤三：生成配图计划

为每个配图位置创建结构化计划：

**配图 1**

**插入位置**：[章节名称] / [段落描述]
**配图目的**：[为什么这里需要配图]
**视觉内容**：[图片应该展示什么]
**文件名**：illustration-[slug].png

文件命名规则：

• 格式：illustration-[slug].png
• slug 使用有意义的英文描述，符合规范（小写字母、数字、连字符）
• 示例：illustration-product-evolution.png、illustration-ai-vs-human.png

步骤四：生成配图

根据配图计划，为每张图片生成详细的视觉描述并创建图片。

生成要求：

• 按顺序生成每张图片，输出进度："已生成 X/N 张"
• 根据内容选择合适的风格（参考 references/style-guide.md）
• 每张图片包含：画面主体、布局、配色、文字（如有）

图片属性：

• 比例：16:9 横向
• 风格：根据内容选择极简扁平矢量、科幻未来感、手绘涂鸦风等
• 配色：遵循默认色彩方案或风格变体方案

步骤五：更新文章

将生成的图片插入到文章对应位置。

插入规则：

• 图片插入到对应段落之后
• 图片前后各留一个空行
• 使用 Markdown 语法：![配图描述](imgs/illustration-[slug].png)
• alt 文本使用简洁的中文描述（5-10 字）

图片保存位置：

• 在文章所在目录创建 imgs/ 子目录
• 所有图片保存在该目录中

步骤六：输出汇总

完成所有配图后，输出汇总信息：

配图完成！

文章：[文章路径]
生成数量：X/N 张成功

配图位置：
- illustration-[slug].png → [章节/段落位置]

[如有失败]
失败项：
- illustration-[slug].png：[失败原因]

配图策略

识别关键位置：

• 文章开头：是否有需要氛围烘托的引言
• 每个章节：核心概念是否抽象
• 流程步骤：是否需要可视化
• 对比内容：是否需要图示
• 总结部分：是否需要强化记忆

优先级排序：

1. 抽象概念（优先级最高）
2. 核心观点
3. 流程/步骤
4. 对比关系
5. 氛围烘托

风格选择原则：

• AI、前沿技术 → 科幻未来感
• 轻松、思考类 → 手绘涂鸦风
• 流程、对比、数据 → 信息图表风
• 叙事、想象类 → 场景插画风
• 其他 → 极简扁平矢量（默认）

资源索引

• 视觉风格规范：见 references/style-guide.md
• 术语对照表：见 references/terminology.md