baoyu-article-illustrator

文章插图工具

分析文章，确定插图位置，并生成类型 × 风格一致的图片。

用法

# Auto-select type and style based on content
/baoyu-article-illustrator path/to/article.md

# Specify type
/baoyu-article-illustrator path/to/article.md --type infographic

# Specify style
/baoyu-article-illustrator path/to/article.md --style blueprint

# Combine type and style
/baoyu-article-illustrator path/to/article.md --type flowchart --style notion

# Specify density
/baoyu-article-illustrator path/to/article.md --density rich

# Direct content input
/baoyu-article-illustrator
[paste content]

选项

选项	说明
--type <name>	插图类型（参见类型库）
--style <name>	视觉风格（参见风格库）
--density <level>	图片数量：minimal / balanced / rich

两个维度

维度	控制内容	示例
类型	信息结构、内容布局	信息图、场景、流程图、对比、框架、时间线
风格	视觉美感、色彩、氛围	notion、warm、minimal、blueprint、watercolor、elegant

类型 × 风格可自由组合。例如：--type infographic --style blueprint 会创建具有示意图美感的技术数据可视化。

类型库

类型	说明	适用场景
infographic	数据可视化、图表、指标	技术文章、数据分析、对比
scene	氛围插图、情绪渲染	叙事文章、个人故事、情感内容
flowchart	流程图、步骤可视化	教程、工作流、决策树
comparison	并排展示、前后对比	产品对比、选项评估
framework	概念图、关系图	方法论、模型、架构设计
timeline	按时间顺序展示进展	历史、项目进展、演变

密度选项

密度	数量	说明
minimal	1-2	仅展示核心概念
balanced（默认）	3-5	覆盖主要章节
rich	6+	提供丰富的视觉支持

风格库

风格	说明	适用场景
notion（默认）	极简手绘线稿	知识分享、SaaS、效率提升
elegant	精致、雅致	商业、思想领袖内容
warm	友好、亲切	个人成长、生活方式、教育
minimal	极简干净、禅意	哲学、极简主义、核心概念
blueprint	技术示意图	架构、系统设计、工程
watercolor	柔和的艺术风格，富有自然暖意	生活方式、旅行、创意
editorial	杂志风格信息图	科技解读、新闻报道
scientific	严谨精确的学术图表	生物学、化学、技术研究

完整风格规范：references/styles/<style>.md

类型 × 风格兼容性

	notion	warm	minimal	blueprint	watercolor	elegant	editorial	scientific
infographic	✓✓	✓	✓✓	✓✓	✓	✓✓	✓✓	✓✓
scene	✓	✓✓	✓	✗	✓✓	✓	✓	✗
flowchart	✓✓	✓	✓	✓✓	✗	✓	✓✓	✓
comparison	✓✓	✓	✓✓	✓	✓	✓✓	✓✓	✓
framework	✓✓	✓	✓✓	✓✓	✗	✓✓	✓	✓✓
timeline	✓✓	✓	✓	✓	✓✓	✓✓	✓✓	✓

✓✓ = 强烈推荐 | ✓ = 兼容 | ✗ = 不推荐

自动选择

内容信号	推荐类型	推荐风格
API、指标、数据、对比、数字	infographic	blueprint、notion
故事、情感、旅程、体验、个人	scene	warm、watercolor
操作指南、步骤、工作流、流程、教程	flowchart	notion、minimal
对比、优缺点、前后对比、替代方案	comparison	notion、elegant
框架、模型、架构、原则	framework	blueprint、notion
历史、时间线、进展、演变	timeline	elegant、warm

输出目录

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

Slug：提取 2-4 个词的主题，并使用 kebab-case。 冲突：若已存在，则追加 -YYYYMMDD-HHMMSS。

工作流

进度

- [ ] Step 1: Setup & Analyze
- [ ] Step 2: Confirm Settings ⚠️ REQUIRED
- [ ] Step 3: Generate Outline
- [ ] Step 4: Generate Images
- [ ] Step 5: Finalize

第 1 步：设置与分析

1.1 加载偏好设置（EXTEND.md）

使用 Bash 检查 EXTEND.md 是否存在（按优先级排序）：

