baoyu-article-illustrator

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Article Illustrator

文章插图生成器

Analyze articles, identify illustration positions, generate images with Type × Style consistency.

分析文章内容，识别需要插图的位置，生成类型与风格统一的图片。

Two Dimensions

二维维度

Dimension	Controls	Examples
Type	Information structure, layout	infographic, scene, flowchart, comparison, framework, timeline
Style	Visual aesthetics, mood	notion, warm, minimal, blueprint, watercolor, elegant

Type × Style can be freely combined. Example:

--type infographic --style blueprint

维度	控制方向	示例
Type（类型）	信息结构、布局	信息图、场景图、流程图、对比图、框架图、时间线
Style（风格）	视觉美学、氛围	Notion风、温暖风、极简风、蓝图风、水彩风、典雅风

类型与风格可自由组合。示例：

--type infographic --style blueprint

Illustration Purpose

插图用途

Auto-detected during content analysis. Influences type/style recommendations.

Purpose	Description	Best Types
information	Help understand abstract concepts	infographic, flowchart, comparison
visualization	Turn abstract ideas into concrete visuals	framework, comparison, infographic
imagination	Create atmosphere, spark imagination	scene, timeline

在内容分析过程中自动识别，会影响类型/风格的推荐。

用途	描述	适配类型
信息传递	帮助理解抽象概念	信息图、流程图、对比图
视觉化呈现	将抽象想法转化为具象视觉内容	框架图、对比图、信息图
氛围营造	创造氛围，激发想象	场景图、时间线

Type Gallery

类型库

Type	Best For
`infographic`	Data, metrics, technical articles
`scene`	Narratives, personal stories, emotional content
`flowchart`	Tutorials, workflows, processes
`comparison`	Side-by-side, before/after, options
`framework`	Methodologies, models, architecture
`timeline`	History, progress, evolution

类型	适用场景
`infographic`	数据、指标、技术类文章
`scene`	叙事文、个人故事、情感类内容
`flowchart`	教程、工作流、流程说明
`comparison`	并列对比、前后对比、选项对比
`framework`	方法论、模型、架构说明
`timeline`	历史、进展、演化过程

Styles

风格详情

See references/styles.md for:

Core Styles: Simplified tier for quick selection (vector, minimal-flat, sci-fi, hand-drawn, editorial, scene)
Style Gallery: Full 20+ style options with descriptions
Auto Selection: Content signals → Type/Style recommendations
Compatibility Matrix: Type × Style combinations

查看 references/styles.md 获取以下内容：

核心风格：简化分类，便于快速选择（矢量风、极简扁平风、科幻风、手绘风、编辑风、场景风）
风格库：20+种完整风格选项及说明
自动选择：根据内容特征推荐类型/风格
兼容性矩阵：类型与风格的组合适配表

Workflow

工作流

Progress:
- [ ] Step 1: Pre-check
  - [ ] 1.5 Load preferences (EXTEND.md) ⛔ BLOCKING
  - [ ] 1.0 Reference images ⚠️ (if provided)
  - [ ] 1.2-1.4 Config questions (1 AskUserQuestion, max 4 Qs)
- [ ] Step 2: Setup & Analyze
- [ ] Step 3: Confirm Settings (1 AskUserQuestion, max 4 Qs)
  - [ ] Q1: Type ⚠️
  - [ ] Q2: Density ⚠️ MUST ASK
  - [ ] Q3: Style ⚠️
- [ ] Step 4: Generate Outline
- [ ] Step 5: Generate Images
- [ ] Step 6: Finalize

Progress:
- [ ] Step 1: Pre-check
  - [ ] 1.5 Load preferences (EXTEND.md) ⛔ BLOCKING
  - [ ] 1.0 Reference images ⚠️ (if provided)
  - [ ] 1.2-1.4 Config questions (1 AskUserQuestion, max 4 Qs)
