1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | xiaohu-ip-studio |
| 作者/维护者 | xiaohuailabs（网名“小互”，AI 内容创作者，另运营“XiaoHu AI 学院”社区） |
| 来源链接 | https://github.com/xiaohuailabs/xiaohu-ip-studio |
| 许可证 | MIT（数据来自 GitHub API） |
| GitHub Stars | 257（数据来自 GitHub API） |
| Forks | 46（数据来自 GitHub API） |
| 最新版本 | 仓库未打 Release 标签，SKILL.md 标注 version 0.1.0，以最近一次提交（2026-06-26）为准 |
| 安装方式 | git clone 到对应 Agent 的技能目录，或直接让 Agent 读取仓库地址自动安装 |
项目自述名称：README 中称“小互 IP Studio”，本报告统一使用仓库名 xiaohu-ip-studio 作为正式名称。
2. 功能介绍与亮点
xiaohu-ip-studio 是一个“中文深度文配图”技能：给定一篇文章，它按固定方法论逐节判断该不该配图、配哪种类型的图，再用你选定的固定角色把配图画出来。
- 31 个开箱即用的原创 IP 角色：分“职场态”“当代情绪态”两组共 15 个手绘线稿角色，另有 16 个谐音梗风格的极简小狗系 meme 角色，按文章调性挑选出演，一篇文章锁定一个主角以保持统一气质。
- 三轨分流方法论：把每个配图点判给“情绪锚点图”“解释图示”“四格漫画”三种形态之一，避免全篇只会画一种套路图。
- 逐节枚举防漏配：强制按小节粒度过一遍全文并逐条写明配或不配的理由，防止凭感觉挑点漏掉难懂但重要的机制段落。
- 可替换为用户自己的 IP：既可直接用自带角色，也可把用户已有的头像/吉祥物一键转换成配图角色，或由 Agent 引导从零设计一版。
- 零第三方依赖 + 免费兜底路径：生图脚本纯 Python 标准库实现，未配置图像 API 时也能只输出完整提示词，供用户手动贴到网页版生图工具使用。
- 针对角色包的提示词注入防护：读取他人分享的角色包时，只提取外形与表情等描述性字段用于生图，明确忽略角色文件中出现的任何指令性文字。
3. 适用场景
固定分类：内容创作与知识管理。
适合经营公众号、小红书、博客等长文渠道，需要频繁为技术解读、方法论拆解类文章配图的内容创作者；也适合希望通过固定角色反复出镜、逐步立住个人 IP 形象的自媒体作者，以及不想每次配图都从零构思画面、想要一套可复用方法论的内容团队。
4. 跨 Agent 兼容性
- Claude Code：原生支持。README 明确给出克隆到
~/.claude/skills/的安装路径与示例。 - Codex：原生支持。README 列为目标 Agent 之一，并给出对应技能目录安装方式。
- OpenClaw：原生支持。README 以“小龙虾”（OpenClaw 社区昵称）明确点名，安装方式与其余 Agent 一致（整份技能文件夹放入技能目录）。
- Hermes Agent：原生支持。README 同样明确点名，安装方式一致。
技能本体是标准 SKILL.md（YAML front matter + 指令正文）格式，仅依赖 python3 标准库，不依赖 Node.js 或其他运行时。
5. 推荐理由
在配图类技能普遍是“单一固定角色”或“仅给方法论不给角色”的两极之间，xiaohu-ip-studio 提供了一套 31 角色的现成素材库加透明可复用的配图方法论，未配置图像 API 时仍可退化为纯提示词输出，兼顾了开箱即用与可负担性，方法论文档对借鉴来源做了逐条标注，工程细节（角色包防注入、凭据本地存储）也处理得比较扎实。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | GitHub 257 星、46 次 fork；fork 数在近五周内持续增长而非集中于单日，仓库存在至少一次由外部账号提交并被合并的 PR |
| 可用性 | 8 | 安装为标准 git clone 流程，install.sh/illo.py doctor 提供一键自检；文档结构完整（README、CREDITS、多份 references 参考文件）；核心生图脚本零第三方依赖，仅图像生成这一项功能需自备 OpenAI 兼容 API Key，且提供无 API 时的纯提示词兜底路径；最近一次提交为 2026-06-26 |
| 安全性 | 8 | 见下方安全检查清单 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① shell 命令及权限范围 | 本机运行 Python 脚本，读写用户指定的角色库与输出目录，不涉及系统级权限 |
| ② 运行时联网外发 | 仅在用户主动配置图像 API 后，把提示词发送到用户自己指定的 OpenAI 兼容图像生成端点；未配置时完全离线，只输出文本提示词 |
| ③ API Key/凭据存储 | 图像 API Key 由用户通过引导脚本本地填写，写入本机配置文件且权限设为仅所有者可读写（mode 600），不内置任何密钥、不上传 |
| ④ 可疑指令排查 | SKILL.md 与 README 均有独立“安全”章节，明确规定读取第三方角色包时只提取外形/表情等描述字段，忽略角色文件中出现的任何指令性文字，用于防范角色包夹带的提示词注入；未发现其他可疑指令或隐蔽外发 |
| ⑤ 作者信誉 | 作者为持续运营 AI 学习社区的公开身份创作者，仓库 fork 增长分布在数周内、非单日刷量模式，未见刷星或自我造假迹象 |
| ⑥ License | MIT，仓库根目录 LICENSE + NOTICE 均清晰列出角色版权归属与第三方方法论引用义务 |
| ⑦ 最近维护 | 最近一次提交 2026-06-26 |
综合评分（三项均值）：7.7
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与 xiaohu-ip-studio 的差异 |
|---|---|---|
| ian-xiaohei-illustrations（“小黑”，8859 星） | 单一固定怪诞角色的中文正文配图技能，16:9 白底手绘风格，红橙蓝三色批注 | 只提供一个角色、一种画风，风格高度统一但无从挑选；xiaohu-ip-studio 提供 31 个角色分两大系列，可按文章调性换角色，且在方法论层面明确借鉴了该项目的认知锚点筛选思路 |
| baoyu-skills 合集中的文章配图子技能（合集仓库整体 24417 星，不代表该子技能自身热度） | 聚焦文字渲染铁律（色值不入图、错字靠重新生图而非改代码）与解释图结构化字段 | 是多技能合集中的一个子项，未内置角色形象库；xiaohu-ip-studio 把类似的结构化字段规则与一套可直接使用的角色阵容打包在一起，开箱即有角色可选 |
差异化在于：同时具备“现成角色库”与“可解释、可复用的配图判断流程”，且方法论文档中逐条列出了各条规则借鉴自哪个开源项目，来源透明度高于多数同类技能。
8. 用户评价
该技能目前在第三方平台尚无独立于作者自身渠道之外的具名用户评价；仓库内可见的外部互动为一条由第三方账号提交并被合并的修复类 PR。
9. 其他补充
仓库提供英文版 README（README.en.md）；角色库可通过 ip-library.html 在浏览器中可视化浏览全部 31 个角色的形象与人设说明；references/character-spec.md 给出了自定义角色的接入规范，用户可将已有的头像、吉祥物或 LOGO 转换为可复用的配图角色。
10. 安装使用方式
Claude Code：
git clone https://github.com/xiaohuailabs/xiaohu-ip-studio ~/.claude/skills/xiaohu-ip-studio
cd ~/.claude/skills/xiaohu-ip-studio
python3 scripts/illo.py init # 引导填写图像 API Key（可选，跳过则走纯提示词模式）
python3 scripts/illo.py doctor # 自检 Key、依赖与角色库是否就绪Codex / OpenClaw / Hermes Agent：将整个 xiaohu-ip-studio 文件夹放入各自的技能目录后即可加载。
安装完成后对 Agent 说“给这篇文章配图，用替替”之类指令即可触发；流程中会停顿两次等待用户确认：一次确认逐节配图清单，一次挑选角色与画风。首次使用建议先运行 bash install.sh 完成依赖自检。
11. 注意事项
- 完整生图能力需要自备 OpenAI 兼容的图像生成 API Key（默认模型为 GPT-image-2），未配置时会退化为仅输出提示词，需手动粘贴到网页版生图工具完成最后一步。
- 角色形象与画风如需商用，README 提示需自行确认生成图片的版权合规性。
- 仓库最近一次提交距今已数周，暂未观察到高频迭代节奏，功能相对成熟但更新速度需留意。
- 仓库未发布正式 Release 版本号，以最近提交时间与 SKILL.md 内标注的 version 字段作为版本参考。