Smart Illustrator - 智能配图与 PPT 生成器

⛔ 强制规则（违反即失败）

规则 1：用户提供的文件 = 要处理的文章

/smart-illustrator SKILL05.md → SKILL05.md 是文章，为它配图
/smart-illustrator README.md → README.md 是文章，为它配图
/smart-illustrator whatever.md → whatever.md 是文章，为它配图

无论文件名叫什么，都是要配图的文章，不是 Skill 配置。

规则 2：必须读取 style 文件

生成任何图片 prompt 前，必须读取对应的 style 文件：

模式	必须读取的文件
文章配图（默认）	styles/style-light.md
Cover 封面图

styles/style-cover.md |
| --style dark | styles/style-dark.md |
| --style bento | styles/style-bento.md |

禁止自己编写 System Prompt。

❌ 错误：你是一个专业的信息图设计师...（自己编的）
✅ 正确：从 style 文件的代码块中提取 System Prompt

---

使用方式

文章配图模式（默认）

bash
/smart-illustrator path/to/article.md
/smart-illustrator path/to/article.md --prompt-only # 只输出 prompt
/smart-illustrator path/to/article.md --style dark # 深色风格
/smart-illustrator path/to/article.md --no-cover # 不生成封面图

PPT/Slides 模式

bash

默认：直接生成图片

/smart-illustrator path/to/script.md --mode slides

只输出 JSON prompt（不调用 API）

/smart-illustrator path/to/script.md --mode slides --prompt-only

默认行为：调用 Gemini API 生成批量信息图。
--prompt-only：输出 JSON prompt 并自动复制到剪贴板，可直接粘贴到 Gemini Web 手动生成。

PPT JSON 格式（--prompt-only 时输出）：

json
{
instruction: 请逐条生成以下 N 张独立信息图。,
batchrules: { total: N, oneitemoneimage: true, aspect_ratio: 16:9 },
style: [从 styles/style-light.md 读取完整内容],
pictures: [
{ id: 1, topic: 封面, content: 系列名称\n\n第N节：标题 },
{ id: 2, topic: 主题, content: 原始内容 }
]
}

Cover 模式

bash
/smart-illustrator path/to/article.md --mode cover --platform youtube
/smart-illustrator --mode cover --platform youtube --topic Claude 4 深度评测

平台尺寸（输出均为 2K 分辨率）：

平台	代码	宽高比
YouTube	youtube	16:9
公众号

wechat | 2.35:1 |
| Twitter | twitter | 1.91:1 |
| 小红书 | xiaohongshu | 3:4 |

---

参数说明

参数	默认值	说明
--mode	article	article / slides / cover
--platform

youtube | 封面图平台（仅 cover 模式） |
| --topic | - | 封面图主题（仅 cover 模式） |
| --prompt-only | false | 输出 prompt 到剪贴板，不调用 API（适用于所有模式） |
| --style | light | 风格：light / dark / minimal / bento |
| --no-cover | false | 不生成封面图 |
| --ref | - | 参考图路径（可多次使用） |
| -c, --candidates | 1 | 候选图数量（最多 4） |
| -a, --aspect-ratio | - | 宽高比：16:9（正文配图/封面图默认）、3:2（备选横版）、3:4（仅竖屏平台） |
| --engine | auto | 引擎选择：auto（自动）/ mermaid / gemini / excalidraw |
| --mermaid-embed | false | Mermaid 输出为代码块而非 PNG（旧行为） |
| --save-config | - | 保存到项目配置 |
| --no-config | false | 禁用 config.json |

--no-config 范围：只禁用 config.json，不影响 styles/style-*.md。

---

配置文件

优先级：CLI 参数 > 项目级 > 用户级

位置	路径
项目级	.smart-illustrator/config.json
用户级

~/.smart-illustrator/config.json |

json
{ references: [./refs/style-ref-01.png] }

---

三级配图引擎

优先级	引擎	适用场景	输出
1	Gemini	隐喻图、创意图、封面图、无法用图表表达的概念	PNG
2

Excalidraw | 概念图、对比图、简单流程（≤ 8 节点）、关系图、手绘风格示意图 | PNG |
| 3 | Mermaid | 仅限：复杂流程（> 8 节点）、多层架构图、多角色时序图、多分支决策树 | PNG |

选择逻辑：

• - 需要隐喻、情感、创意表达 → Gemini
• 概念关系、对比、简单流程 → Excalidraw（大多数图表场景的首选）
• 只有节点 > 8、多层/多角色的复杂结构化图形 → Mermaid
• Mermaid 视觉表现力有限，能用 Excalidraw 就不用 Mermaid
• 唯一目标：提高文章吸引力

生成 Excalidraw 前必须读取 references/excalidraw-guide.md。

Mermaid 语义色板

每种颜色有固定含义，必须使用 classDef + class 应用：

语义	填充色	边框色	用于
input	#d3f9d8	#2f9e44	输入、起点、数据源
process

#e5dbff | #5f3dc4 | 处理、推理、核心逻辑 |
| decision | #ffe3e3 | #c92a2a | 决策点、分支判断 |
| action | #ffe8cc | #d9480f | 执行动作、工具调用 |
| output | #c5f6fa | #0c8599 | 输出、结果、终点 |
| storage | #fff4e6 | #e67700 | 存储、记忆、数据库 |
| meta | #e7f5ff | #1971c2 | 标题、分组、元信息 |

classDef 写法（放在图表末尾）：

classDef input fill:#d3f9d8,stroke:#2f9e44,color:#1a1a1a
classDef process fill:#e5dbff,stroke:#5f3dc4,color:#1a1a1a
classDef decision fill:#ffe3e3,stroke:#c92a2a,color:#1a1a1a
classDef action fill:#ffe8cc,stroke:#d9480f,color:#1a1a1a
classDef output fill:#c5f6fa,stroke:#0c8599,color:#1a1a1a
class A input
class B,C process
class D output

Mermaid 布局规则

• - 布局方向：默认 TB（上到下），横向流程用 LR
• 箭头分级：--> 主流程 / -.-> 可选/辅助路径 / ==> 重点强调
• 分组：用 subgraph 对相关节点分组，标题简洁
• 节点文字：≤ 8 字，无 emoji，禁止 1. 格式（用 ① 或 Step 1:）
• 节点数量：单图 ≤ 15 个节点，复杂内容拆成多图

--engine 参数：

• - auto（默认）：根据内容类型自动选择（优先级 Gemini > Ex