传统配图 = 去家具城买现成的沙发——颜色可能不搭，但凑合能用。小黑插图 = 雇佣一位懂建筑结构的插画师——他根据你的承重墙（核心逻辑），现场画一张风格统一的装饰画。
一、这是什么？
想象你刚写完一篇 3000 字的技术文章，结构清晰、逻辑自洽，但总觉得少了点什么。你试过放一张 Unsplash 的氛围图，但那张图跟内容毫无关系；你也试过画流程图，但读起来像产品说明书。
它不是通用插画工具，也不是 PPT 信息图模板。它的核心目标只有一个：先理解文章里的认知锚点，再把其中一个关键动作画出来。
作者：Ian（伊恩）｜ GitHub：4.6k+ stars ｜ 协议：MIT License
定位：Codex Skill，专为中文文章生成配图
二、为什么需要它？
| 痛点 | 传统方案的问题 | 小黑插图怎么解决 |
|---|---|---|
| 文不对图 | 放一张氛围图，跟正文毫无关联 | 先分析文章逻辑，再为关键认知锚点画图 |
| 风格割裂 | 多张图来自不同来源，风格不统一 | 锁死视觉规范：白底+黑线+小黑IP+红橙蓝批注 |
| 没有记忆点 | 流程图看完就忘，没有个人风格 | 小黑承担核心动作，怪诞但清爽，看完能记住 |
一句话：让 AI 不只是「配一张图」，而是把文章里的一个关键认知动作画出来。
三、核心能力详解
3.1 「小黑」IP：荒诞的系统参与者
小黑不是吉祥物，不是贴纸，不是站在角落里的装饰物——它是一个正在认真参与系统运转的荒诞工作者。
- 外形：黑色实心身体、白点眼睛、细腿、空表情
- 角色定位：不是卖萌，而是「认真干活的荒诞小角色」
- 核心规则：如果去掉小黑，画面仍然完全成立，说明小黑太装饰了，不符合要求
3.2 视觉风格规范
| 规范项 | 具体要求 |
|---|---|
| 背景 | 纯白，无纸纹、无米色、无阴影、无渐变 |
| 线条 | 黑色手绘线稿，细线，轻微抖动 |
| 留白 | 主体只占画面 40%-60%，大量留白 |
| 批注 | 仅少量红色、橙色、蓝色中文手写批注 |
| 比例 | 16:9 横版，专为正文阅读体验优化 |
| 单图单锚点 | 一张图只表达一个核心动作、结构、状态或隐喻 |
3.3 认知配图哲学
市面上大多数 AI 配图工具的逻辑是：你给 prompt，我出图。小黑的逻辑是：先理解文章 → 提取认知锚点 → 发明物理隐喻 → 再画图。
这个「认知提取」环节确保的是「图在解释文章」，而不是「图在装饰文章」。
四、9 步工作流程详解
- 读取文章
Markdown / Notion / 截图 / 用户给的主题
- 提炼核心
找出文章里的认知转折、关键判断、流程结构
- 输出 shot list
每张图只对应一个认知锚点（4-8 张）
- 选择结构类型
从 8 种类型中匹配（参见第七节）
- 发明物理隐喻
低科技、怪诞但成立的场景——如「堆积木」表示「信任构建」
- 小黑承担核心动作
小黑必须在画面里「干活」，不是装饰
- 逐张生成图像
调用图像模型，每张图单独生成
- QA 检查清单
6 项验证，不通过就重生成
- 保存并报告
PNG 保存到 assets/<article-slug>-illustrations/
QA 检查清单（6 项）
- 纯白背景？
- 留白足够？
- 小黑在承担核心动作（非装饰）？
- 中文标注存在且合理？
- 没有 PPT 信息图的感觉？
- 没有复刻示例图的构图？
五、3 种使用方式
只做配图规划（推荐先用这个）
Use $ian-xiaohei-illustrations 先不要生图。请分析下面这篇文章哪里值得配图，输出 5 张左右的 shot list...
直接生成正文配图
Use $ian-xiaohei-illustrations 把下面这篇文章生成 4 张小黑怪诞正文配图...
为单个概念/金句生成一张图
Use $ian-xiaohei-illustrations 为「信任不是喊出来的，而是一块证据一块证据铺过去」生成一张正文配图...
六、安装步骤（2 步搞定）
克隆仓库
git clone https://github.com/helloianneo/ian-xiaohei-illustrations.git cd ian-xiaohei-illustrations
复制到 Codex skills 目录
mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
cp -R ./ian-xiaohei-illustrations "${CODEX_HOME:-$HOME/.codex}/skills/"
验证安装：在 Codex 里输入 Use $ian-xiaohei-illustrations，如果 Agent 正确识别就开始工作了。
七、8 种结构类型速查表
| 结构类型 | 适合表达什么 | 示例 |
|---|---|---|
| Workflow | 流程、步骤、顺序 | 小黑沿着一条路径依次完成 3 个动作 |
| 系统 | 局部系统的一部分、组件关系 | 小黑在系统里搬运某个关键部件 |
| 前后对比 | 状态变化、转变前后 | 左边小黑在推门（调用），右边转身离开（熔断） |
| 角色状态 | 某个角色的处境、状态 | 小黑被困在迷宫里，表示决策困境 |
| 概念隐喻 | 抽象概念的可视化 | 小黑铺鹅卵石路，每块石头是「证据」 |
| 方法分层 | 方法论的层次结构 | 小黑在堆积木，底层是地基，上层是应用 |
| 地图路线 | 路径、选择、导航 | 小黑站在分岔路口，路标指向不同方向 |
| 小漫画分镜 | 简短叙事、故事片段 | 2-3 格漫画，小黑完成一个小故事 |
八、注意事项与避坑指南
| 坑 | 原因 | 解决方案 |
|---|---|---|
| 中文文字错字 | AI 图像模型对中文渲染不稳定 | 中文越短越稳定；错字严重时减少标注词并重生成 |
| 风格漂移 | 模型不严格遵循风格约束 | Prompt 中反复强调「纯白背景、黑色手绘线稿、仅红橙蓝三色」 |
| 小黑形象不一致 | 随机种子导致 | 固定 Seed 值，强调「黑色实心、白点眼、细腿」三要素 |
| 色彩失控 | 模型加入绿色、紫色等杂色 | 增加负面约束：「禁止使用绿色、紫色等其他颜色」 |
| 小黑太装饰 | 去掉小黑画面仍然成立 | 检查小黑是否承担了核心动作 |
| 一张图塞太多 | 违反单图单锚点原则 | 拆分成多张图，每张只讲一个核心结构 |
核心原则：图片里的中文文字越短越稳定。每张图只讲一个核心结构。小黑必须承担核心动作——如果去掉小黑画面仍然完全成立，说明小黑太装饰了。
九、适用场景：适合谁 / 不适合谁
| ✅ 适合场景 | ❌ 不适合场景 |
|---|---|
| 写中文深度文章、博客、公众号 | 商业插画、品牌 KV（风格不够精致） |
| 做方法论、AI 工作流、思维模型 | 复杂架构图、流程图（非工程化信息图） |
| 做知识付费、课程、复盘 | 儿童卡通、可爱 IP（小黑不卖萌） |
| 建立个人品牌识别度 | 大段文字型信息图（单图单锚点） |
| 用 Codex 做自动化内容生产 | 需要可编辑矢量源文件（输出 PNG） |
| 学术论文、正式报告（风格不够严肃） |
十、与其他方案对比
| 维度 | 传统图库 | Midjourney | 小黑插图 |
|---|---|---|---|
| 版权风险 | 高，需甄别 | 低，生成式可控 | 低，生成式可控 |
| 逻辑契合度 | 低，常文不对图 | 中，取决于 prompt | 高，基于认知锚点生成 |
| 风格统一性 | 差，多张图风格割裂 | 差，风格易漂移 | 优，固定 IP+色彩规范 |
| 生产效率 | 低，30 分钟/篇 | 中，10 分钟/篇 | 高，2 分钟/篇 |
| 定制成本 | 高，需设计师 | 中，需调 prompt | 低，Skill 驱动自动化 |
| 视觉记忆点 | 弱，通用素材 | 中，取决于风格 | 强，小黑 IP 有辨识度 |
核心逻辑不同：传统方案是「找现成图」，Midjourney 是「你描述画面我画」，小黑是「先理解文章，再画认知动作」。
十一、相关项目
| 项目 | 用途 |
|---|---|
| ian-xiaohei-illustrations | 中文文章正文配图（本文主角） |
| Ian Handdrawn PPT | 手绘技术 PPT 风格页面，与小黑白底+黑线风格一致 |
| Awesome Claude Code Skills | Claude Code Skills 精选合集，含小黑插图 |
| Obsidian + Claude AI Second Brain | Obsidian + Claude AI 个人知识库，内容生产系统的另一环 |
十二、常见问题 FAQ
Q1：这个 Skill 适合什么人？
适合写中文观点类、方法论类、经验复盘类文章的人。如果你的内容有大量抽象判断和认知转折，小黑能帮你把关键观点钉在读者脑子里。
Q2：跟 Midjourney / Stable Diffusion 有什么区别？
本质区别是出发点不同。通用工具是「你描述画面，我画出来」。小黑是先理解你的文章，再为关键认知锚点发明视觉隐喻。前者是画具，后者是认知配图师。
Q3：不用 Codex 能用吗？
目前不行。小黑插图是基于 Codex 的 Skills 机制设计的。如果你不用 Codex，可以手动复制 README 中的核心指令作为系统预设，但效果可能不如原生 Skill 稳定。
Q4：生成的图可以商用吗？
项目采用 MIT License，可以自由使用。但注意底层图像模型的输出需遵守该模型的使用条款。
Q5：中文错字严重怎么办？
优先减少标注词并重生成。如果仍不稳定，建议只生成图像主体，文字批注后期通过代码或 PS 手动添加。
Q6：支持英文文章吗？
专为中文文章优化。若用于英文，需调整 Prompt 中的文化隐喻部分，否则可能出现理解偏差。
十三、关键链接
| GitHub 仓库 | github.com/helloianneo/ian-xiaohei-illustrations |
| 作者网站 | ianneo.xyz |
| 作者 X/Twitter | @ianneo_ai |
| 作者微信 | ianneoxyz（备注「OPC」） |
| 手绘 PPT | github.com/helloianneo/ian-handdrawn-ppt |
| Claude Skills 合集 | github.com/helloianneo/awesome-claude-code-skills |
十四、一句话总结
小黑插图不是「给你一支万能画笔」，而是「给你一个风格固定的画室」——在这个画室里，AI 先读懂你的文章，再为每一个关键认知动作，画一张有记忆点的怪诞手绘解释图。
如果你在做长期的中文内容输出，需要一套稳定的、有识别度的、能解释文章而非装饰文章的配图体系，小黑插图可能是你内容生产线上缺的那一环。
返回技艺录