ian-xiaohei-illustrations

小黑登场：让 AI 把文章里的关键判断「画」出来

深夜写完一篇 3000 字的方法论文章，配图却让你抓狂——朋友圈风格太精致不适合正经内容，PPT 流程图太死板，用 Midjourney 生成的插画和文章「八竿子打不着」。这时你打开 Codex，说一句「用小黑风格给这篇文章配 5 张正文配图」，一个黑色实心、白点眼睛的小人就开始在你的文章里穿梭：它可能是正在拉网捕鱼的渔民，可能是被压路机压扁的方块人，也可能是站在断点两侧张望的观众——每一次，它都在认真完成一件荒诞但「刚好成立」的事。

这就是 Ian Xiaohei Illustrations，一个让 AI 为中文文章生成「怪诞正文配图」的 Codex Skill。

从「配图焦虑」到「认知锚点可视化」

Ian（GitHub @helloianneo）是一位中文内容创作者，做知识型内容、方法论和 AI 工作流内容时，深感「为文章找配图」这件事的痛点：通用插画工具不懂文章语义，PPT 模板太死板，Midjourney 生成的图太过精致华丽，和严肃文章的气质格格不入。他想要的，是一种「刚好能配得上正经文章，但又有点怪、有点幽默、让人记住」的配图风格。

于是他造了一个「小黑」——一个黑色实心、白点眼、细腿、空表情的小角色。不是吉祥物，不是贴纸，而是一个「正在认真做一件荒诞工作的荒诞工作者」。配上「纯白背景、黑色手绘线稿、少量红橙蓝中文手写批注」的视觉规范，Ian 为自己定义了一套完整的正文配图生成 Skill，并开源到 GitHub。

「小黑怪诞风」是什么风格

你可能见过「知识卡片」「信息图」「PPT 风格图」，但小黑风格完全不同：

• 纯白底：不要纸纹、米色、阴影、渐变，干净得像一张白纸；
• 黑色手绘线稿：细线，轻微抖动，有手工感；
• 大量留白：主体只占画面 40%-60%，不塞满；
• 少量红橙蓝中文批注：手写感，不是印刷体；
• 小黑必须参与核心动作：不是站在角落的装饰品，是画面的一部分；
• 一图一认知：每张图只表达一个判断、流程、结构、状态或隐喻。

图1：「两个断点」—— 小黑站在断开的传送带两端，像思考者在认知跃迁处的停顿

图2：「按目的分拣」—— 小黑在分拣流水线上，把不同目的的内容塞进不同筐

图3：「一鱼多吃」—— 同一块素材被反复利用，小黑正在拆分它

图4：「想法压机」—— 混沌的想法被压路机压成整齐方块，小黑在操控它

图5：「信任桥」—— 一块一块证据铺过去的信任，小黑正在搭桥

技术实现：它是怎么工作的

从技术角度看，这是一个 纯文本的 Codex Skill，没有 Python 代码、没有 API、没有独立运行的程序。它的工作完全依赖 Codex Agent 的推理能力和内置 image_gen 工具。

Skill 的核心文件结构

ian-xiaohei-illustrations/
├── SKILL.md                    # 入口文件，定义技能描述与工作流
├── references/
│   ├── style-dna.md           # 风格 DNA：颜色、文字、禁忌
│   ├── xiaohei-ip.md          # 小黑 IP 形象、性格、动作库
│   ├── composition-patterns.md # 结构类型与原创隐喻方法
│   ├── prompt-template.md      # 单张生图提示词模板
│   └── qa-checklist.md         # 生成后检查与迭代规则
└── assets/
    └── ian-wechat-qr.jpg      # 作者微信联系方式

典型工作流

1. 消化正文：读取用户提供的文章、链接、Notion 页面或截图，提炼核心观点和认知转折点；
2. 出 shot list：先不生图，输出 4-8 张图的规划清单，每张写清楚主题、结构类型、小黑动作、中文标注建议；
3. 单张生成：用内置 image_gen 工具逐张生成，提示词必须包含风格约束；
4. QA 检查：对照 checklist 检验白底、留白、小黑参与、中文标注、无 PPT 感；
5. 交付保存：PNG 保存到 assets/<文章slug>-illustrations/ 目录。

与其他 AI 图像工具的区别

上手门槛：真的能用起来吗

门槛非常低。 安装只需三行命令：

git clone https://github.com/helloianneo/ian-xiaohei-illustrations.git
mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
cp -R ./ian-xiaohei-illustrations "${CODEX_HOME:-$HOME/.codex}/skills/"

安装后在 Codex 里说一句「Use $ian-xiaohei-illustrations 为这篇中文文章生成 5 张小黑正文配图」即可。没有参数调优、没有 API Key、没有 GPU 要求——只要你的 Codex 支持 image_gen 工具。

不过有几个限制需要注意：

• 依赖 Codex 的图像生成能力：需要使用支持 image_gen 的 Codex 版本，OpenAI 官方 ChatGPT 无法直接使用此 Skill；
• 风格不可定制：小黑风格是固定的，无法切换为其他视觉风格；
• 不适合的场景：商业插画、品牌 KV、精致扁平插画、儿童卡通、复杂架构图。

项目亮点与局限

亮点：

• 独特的视觉语言：小黑 IP 形成了强烈的个人风格识别度，10,000+ stars 说明确实有人需要这种「正经文章+怪诞配图」的组合；
• 系统化的生成方法论：不是简单堆砌 prompt，而是包含完整的 shot list 规划 → 隐喻发明 → QA 检查流程；
• 面向 AI Agent 原生设计：不依赖人类操作员的审美判断，而是把风格规则编码进 Skill 文件，让 AI Agent 可以自主完成整套工作流；
• 中文内容创作者的刚需：方法论、认知科学、知识管理类中文内容一直缺少趁手的配图工具，这个项目填补了一个真实空白。

局限：

• 强依赖图像模型质量：生成结果的稳定性和图像模型的版本强相关，风格一致性依赖模型对「手绘感」「白底」「中文批注」等约束的理解程度；
• 无法编辑源文件：输出 PNG，无法提供 SVG 或可编辑源文件；
• 适用场景相对垂直：更适合知识型、方法论类内容，不适合新闻报道、产品介绍、娱乐内容。

行业意义与增长趋势

截至分析时，该项目在 GitHub 拥有超过 10,000 颗 stars，被标注为 ai-agent、image-generation、chinese、codex-skill、handdrawn 等 topic，是 Codex Skill 生态中少有的破万 star 的中文项目。它代表了一种新兴趋势：不是让 AI 生成「一张好看的图」，而是让 AI 生成「一张能帮读者理解文章的图」——图服务于认知，而非服务于美观。

随着 AI Agent 生态的扩张，越来越多的技能将以「Skill 文件」而非「独立应用」的形式存在。Ian Xiaohei Illustrations 既是这个趋势的早期实践者，也为中文内容创作者社区提供了一个可复用的配图解决方案。

分析时间：2026-08-24 | 项目：helloianneo/ian-xiaohei-illustrations | Stars：10,095