ian-xiaohei-illustrations 保姆级教程：用 Codex 给中文文章生成小黑手绘认知配图

如果你经常写中文文章，应该会遇到一个问题：正文配图很难做。

图库图太空，AI 氛围图太飘，PPT 信息图又太重。尤其是方法论文章、AI 工作流文章、知识型内容，真正需要的不是一张“好看的图”，而是一张能帮读者理解关键判断的图。

最近我看到一个很有意思的 GitHub 仓库：ian-xiaohei-illustrations。它是一个 Codex Skill，用来把中文文章里的判断、流程、状态和隐喻，生成成白底、手绘、带少量中文批注的正文配图。

这篇文章我会站在中文内容创作者的角度，完整讲清楚：它是什么、适合谁、怎么安装、怎么调用、生成效果怎么看，以及使用时有哪些坑。

ian-xiaohei-illustrations 是什么？

一句话解释：它是一个 Codex Skill，用来指导 AI Agent 为中文文章生成“小黑风格”的正文认知配图。

它不是普通 AI 绘图 prompt，也不是一套图库。它的核心流程是：先读文章，找出里面值得视觉化的认知锚点，再把这个判断、流程、状态或隐喻，画成一张 16:9 的白底手绘解释图。

它解决了什么问题？

很多中文文章不是缺图，而是缺“能参与表达的图”。

图库图只能装饰，AI 图经常漂亮但没用，PPT 信息图又容易太重。ian-xiaohei-illustrations 的价值在于，它让配图从“装饰”变成“解释”：一张图只表达一个认知动作，比如分拣、压缩、承接、搭桥、拉线。

适合谁用？

适合：

• 写公众号、博客、Notion 文档的人
• 做 AI 工作流、方法论、知识型内容的人
• 想给文章建立稳定视觉风格的人
• 不想每篇文章都重新想配图 prompt 的人

不适合：

• 想要精致商业插画的人
• 想要 PPT 信息图的人
• 想要可编辑 SVG 源文件的人
• 想把大量文字塞进一张图的人

安装前你需要知道什么

这个仓库真正要安装的是里面的 ian-xiaohei-illustrations/ 子目录，不是整个根目录。

你需要：

• 能使用 Codex
• 有一个本地 skills 目录
• 最好已经配置好图像生成能力
• 知道 AI 生成中文文字可能会有错字

安装步骤

第一步：克隆仓库

git clone https://github.com/helloianneo/ian-xiaohei-illustrations.git
cd ian-xiaohei-illustrations

第二步：复制 Skill 到 Codex skills 目录

mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
cp -R ./ian-xiaohei-illustrations "${CODEX_HOME:-$HOME/.codex}/skills/"

第三步：在 Codex 里调用

Use $ian-xiaohei-illustrations 为这篇中文文章设计并生成 5 张小黑怪诞正文配图。

最简单的使用方式

如果你不想一上来就生成图片，可以先让它做配图规划：

Use $ian-xiaohei-illustrations 先不要生图。
请分析下面这篇文章哪里值得配图，输出 5 张左右的 shot list。
每张图写清楚：放在哪段后、主题、核心意思、结构类型、小黑在做什么、建议中文标注词。

<粘贴文章>

这样做的好处是，你可以先判断它有没有理解文章，而不是直接浪费生成次数。

它生成图片的核心逻辑

我理解它的核心不是“小黑很可爱”，而是这套方法：

1. 先读文章
2. 找认知锚点
3. 选一个核心动作
4. 发明一个物理隐喻
5. 让小黑参与这个动作
6. 用白底手绘方式画出来
7. 用少量中文标注辅助理解

这也是它和普通 AI 配图最大的区别。

示例：单个概念怎么生成

比如你想表达：

信任不是喊出来的，而是一块证据一块证据铺过去。

可以这样写：

Use $ian-xiaohei-illustrations 为“信任不是喊出来的，而是一块证据一块证据铺过去”生成一张正文配图。
画面要怪诞但清爽，小黑必须承担核心动作。

使用时最容易踩的坑

坑一：中文文字太多

图片里的中文越多，越容易错字。建议每个标签控制在 2-6 个字。

坑二：一张图想讲太多

它适合“一图一判断”，不适合把整篇文章画成说明书。

坑三：小黑变成装饰

小黑必须参与核心动作。如果去掉小黑，图还完全成立，那这张图就没有用好这个 IP。

坑四：复刻示例构图

示例图只是校准风格，不是模板。真正要学的是方法，不是照抄机器、桥、井这些物件。

我的使用建议

我的建议是：先不要急着生成最终图，先让它输出 shot list。

因为一篇文章最难的不是“画”，而是判断哪里值得画。好的正文配图，应该出现在读者需要理解一个抽象判断的时候，而不是随便插在段落中间。

总结

ian-xiaohei-illustrations 最有价值的地方，不是它能生成小黑插画，而是它提供了一套中文内容配图方法。

它把“配图”这件事从装饰变成表达：先理解文章，再提炼认知锚点，最后把抽象判断画成一个具体动作。

如果你长期写中文知识型内容，尤其是 AI、方法论、工作流、产品思考类文章，这个仓库很值得研究。