- [ ] Step 2: Setup & Analyze
- [ ] Step 3: Confirm Settings (1 AskUserQuestion, max 4 Qs)
  - [ ] Q1: Type ⚠️
  - [ ] Q2: Density ⚠️ MUST ASK
  - [ ] Q3: Style ⚠️
- [ ] Step 4: Generate Outline
- [ ] Step 5: Generate Images
- [ ] Step 6: Finalize

Step 1: Pre-check

Step 1: 预检查

1.5 Load Preferences (EXTEND.md) ⛔ BLOCKING

CRITICAL: If EXTEND.md not found, MUST complete first-time setup before ANY other steps.

bash

test -f .baoyu-skills/baoyu-article-illustrator/EXTEND.md && echo "project"
test -f "$HOME/.baoyu-skills/baoyu-article-illustrator/EXTEND.md" && echo "user"

Result	Action
Found	Read, parse, display summary → Continue
Not found	⛔ Run first-time setup (references/config/first-time-setup.md)

Supports: Watermark | Preferred type/style | Custom styles | Language | Output directory

1.0-1.4: Handle reference images, determine input type, ask config questions.

Full procedures: references/workflow.md

1.5 加载偏好设置（EXTEND.md） ⛔ 阻塞项

关键提示：如果未找到EXTEND.md文件，必须先完成首次设置，才能进行其他步骤。

bash

test -f .baoyu-skills/baoyu-article-illustrator/EXTEND.md && echo "project"
test -f "$HOME/.baoyu-skills/baoyu-article-illustrator/EXTEND.md" && echo "user"

结果	操作
找到文件	读取、解析并显示摘要 → 继续执行
未找到文件	⛔ 执行首次设置（references/config/first-time-setup.md）

支持配置：水印 | 偏好类型/风格 | 自定义风格 | 语言 | 输出目录

1.0-1.4：处理参考图片，确定输入类型，询问配置问题。

完整流程：references/workflow.md

Step 2: Setup & Analyze

Step 2: 配置与分析

Analysis	Description
Content type	Technical / Tutorial / Methodology / Narrative
Illustration purpose	information / visualization / imagination
Core arguments	2-5 main points to visualize
Visual opportunities	Positions where illustrations add value

CRITICAL: If article uses metaphors, do NOT illustrate literally. Visualize the underlying concept.

Full procedures: references/workflow.md

分析项	描述
内容类型	技术类 / 教程类 / 方法论类 / 叙事类
插图用途	信息传递 / 视觉化呈现 / 氛围营造
核心论点	2-5个需要视觉化的核心要点
视觉优化点	插入插图能提升内容价值的位置

关键提示：如果文章使用隐喻手法，请勿对隐喻内容进行字面插图，需视觉化其背后的核心概念。

完整流程：references/workflow.md

Step 3: Confirm Settings ⚠️

Step 3: 确认设置 ⚠️

Do NOT skip. Use ONE AskUserQuestion call with max 4 questions. Q1, Q2, Q3 are ALL REQUIRED.

Question	Options
Q1: Type ⚠️	[Recommended], infographic, scene, flowchart, comparison, framework, timeline, mixed
Q2: Density ⚠️	minimal (1-2), balanced (3-5), per-section (Recommended), rich (6+)
Q3: Style ⚠️	[Recommended], minimal-flat, sci-fi, hand-drawn, editorial, scene, Other
Q4: Language	When article language ≠ EXTEND.md setting

Full procedures: references/workflow.md

不可跳过：通过一次AskUserQuestion调用最多提出4个问题。Q1、Q2、Q3为必填问题。

问题	选项
Q1: 类型 ⚠️	[推荐选项], infographic, scene, flowchart, comparison, framework, timeline, mixed
Q2: 密度 ⚠️	minimal (1-2), balanced (3-5), per-section (推荐), rich (6+)
Q3: 风格 ⚠️	[推荐选项], minimal-flat, sci-fi, hand-drawn, editorial, scene, Other
Q4: 语言	当文章语言与EXTEND.md设置不一致时询问

完整流程：references/workflow.md

Step 4: Generate Outline

Step 4: 生成大纲

Save as

outline.md