# Check project-level first
test -f .baoyu-skills/baoyu-article-illustrator/EXTEND.md && echo "project"

# Then user-level (cross-platform: $HOME works on macOS/Linux/WSL)
test -f "$HOME/.baoyu-skills/baoyu-article-illustrator/EXTEND.md" && echo "user"

┌──────────────────────────────────────────────────────────┬───────────────────┐ │ 路径 │ 位置 │ ├──────────────────────────────────────────────────────────┼───────────────────┤ │ .baoyu-skills/baoyu-article-illustrator/EXTEND.md │ 项目目录 │ ├──────────────────────────────────────────────────────────┼───────────────────┤ │ $HOME/.baoyu-skills/baoyu-article-illustrator/EXTEND.md │ 用户主目录 │ └──────────────────────────────────────────────────────────┴───────────────────┘

┌───────────┬───────────────────────────────────────────────────────────────────────────┐ │ 结果 │ 操作 │ ├───────────┼───────────────────────────────────────────────────────────────────────────┤ │ 找到 │ 读取、解析并显示摘要 │ ├───────────┼───────────────────────────────────────────────────────────────────────────┤ │ 未找到 │ 使用 AskUserQuestion 询问用户（参见 references/config/first-time-setup.md） │ └───────────┴───────────────────────────────────────────────────────────────────────────┘

EXTEND.md 支持：水印 | 首选类型/风格 | 自定义风格定义 | 语言偏好

架构：references/config/preferences-schema.md

1.2 分析内容

阅读文章、检测语言并对内容进行分类。

分析项	描述
内容类型	技术 / 教程 / 方法论 / 叙事
核心论点	必须可视化的 2-5 个要点
可视化机会	插图能发挥作用的位置
推荐类型	根据内容特征确定
推荐密度	根据文章长度和复杂度确定

1.3 提取核心论点

提取必须可视化的 2-5 个核心论点：

• 主要论点
• 读者需要了解的关键概念
• 文中的比较/对比
• 提出的框架/模型

关键：如果文章使用了比喻（例如“电锯切西瓜”），不要按字面内容绘制。应将背后的概念可视化。

1.4 确定位置

需要绘制的内容：

• 核心论点（必需）
• 需要可视化的抽象概念
• 数据比较、指标
• 流程、工作流

不需要绘制的内容：

• 按字面内容描绘比喻
• 没有信息的装饰性场景
• 通用插图

第 2 步：确认设置 ⚠️

不得跳过。 在一次调用中使用 AskUserQuestion 提出 3-4 个问题。

问题 1：插图类型

根据内容分析，推荐类型：

• [根据内容特征推荐的类型]（推荐）
• infographic - 数据可视化、图表
• scene - 氛围、情绪呈现
• flowchart - 流程、步骤
• comparison - 并列对比
• framework - 概念关系
• timeline - 时间顺序
• mixed - 组合多种类型

问题 2：密度

• minimal（1-2 张图）- 仅核心概念
• balanced（3-5 张图）（推荐）- 主要章节
• rich（6 张以上）- 全面的视觉辅助

问题 3：风格

根据推荐类型，建议兼容的风格（参见 Type × Style Compatibility 矩阵）：

• [与推荐类型最兼容的风格]（推荐）
• [其他高度兼容的风格：矩阵中的 ✓✓]
• [兼容的风格：矩阵中的 ✓]

问题 4（仅当源语言 ≠ 用户语言时）：

• 语言：源语言 / 用户语言

第 3 步：生成大纲

根据确认的类型 + 密度 + 风格，生成插图大纲。

大纲格式（outline.md）：

---
type: infographic
density: balanced
style: blueprint
image_count: 4
---

## Illustration 1

**Position**: [section] / [paragraph]
**Purpose**: [why this illustration helps]
**Visual Content**: [what to show]
**Type Application**: [how type applies here]
**Filename**: 01-infographic-concept-name.png

## Illustration 2
...

大纲要求：

• 每个插图位置都必须有内容需求作为依据
• 所有插图均须一致地应用同一种类型
• 视觉描述须体现风格特征
• 数量须符合所选密度

