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.

分析文章内容，识别插图位置，生成Type与Style统一的图片。

Two Dimensions

二维维度

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

Combine freely:

--type infographic --style blueprint

维度	控制项	示例
Type	信息结构	infographic, scene, flowchart, comparison, framework, timeline
Style	视觉美学	notion, warm, minimal, blueprint, watercolor, elegant

自由组合：

--type infographic --style blueprint

Types

类型

Type	Best For
`infographic`	Data, metrics, technical
`scene`	Narratives, emotional
`flowchart`	Processes, workflows
`comparison`	Side-by-side, options
`framework`	Models, architecture
`timeline`	History, evolution

类型	适用场景
`infographic`	数据、指标、技术类内容
`scene`	叙事、情感类内容
`flowchart`	流程、工作流类内容
`comparison`	对比、选项类内容
`framework`	模型、架构类内容
`timeline`	历史、演进类内容

Styles

风格

See references/styles.md for Core Styles, full gallery, and Type × Style compatibility.

核心风格、完整风格图库及Type×Style兼容性说明，请查看references/styles.md。

Workflow

工作流程

- [ ] Step 1: Pre-check (EXTEND.md, references, config)
- [ ] Step 2: Analyze content
- [ ] Step 3: Confirm settings (AskUserQuestion)
- [ ] Step 4: Generate outline
- [ ] Step 5: Generate images
- [ ] Step 6: Finalize

- [ ] Step 1: Pre-check (EXTEND.md, references, config)
- [ ] Step 2: Analyze content
- [ ] Step 3: Confirm settings (AskUserQuestion)
- [ ] Step 4: Generate outline
- [ ] Step 5: Generate images
- [ ] Step 6: Finalize

Step 1: Pre-check

步骤1：预检查

1.5 Load Preferences (EXTEND.md) ⛔ BLOCKING

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
Not found	⛔ Run first-time-setup

Full procedures: references/workflow.md

1.5 加载偏好设置（EXTEND.md） ⛔ BLOCKING

bash

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

结果	操作
找到文件	读取、解析并显示摘要
未找到文件	⛔ 运行first-time-setup

完整流程请查看：references/workflow.md

Step 2: Analyze

步骤2：内容分析

Analysis	Output
Content type	Technical / Tutorial / Methodology / Narrative
Purpose	information / visualization / imagination
Core arguments	2-5 main points
Positions	Where illustrations add value

CRITICAL: Metaphors → visualize underlying concept, NOT literal image.

Full procedures: references/workflow.md

分析项	输出内容
内容类型	技术类 / 教程类 / 方法论类 / 叙事类
创作目的	信息传递 / 可视化展示 / 创意呈现
核心论点	2-5个主要观点
插图位置	插图能提升内容价值的位置

重要提示：隐喻需可视化其背后的概念，而非字面图像。

完整流程请查看：references/workflow.md

Step 3: Confirm Settings ⚠️

步骤3：确认设置 ⚠️

ONE AskUserQuestion, max 4 Qs. Q1-Q3 REQUIRED.

Q	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

仅可发起一次用户询问，最多4个问题。问题1-3为必填项。

问题	选项
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

完整流程请查看：references/workflow.md

Step 4: Generate Outline

步骤4：生成大纲

Save

outline.md

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

yaml

undefined

保存带有前置元数据（type, density, style, image_count）的

outline.md

文件，内容示例如下：

yaml

undefined

Illustration 1

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


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

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


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

Step 5: Generate Images

步骤5：生成图片

⛔ BLOCKING: Prompt files MUST be saved before ANY image generation.

For each illustration, create a prompt file per references/prompt-construction.md
Save to
```
prompts/NN-{type}-{slug}.md
```
with YAML frontmatter
Prompts MUST use type-specific templates with structured sections (ZONES / LABELS / COLORS / STYLE / ASPECT)
LABELS MUST include article-specific data: actual numbers, terms, metrics, quotes
DO NOT pass ad-hoc inline prompts to
```
--prompt
```
without saving prompt files first
Select generation skill, process references (
```
direct
```
/
```
style
```
/
```
palette
```
)
Apply watermark if EXTEND.md enabled
Generate from saved prompt files; retry once on failure

Full procedures: references/workflow.md

⛔ BLOCKING: Prompt files MUST be saved before ANY image generation.

为每一张插图创建提示词文件，遵循references/prompt-construction.md中的规范
将文件保存到
```
prompts/NN-{type}-{slug}.md
```
，并添加YAML前置元数据
提示词必须使用类型专属模板，包含结构化模块（ZONES / LABELS / COLORS / STYLE / ASPECT）
LABELS必须包含文章专属数据：实际数字、术语、指标、引用内容
禁止在未保存提示词文件的情况下，直接将临时 inline 提示词传入
```
--prompt
```
参数
选择生成工具，处理参考资源（
```
direct
```
/
```
style
```
/
```
palette
```
）
若EXTEND.md中启用水印，则为图片添加水印
从已保存的提示词文件生成图片；生成失败时重试一次

完整流程请查看：references/workflow.md

Step 6: Finalize

步骤6：最终定稿

Insert

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

after paragraphs.

Article Illustration Complete!
Article: [path] | Type: [type] | Density: [level] | Style: [style]
Images: X/N generated

在对应段落后插入

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

。

Article Illustration Complete!
Article: [path] | Type: [type] | Density: [level] | Style: [style]
Images: X/N generated

Output Directory

输出目录

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

Slug: 2-4 words, kebab-case. Conflict: append

-YYYYMMDD-HHMMSS

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

Slug：2-4个单词，采用kebab-case格式。冲突处理：追加

-YYYYMMDD-HHMMSS

。

Modification

修改操作

Action	Steps
Edit	Update prompt → Regenerate → Update reference
Add	Position → Prompt → Generate → Update outline → Insert
Delete	Delete files → Remove reference → Update outline

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

References

参考资料

File	Content
references/workflow.md	Detailed procedures
references/usage.md	Command syntax
references/styles.md	Style gallery
references/prompt-construction.md	Prompt templates
references/config/first-time-setup.md	First-time setup

文件	内容
references/workflow.md	详细流程说明
references/usage.md	命令语法说明
references/styles.md	风格图库
references/prompt-construction.md	提示词模板
references/config/first-time-setup.md	首次设置指南

OpenClaw Migration Notes

OpenClaw迁移说明

Migration mode: OpenClaw native first
Preserved directories:
- scripts: no
- references: yes
- prompts: yes
External dependencies: none
Risk level: low
Environment variables (detected):
```
HOME
```
Config compatibility: keep original
```
.baoyu-skills/<skill>/EXTEND.md
```
behavior and add OpenClaw-compatible path in runtime wrappers when needed.

迁移模式：OpenClaw native first
Preserved directories:
- scripts: no
- references: yes
- prompts: yes
External dependencies: none
Risk level: low
Environment variables (detected):
```
HOME
```
Config compatibility: keep original
```
.baoyu-skills/<skill>/EXTEND.md
```
behavior and add OpenClaw-compatible path in runtime wrappers when needed.

OpenClaw Preflight Checks

OpenClaw预检查

Confirm
```
bun
```
is available when script examples use
```
npx -y bun ...
```
.

Detected env vars:

HOME

当脚本示例使用
```
npx -y bun ...
```
时，确认
```
bun
```
已安装可用。

Detected env vars:

HOME

OpenClaw Failure Fallback

OpenClaw故障回退

If runtime dependency is missing, stop execution and return exact install/setup command.

若缺失运行时依赖，停止执行并返回准确的安装/设置命令。