with frontmatter (type, density, style, image_count, references) and illustration entries:

yaml

undefined

将大纲保存为

outline.md

，包含前置元数据（类型、密度、风格、图片数量、参考资料）和插图条目：

yaml

undefined

Illustration 1

Position: [section] / [paragraph] Purpose: [why this helps] Visual Content: [what to show] Filename: 01-infographic-concept-name.png


Full template: [references/workflow.md](references/workflow.md#step-4-generate-outline)

---

Position: [section] / [paragraph] Purpose: [why this helps] Visual Content: [what to show] Filename: 01-infographic-concept-name.png


完整模板：[references/workflow.md](references/workflow.md#step-4-generate-outline)

---

Step 5: Generate Images

Step 5: 生成图片

Create Prompts: Follow references/prompt-construction.md
Select Generation Skill: Check available skills
Process References: Handle
```
direct
```
/
```
style
```
/
```
palette
```
usage
Apply Watermark: If enabled in EXTEND.md
Generate: Sequential, retry once on failure

Full procedures: references/workflow.md

创建提示词：遵循 references/prompt-construction.md
选择生成工具：检查可用技能
处理参考图片：处理
```
direct
```
/
```
style
```
/
```
palette
```
三种使用方式
添加水印：如果EXTEND.md中启用该功能
生成图片：按顺序生成，失败时重试一次

完整流程：references/workflow.md

Step 6: Finalize

Step 6: 最终整理

Update Article: Insert

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

after corresponding paragraphs.

Output Summary:

Article Illustration Complete!
Article: [path] | Type: [type] | Density: [level] | Style: [style]
Images: X/N generated
Positions:
- 01-xxx.png → After "[Section]"

更新文章：在对应段落之后插入

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

。

输出摘要：

Article Illustration Complete!
Article: [path] | Type: [type] | Density: [level] | Style: [style]
Images: X/N generated
Positions:
- 01-xxx.png → After "[Section]"

Output Directory

输出目录结构

illustrations/{topic-slug}/
├── source-{slug}.{ext}
├── references/                    # Only if references provided
│   └── NN-ref-{slug}.png
├── outline.md
├── prompts/
│   └── illustration-{slug}.md
└── NN-{type}-{slug}.png

Slug: 2-4 word topic in kebab-case. Conflict: Append

-YYYYMMDD-HHMMSS

if exists.

illustrations/{topic-slug}/
├── source-{slug}.{ext}
├── references/                    # Only if references provided
│   └── NN-ref-{slug}.png
├── outline.md
├── prompts/
│   └── illustration-{slug}.md
└── NN-{type}-{slug}.png

Slug：2-4个单词的主题，采用短横线分隔格式（kebab-case）。 冲突处理：如果目录已存在，追加

-YYYYMMDD-HHMMSS

后缀。

Modification

修改操作

Action	Steps
Edit	Update prompt file FIRST → Regenerate → Update reference
Add	Identify position → Create prompt → Generate → Update outline → Insert
Delete	Delete files → Remove reference → Update outline

操作	步骤
编辑	先更新提示词文件 → 重新生成图片 → 更新引用
添加	识别位置 → 创建提示词 → 生成图片 → 更新大纲 → 插入到文章
删除	删除文件 → 移除引用 → 更新大纲

References

参考资料

File	Content
references/workflow.md	Detailed workflow procedures
references/usage.md	Command syntax and options
references/styles.md	Style gallery & compatibility
references/prompt-construction.md	Prompt templates
`references/styles/<style>.md`	Full style specifications
`references/config/preferences-schema.md`	EXTEND.md schema
`references/config/first-time-setup.md`	First-time setup flow

文件	内容
references/workflow.md	详细工作流流程
references/usage.md	命令语法与选项
references/styles.md	风格库与兼容性说明
references/prompt-construction.md	提示词模板
`references/styles/<style>.md`	完整风格规格
`references/config/preferences-schema.md`	EXTEND.md 配置 schema
`references/config/first-time-setup.md`	首次设置流程