ian-xiaohei-illustrations

写文章缺配图？一句话生成怪诞手绘插画

专为中文内容打造的小黑怪诞风格正文配图生成技能，输出 16:9 白底手绘风格图片，辅以少量红橙蓝批注，适合 Codex 等 AI 编程助手一键调用，为文章快速配图。

开源 unknown 图像生成

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 11972

维护状态低维护

是否开源是

定价模式 unknown

项目数据

分类图像生成

开发团队helloianneo

所属国家

官网地址https://www.ianneo.xyz

GitHubhttps://github.com/helloianneo/ian-xiaohei-illustrations

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言

技术栈/模型ai-agent,chinese,codex-skill,handdrawn,illustration,image-generation,xiaohei

GitHub 星标★ 11972

30天Star增速

HF 下载量

上线时间2026-05-27 00:00:00

最近更新2026-09-22 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：入门约 10 分钟部署方式：本地安装 4 步

环境要求

已安装 git，可执行 git clone
已安装 Codex（需要 skills 目录，默认位于 $HOME/.codex/skills）
准备一篇中文文章或帖子作为配图素材
可写入本地用户目录的权限

安装与启动步骤

1克隆仓库

把 Ian Xiaohei Illustrations 仓库下载到本地，并进入仓库目录。

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

2复制到skills目录

在 Codex skills 目录下创建文件夹，并把整个 skill 目录复制进去；未设置 CODEX_HOME 时默认用 $HOME/.codex。
```
mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
cp -R ./ian-xiaohei-illustrations "${CODEX_HOME:-$HOME/.codex}/skills/"
```
3在 Codex 中调用

在 Codex 会话里用 $ian-xiaohei-illustrations 唤起该 skill，并说明要为哪篇文章生成几张配图。
```
Use $ian-xiaohei-illustrations 为这篇中文文章设计并生成 5 张小黑怪诞正文配图。
```
4查看生成结果

skill 会先给出 4-8 张 shot list（主题、结构、小黑动作、中文标注），再产出 PNG，保存到 workspace 的 assets/-illustrations/ 目录。

关键配置

配置项	必填	说明	示例
`CODEX_HOME`	否	Codex 配置目录，决定 skills 安装位置，未设置时用 $HOME/.codex	`/your/path/.codex`
`assets/-illustrations/`	否	最终 PNG 图片的默认输出目录，位于 workspace 下	`assets/my-article-illustrations/`

如何确认成功

复制完成后在 Codex 中执行 Use $ian-xiaohei-illustrations …，能返回 4-8 张 shot list 并在 assets/-illustrations/ 看到生成的 PNG。

常见问题

Q：没有设置 CODEX_HOME 怎么办？

A：不用设置也能用，命令会自动回退到 $HOME/.codex，把 skill 复制到 ~/.codex/skills 即可。

Q：生成的图保存在哪里？

A：默认保存在 workspace 的 assets/-illustrations/ 目录下，最终格式为 PNG。

Q：能输出可编辑的矢量文件或 PPT 吗？

A：不能。默认不输出 PPTX/PDF/Keynote，也不输出 SVG/HTML/Canvas 可编辑图和商业海报。

Q：可以直接照抄示例图的构图吗？

A：不建议。README 明确说明示例图只是风格校准样例，使用时要从当前文章重新发明隐喻。

注意事项

该 skill 面向中文内容配图，不适合商业插画、品牌 KV、PPT 信息图或儿童卡通风格。
每张图只表达一个核心动作、结构、状态或隐喻，不要把大段正文塞进一张图。
视觉固定为纯白背景、黑色手绘细线、大量留白（主体约 40%-60%）和少量红橙蓝中文批注。
安装命令只依据 README 提供的 clone 与 copy 步骤，未涉及任何模型权重或 API 密钥配置。

核心亮点

专为中文内容设计的怪诞手绘插图生成，风格统一（16:9白底、红橙蓝批注），贴合正文配图需求
以 Codex Skill 形式封装，便于集成到 AI Agent 工作流，降低使用门槛
星标近万且持续增长，社区关注度高，验证了细分场景的实用价值

不足之处

文档/社区待观察：项目简介未明确许可证、安装方式或示例输出，上手需自行摸索
依赖特定模型能力（Codex），可能限制在其他平台或自托管环境中的复用

适用场景

中文博客、公众号等自媒体文章的怪诞风格配图生成
需要统一手绘风格插图的批量内容生产（如教程、漫画解说）
AI Agent 自动化创作流程中，按需生成带批注的视觉辅助材料

替代项目

nano-banana、sdxl、flux

项目介绍

ian-xiaohei-illustrations 是图像领域的开源项目，由 helloianneo 开发，是 2026 年新上线的项目。

在全站 13,014 个收录项目中，它的 GitHub 星标数（11,972）位列前 5%，在图像分类的 837 个项目里位列前 2%。

近 44 天，它的 GitHub 星标从 9,215 增加到 11,972，净增 2,757。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-22。从国内网络环境看，可直接访问。

它主要面向的使用场景是：中文博客、公众号等自媒体文章的怪诞风格配图生成。同类可对比的替代方案包括 nano-banana、sdxl、flux。

上一篇：neural-doodle

下一篇：VAR