写公众号的都懂:文章憋出来了,配图还没影。截图不像话,库存图不符,找设计师又要排队花钱。
Ian 把这个痛做成了一套 Skill:AI 先读懂你文章里的判断、流程和隐喻,再一张张画成白底手绘的"小黑"配图,16:9 直接可贴。
PART 01 项目速览
| 项目 | ian-xiaohei-illustrations |
|---|---|
| 定位 | 中文文章正文配图生成 Skill |
| GitHub | https://github.com/helloianneo/ian-xiaohei-illustrations |
| Star | 12.1K(Fork 1.4K) |
| 协议 | MIT,可商用 |
| 规模 | 1 个 Skill + 5 份风格参考文档 + 8 张校准样例 |
| 兼容 | Codex / Claude Code 等支持 SKILL.md 的 Agent |
| 创建 | 2026-05-27,上周仍在更新 |
一句话定位:不是给文章"配一张图",而是把文章里最关键的那个认知动作画出来。
PART 02 为什么值得看
大多数 AI 配图方案是"给一段话,吐一张插画",好不好看全凭运气,和文章内容基本没关系。这个项目反着来:它先让 Agent 通读全文,提炼出判断、流程、状态和隐喻这些"认知锚点",再挑最值得画的那几个,逐张构思、逐张生成。
作者 Ian 是产品设计师出身,给这个 Skill 定了一套相当克制的视觉语言:纯白背景、黑色手绘细线、大量留白、只允许少量红橙蓝中文批注。主角"小黑"是一个黑色实心、白点眼、细腿、空表情的小角色,永远在画面里承担核心动作,荒诞但清爽。这套东西被开源社区反复验证过,12.1K Star 就是证明。
PART 03 五大核心特性
1. 先出 shot list 再画图。
Agent 会先分析文章哪里值得配图,输出 4-8 张图的拍摄清单:放在哪段后、主题、核心意思、结构类型、小黑在做什么、建议标注词。先规划后生成,避免一次生成一堆废图。
2. 八种结构类型模板。
Workflow、系统局部、前后对比、角色状态、概念隐喻、方法分层、地图路线、小漫画分镜,每张图只选一种结构,只讲一个核心动作,不会把文章塞成一张说明书。
3. 物理隐喻自动发明。

它会为每个概念重新发明一个低科技、怪诞但成立的物理隐喻,比如"想法压机""信任桥""信息井",样例图只用于校准线条和留白,禁止复刻构图,所以每篇文章的图都不重样。
4. 内置 QA checklist。
每张图生成后按清单核验:白底、留白比例、小黑是否参与核心动作、中文标注是否简短、有没有 PPT 感。小黑是参与者和检验标准双角色——如果去掉小黑画面仍然成立,就说明画得太装饰了,得重画。
5. 支持后期编辑。
生成后可以继续对话改图:去掉图里的标题、修正错字标注、调整构图。中文标注越短越稳定,这是它反复强调的实战经验。
PART 04 适用场景
- 公众号、博客、知识付费作者:一文产出 4-8 张风格统一的正文配图
- 做方法论和 AI 工作流内容的人:把抽象判断画成有记忆点的隐喻
- Notion 文档和帖子写作者:给文档加一套识别度极高的视觉语言
- 想建立个人视觉 IP 的创作者:小黑风格本身就是记忆点
PART 05 端侧 AI 的核心价值
克隆仓库,把 Skill 子目录复制进 Codex 的技能目录:
git clone https://github.com/helloianneo/ian-xiaohei-illustrations.git
cd ian-xiaohei-illustrations
mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
cp -R ./ian-xiaohei-illustrations "${CODEX_HOME:-$HOME/.codex}/skills/"注意真正要装的是同名子目录,根目录的 README 和 examples 只是分享文档。装好后三种典型用法:
只做规划不出图:贴上文章,让 Agent 输出 5 张左右的 shot list,先看它觉得哪里值得配图。
一键生成:粘贴全文,要求 16:9 横版、白底手绘、红橙蓝批注,等它逐张生成并保存到 assets 目录。
单点突破:只给一句核心判断,比如"信任不是喊出来的,而是一块证据一块证据铺过去",请 Agent 专门为这一句画一张图。
Claude Code 等其他支持 SKILL.md 格式的 Agent 同样可以按目录结构放入 skills 文件夹使用。
PART 06 为什么推荐它
推荐理由:这是把"配图"从运气活变成流水线活的项目。
它的价值不在画得多精美,而在先理解文章再动手的思路,加上一套被 12.1K 人验证过的克制视觉语言。作者还开源了配套的中文手绘 PPT Skill,做内容的人可以一套打包收走。
项目地址:https://github.com/helloianneo/ian-xiaohei-illustrations
觉得有用,去给作者点个 Star。
