helloianneo/ian-xiaohei-illustrations · 上手攻略

  • 仓库：helloianneo/ian-xiaohei-illustrations
  • 链接：https://github.com/helloianneo/ian-xiaohei-illustrations
  • 分类：engineering · skill · multimodal
  • 作者：Jay
  • 更新：2026-07-07

这是什么

ian-xiaohei-illustrations 是一个面向 AI Agent（尤其是 Codex）的中文正文配图生成 Skill。它指导 AI 把中文文章、帖子、博客、方法论内容里的判断、流程、状态和隐喻，转化成一张张白底、手绘、怪诞但清爽的 16:9 正文配图。

核心特点：生成的不是通用插画 prompt，也不是 PPT 信息图模板，而是先理解文章认知锚点，再把一个核心判断/流程/结构/隐喻可视化。默认视觉 IP 是一个叫"小黑"的小角色——黑色实心、白点眼、细腿、空表情，正在"认真参与系统运转的荒诞工作者"。

解决什么问题

写中文文章时，正文配图是个痛点： - 通用 AI 画图 prompt 出来的图太"通用"，和文章内容脱节 - PPT 信息图太正式、缺乏个人识别度 - 找人画成本高、周期长 - 现有 AI 插画工具缺乏对中文文章结构的理解

这个 Skill 的核心价值：让 AI 不只是"配一张图"，而是把文章里的关键认知动作画出来。

快速安装

克隆仓库

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

复制 Skill 到 Codex 目录

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

⚠️ 真正需要安装到 Codex 的是仓库根目录下的 ian-xiaohei-illustrations/ 子目录，不是整个仓库。

核心用法

安装后，在 Codex 对话中调用：

用法一：先分析再生成（推荐）

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

<粘贴文章>

用法二：直接生成

Use $ian-xiaohei-illustrations 把下面这篇文章生成 4 张小黑怪诞正文配图。
要求：16:9 横版、纯白背景、黑色手绘线稿、少量红橙蓝中文手写批注。

<粘贴文章>

用法三：生成单张指定图

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

用法四：编辑已有图

Use $ian-xiaohei-illustrations 帮我编辑这张图，去掉左上角的"流程图"标题，其他内容保持不变。

输出规格

默认输出： - 16:9 横版正文配图（PNG） - 每篇文章 4-8 张 shot list - 每张图的主题、核心意思、结构类型、小黑动作、中文标注建议 - 最终 PNG 保存到 workspace/assets/illustrations/

不输出： - PPTX / PDF / Keynote - SVG / HTML / Canvas 可编辑图 - 商业海报或封面 KV - 大段文字型信息图

生成流程（Skill 内部逻辑）

  1. 读取：文章、Markdown、Notion 内容、截图或用户给的主题
  2. 提炼：核心观点、认知转折、流程结构、适合视觉化的段落
  3. Shot list：每张图只选一个认知锚点
  4. 选结构类型：Workflow、系统局部、前后对比、角色状态、概念隐喻、方法分层、地图路线、小漫画分镜
  5. 发明隐喻：低科技、怪诞但成立的物理隐喻
  6. 让小黑承担核心动作
  7. 调用图像模型生成
  8. QA 检查：白底、留白、小黑动作、中文标注、非 PPT 感、非旧案例复刻
  9. 保存 PNG，报告用途和路径

视觉风格规范

要素 规范
背景 纯白，不要纸纹、米色、阴影、渐变
线稿 黑色手绘线稿，细线，轻微抖动
留白 大量留白，主体占画面约 40%-60%
标注 少量红色、橙色、蓝色中文手写批注
构图 一张图只表达一个核心动作/结构/状态/隐喻
小黑 必须参与核心动作，不能只是装饰
整体 怪诞、有创意、清爽，但不幼稚、不卖萌

典型适用场景

  • 写中文文章/帖子/博客：需要正文配图和文章插图
  • 知识型/方法论内容：把抽象判断画成具体隐喻
  • AI 工作流内容：可视化流程和判断逻辑
  • 个人品牌内容：建立独特的视觉语言识别度
  • Codex 内容生产：稳定复用一套视觉语言

坑与注意

  1. 图片里的中文文字越短越稳定。中文错字是高频问题，优先减少标注词并重生成。
  2. 每张图只讲一个核心结构，不要把文章做成说明书。
  3. 小黑必须参与核心动作：如果去掉小黑画面仍然完全成立，说明小黑太装饰了。
  4. 示例图只用于风格校准，不要复刻构图，要从当前文章重新发明隐喻。
  5. AI 图像模型可能出现错字、幻觉标签、风格漂移或多余标题，生成后需要检查。
  6. 效果高度依赖图像模型的质量，建议使用较强的多模态模型（如 DALL-E 3、Midjourney v6 等）。

与同类对比

工具 类型 风格 中文支持 理解文章结构
ian-xiaohei-illustrations Codex Skill 怪诞手绘 ✅ 专为中文设计 ✅ 理解认知锚点
Midjourney/SD 通用 prompt AI 绘图 任意 ⚠️ 需英文 ❌ 不理解文章
PPT 信息图工具 设计模板 商务正式 ✅ ❌ 模板化
Canva AI 在线设计 多样 ✅ ❌ 不理解内容

核心差异：这个 Skill 不只是"画一张图"，而是把文章的关键认知动作画出来——有理解、有选择、有隐喻。

一句话推荐结论

如果你是用 Codex 或其他 AI Agent 做中文内容生产，想要一套稳定、独特、有辨识度的正文配图风格，ian-xiaohei-illustrations 是目前最专注于此的 Skill——它不只是 prompt，而是完整的生成流程和质量门控。

相关资源

  • 作者 GitHub：https://github.com/helloianneo
  • 作者网站：https://www.ianneo.xyz
  • 同作者 Skill — Ian Handdrawn PPT：中文手绘技术 PPT-style 页面图生成
  • 同作者 Skill — Awesome Claude Code Skills