步骤 4：生成图像

4.1 创建提示词

遵循下方的提示词构建原则。将每个提示词保存为 prompts/illustration-{slug}.md。

4.2 选择生成技能

检查可用的图像生成技能。如果有多个，请让用户选择。

4.3 添加水印（如果偏好设置中已启用）

在提示词中添加：Include a subtle watermark "[content]" positioned at [position] with approximately [opacity*100]% visibility.

4.4 生成

1. 按顺序生成
2. 每生成一张后，显示：“已生成 X/N”
3. 失败时：自动重试一次，然后记录并继续

步骤 5：完成

5.1 更新文章

插入到对应段落之后：

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

替代文本：用文章所用语言简洁描述图像。

5.2 输出摘要

Article Illustration Complete!

Article: [path]
Type: [type name]
Density: [minimal/balanced/rich]
Style: [style name]
Location: [directory path]
Images: X/N generated

Positions:
- 01-infographic-xxx.png → After "[Section]"
- 02-infographic-yyy.png → After "[Section]"

[If failures]
Failed:
- NN-type-zzz.png: [reason]

提示词构建

原则

好的提示词必须包含：

1. 布局结构优先：描述构图、区域和流向
2. 具体数据/标签：使用文章中的实际数字和术语
3. 视觉关系：说明各元素如何关联
4. 语义色彩：根据含义选择颜色（红色＝警告，绿色＝高效）
5. 风格特征：线条处理、纹理、氛围
6. 宽高比：以宽高比和复杂度级别结尾

特定类型的提示词

信息图：

[Title] - Data Visualization

Layout: [grid/radial/hierarchical]

ZONES:
- Zone 1: [data point with specific values]
- Zone 2: [comparison with metrics]
- Zone 3: [summary/conclusion]

LABELS: [specific numbers, percentages, terms from article]
COLORS: [semantic color mapping]
STYLE: [style characteristics]
ASPECT: 16:9

场景：

[Title] - Atmospheric Scene

FOCAL POINT: [main subject]
ATMOSPHERE: [lighting, mood, environment]
MOOD: [emotion to convey]
COLOR TEMPERATURE: [warm/cool/neutral]
STYLE: [style characteristics]
ASPECT: 16:9

流程图：

[Title] - Process Flow

Layout: [left-right/top-down/circular]

STEPS:
1. [Step name] - [brief description]
2. [Step name] - [brief description]
...

CONNECTIONS: [arrow types, decision points]
STYLE: [style characteristics]
ASPECT: 16:9

对比图：

[Title] - Comparison View

LEFT SIDE - [Option A]:
- [Point 1]
- [Point 2]

RIGHT SIDE - [Option B]:
- [Point 1]
- [Point 2]

DIVIDER: [visual separator]
STYLE: [style characteristics]
ASPECT: 16:9

框架：

[Title] - Conceptual Framework

STRUCTURE: [hierarchical/network/matrix]

NODES:
- [Concept 1] - [role]
- [Concept 2] - [role]

RELATIONSHIPS: [how nodes connect]
STYLE: [style characteristics]
ASPECT: 16:9

时间线：

[Title] - Chronological View

DIRECTION: [horizontal/vertical]

EVENTS:
- [Date/Period 1]: [milestone]
- [Date/Period 2]: [milestone]

MARKERS: [visual indicators]
STYLE: [style characteristics]
ASPECT: 16:9

应避免的内容

• 含糊的描述（“一张好看的图”）
• 对隐喻进行字面化的插图呈现
• 缺少具体标签/注释
• 通用装饰元素

修改

操作	步骤
编辑	更新提示词 → 重新生成 → 更新引用
添加	确定位置 → 创建提示词 → 生成 → 更新大纲 → 插入引用
删除	删除文件 → 移除引用 → 更新大纲

参考资料

文件	内容
references/styles.md	风格库和兼容性矩阵
references/styles/<style>.md	完整的风格规范
references/config/preferences-schema.md	EXTEND.md 架构
references/config/first-time-setup.md	首次设置流程

扩展支持

通过 EXTEND.md 自定义配置。路径和支持的选项请参见步骤 1.1。