AI 绘画姿势参考难找？开源中文图库 6162 条数据，ComfyUI 插件直连生图

大家好，本文将围绕开源项目 ai-pose-gallery-zh（中文版 AI 绘画姿势参考图库）展开，涵盖它的数据规模、AI 角色合成台、ComfyUI 插件接入与部署方案，希望能给正在玩 AI 生图的朋友带来一些实用的参考。无论你是插画师、ComfyUI 用户，还是刚入门的新手，希望你都能有所收获！

参考资料

• 在线演示站：https://ai-pose.dooo.fun/

用 AI 生图的同学大概率被三个问题卡过：想让人物摆一个具体动作，提示词描述半天模型画不对；想找姿势参考图，搜到的图库要么元数据全是日文，要么姿势、服装、人像分散在三个站里来回切换；好不容易凑齐参考图，还得自己手动拼图、手动写结构化提示词。今天分享的这个开源项目就是冲着这条"流水线"来的：把姿势、服装、人像三大参考图库三站合一并全部翻译成中文，配一个能一键组合参考图并直连生图接口的 Web 合成台，再附带一个能在 ComfyUI 画布里直接选图的原生插件。

先说三个关键前提：数据全部本地化、合成台是纯前端应用不上传你的图片、ComfyUI 插件零额外 Python 依赖。下面逐个拆开讲。

一、它到底是什么：三库合一 + 合成台 + ComfyUI 插件

原站是日本作者 ギア（@giaaibusi）发布的三大 AI 绘画参考图库（姿势、服装、人像），元数据全部是日文，且分散在三个独立站点。开源项目 ai-pose-gallery-zh（v2.0）在这个基础上完成了三件事：

1. 三库四站全量本地镜像：完整收录姿势库（素体白模 + 深度图）、服装库、人像库的全部缩略图与高清原图，支持纯离线浏览与静态托管；
2. 全中文元数据：动作体系、姿势分类、服装款式、穿搭标签、人像分区、发长与 51 种细分发型全部译为中文，自动组装的生图提示词纯净无日文干扰；
3. 两条生图通路：Web 端「AI 角色合成台」直连 5 大 AI 图像协议，ComfyUI 端提供 4 个原生自定义节点。

也就是说，它不只是"翻译了几个图库"，而是把选参考图 → 组合配方 → 生成提示词 → 调用生图模型这条链路整个打通了。在线演示站和仓库地址放在文末参考资料，你可以先打开演示站感受一下整体布局。

打开首页就能看到三大图库的统计卡片和热门榜单，左侧是工作台导航，底部常驻一个"角色配方槽"，选好的参考图会挂在里面随时进入合成台。

二、数据规模：6162 条中文数据、12022 张本地高清图

先上总表，这是整个项目最有分量的部分：

几个值得展开的点：

• 深度图是亮点。1,439 组姿势每组都带一张对应的 Depth 深度图，在画廊里点一下 [ 素体白模 | 深度图 ] 就能切换预览与下载。做 ComfyUI 工作流的同学都知道，深度图是 ControlNet Depth 的标准输入，以前要么自己跑模型提取，要么在英文站里翻找，现在这批数据是现成的、和姿势一一对应的。
• 中国历代服装是本地化独有内容。57 套商至清代服装、227 个视角，做古风题材时非常好用。
• 姿势组织方式很细：4 大体系、26 个动作分类、288 组姿势、5 种视角（正面/斜前/侧面/背面/俯视），支持按姿势分组或逐张浏览，卡片内可直接切换角度。
• 人像库按发型检索：短发/中发/中长发/长发 4 种发长 + 51 种细分发型，还有精选题集和热门榜单。

三、AI 角色合成台：人像 + 服装 + 姿势一次配齐

这是 v2.0 新增的核心模块，基于 React 19 + Tailwind CSS 4 + TypeScript + shadcn/ui 构建的响应式应用，PC、平板、手机都能用。

工作流是这样的：

1. 3+N 参考图组合：三个核心槽位分别放人像、服装、姿势（姿势槽位内置白模/深度图实时切换），支持一键"随机捏人"，也可以拖拽文件、剪贴板 Ctrl+V 粘贴、填 URL 添加任意张自定义附加参考图；
2. 参考拼图预览与导出：系统会把三张参考图 Canvas 实时合成一张 1800×1200 的高清拼图，可一键下载 PNG；
3. 自动组装结构化提示词：内置 12 种画风预设（写实人像写真、日系二次元插画、新海诚感动画电影、3D 潮玩手办、赛博朋克霓虹、角色设定集立绘等），根据已选素材自动生成中英文提示词，你可以在输入框里继续手改；
4. 直连生图：点「生成角色图」直接调用你配置的生图接口，生成记录存入浏览器 IndexedDB，切换页面不中断任务，历史记录可复用提示词与原图下载。

5 大 AI 图像协议支持情况如下：

API Key 在「API 接口配置」页里填，全部保存在本地浏览器，不存在服务端。

手机端做了完整适配，通勤路上翻翻姿势库攒配方也够用。

四、ComfyUI 接入：插件模式与 API 直连模式

这是 ComfyUI 用户最关心的部分，项目给了两条路线，按需选择。

4.1 模式 A：作为 ComfyUI 原生插件安装（画布内选图）

无需安装任何额外 Python 依赖，直接复用 ComfyUI 自带的 torch、numpy、Pillow、aiohttp。把仓库克隆进 custom_nodes 目录：

cd /path/to/ComfyUI/custom_nodes
git clone --depth 1 https://github.com/anhao/ai-pose-gallery-zh.git

重启 ComfyUI 后，在画布空白处右键 → 新建节点 → 「AI 角色三合一参考图集」，可以看到 4 个节点：

• AI 姿势参考图：输出姿势图（IMAGE）、图片 ID、姿势提示词，带 use_depth 开关一键切换白模或深度图；
• AI 服装参考图：输出服装图、图片 ID、中文服装描述、英文服装 Prompt；
• AI 人像参考图：输出人像图、图片 ID、人像发型描述；
• AI 角色三合一合成配方：单节点同时输出人像、服装、姿势（支持深度图切换）、三合一拼图以及自动组装的中英文合成 Prompt。

每个节点内置中文可视化弹窗选图器，按分类、视角、发长筛选或直接中文搜索，选好后一键填入节点，图片直接以 IMAGE 张量输出——也就是说姿势图可以无缝接进 ControlNet Depth，服装和人像图可以接 IPAdapter 或多图参考类工作流，整个选图过程不用离开 ComfyUI。

4.2 模式 B：Web 合成台直连本地 ComfyUI API

如果你习惯用网页端选图，想调用本机 ComfyUI 生图，只需两步。

第一步，启动 ComfyUI 时开启跨域头：

python main.py --enable-cors-header "*"

第二步，打开合成台的「API 接口配置」→ 切到「本地 ComfyUI」→ 点「检测连接」（默认 http://127.0.0.1:8188）。

工作流模板支持你在 ComfyUI 里通过「工作流 → 导出（API）」保存的 .json 文件，内置占位符注入：

• { {prompt}} / { {seed}} / { {width}} / { {height}}：常规参数；
• { {composite_image}} / { {portrait_image}} / { {costume_image}} / { {pose_image}}：三合一拼图与单张参考图。

系统会自动匹配工作流里的 CLIPTextEncode、KSampler、LoadImage 节点完成注入，也支持手动指定节点 ID。连接方式上 WebSocket 实时进度 + HTTP 轮询双保险，刷新页面后任务可恢复。

五、本地开发与部署

前端工程需要 Node.js 20+ 与 pnpm：

# 安装依赖
pnpm install

# 启动本地开发服务器（默认 http://localhost:5173）
pnpm dev

# 类型检查 + 生产构建
pnpm build

图片与数据维护脚本是一套 Python 3 工具链，思路很工程化：

python3 scripts/download.py          # 四站并发下载，断点续传，WORKERS=64 可调并发
python3 scripts/apply_translation.py # 修改 i18n 词典后重新生成三库中文 JSON
python3 scripts/verify.py            # 校验全部图片完整性（存在性/大小/文件头）

想把它挂成自己的在线站，项目自带 wrangler.jsonc 与 worker.ts，支持 Cloudflare Workers 与 Pages 两种部署。仓库总体积约 1.1 GB、约 11,600 个文件、单文件全部小于 2 MB，正好卡在 Cloudflare 免费版限制（单文件 ≤ 25 MiB、文件数 ≤ 20,000）之内：

# 构建发布目录 dist/
bash scripts/build.sh

# 部署到 Cloudflare Workers
npx wrangler deploy

Workers 版还内置了 /api/proxy 同源 CORS 代理，用于解决 Qwen、Doubao 这两家接口的浏览器跨域限制，默认放行五大官方接口域名，也支持在环境变量里配置自定义中转站白名单。

六、Agent Skills：给 Claude Code 装一个"姿势检索器"

项目还带了 9 个 SKILL.md 格式的 Agent 技能包，按姿势体系（全身标准/上半身/性感系/双人/全部）、服装（写实/动漫/二次元）、人像拆分，装好之后 Claude Code 这类 Agent 可以直接按中文关键词检索本地图片库、返回参考图路径。

git clone --depth 1 https://github.com/anhao/ai-pose-gallery-zh.git ~/ai-pose-gallery-zh
mkdir -p ~/.claude/skills
for d in ~/ai-pose-gallery-zh/skills/*-reference*; do ln -s "$d" ~/.claude/skills/; done

注意要用软链接而不是复制——技能靠相对路径读取仓库 img/ 目录，软链后保留整个仓库即可正常工作。这个设计对"让 Agent 画图前先查参考"的自动化流程挺友好，比如可以让 Claude Code 检索一个"坐姿、正面、长发"的姿势组合，再把图片路径和中文提示词喂给生图工作流。

七、使用前必须知道的几点（避坑）

1. 用途边界：项目仅供个人学习、人体动态研究、合法艺术创作与技术交流，严禁用于违法违规内容生成，严禁未经授权对真人照片做换脸/深伪合成。工具本身不收集不上传任何图片，责任边界写得非常清楚；
2. 安全模式：图库包含部分成人向素体姿势与性感穿搭参考，系统默认开启「安全模式（SFW）」隐藏这些分类，未成年人严禁解锁。用的时候别手贱关了截图发群里；
3. 版权归属：姿势、服装、人像原图版权归原作者 ギア 与 たき AI 所有，本仓库只是中文翻译整理与工程学习存档，禁止把图片打包倒卖；前端代码、ComfyUI 插件与脚本是 MIT 协议，但不覆盖 img/、thumbs/ 与 data/ 里的图片数据；
4. 跨域报错先查启动参数：Web 合成台连不上本地 ComfyUI，九成是启动时忘了加 --enable-cors-header "*"，改完记得重启 ComfyUI；
5. 仓库体积：完整克隆约 1.1 GB，网络不好务必用 --depth 1 浅克隆，只要前端不用数据也可以只拉 src/ 部分自行构建。

八、总结

最后用几条要点收束全文：

• ai-pose-gallery-zh 是一个三库合一的中文 AI 绘画参考库：姿势 1,439 组（白模 + 深度图）、服装 3,224 套（含中国历代服装）、人像 1,499 位，合计 6,162 条全中文数据、12,022 张本地高清图；
• 深度图与姿势一一对应，可直接作为 ControlNet Depth 的标准输入，省去自己提取深度的环节；
• Web 合成台支持人像 + 服装 + 姿势 3+N 组合、12 种画风预设自动组装提示词，直连 Gemini、GPT Image、Qwen、Doubao 与本地 ComfyUI 五大生图协议，记录本地 IndexedDB 持久化；
• ComfyUI 插件零 Python 依赖，4 个节点在画布内直接选图输出 IMAGE 张量，另有 API 直连模式支持工作流占位符注入；
• 部署门槛低：本地 pnpm dev 即起，Cloudflare Workers/Pages 免费额度可托管整套 1.1 GB 站点，还附带 9 个 Agent Skills。

如果你正在搭一套自己的 AI 绘画参考与生图工作流，这个项目可以直接进候选清单。欢迎在评论区聊聊你现在用的是什么姿势参考方案，或者部署时踩到什么坑。

常见问题 FAQ

Q1：项目收费吗？需要什么环境？
完全免费开源（代码 MIT 协议）。直接用在线演示站零环境；本地跑前端需要 Node.js 20+ 与 pnpm；ComfyUI 插件模式不需要任何额外 Python 依赖。

Q2：必须配置 API Key 才能用吗？
分场景：只浏览三大图库不需要任何 Key；用合成台云端生图需要自行在配置页填对应平台的 API Key（Gemini / OpenAI / 百炼 / 火山方舟任选）；走本地 ComfyUI 则完全不需要云端 Key。

Q3：数据还有日文残留吗？
三大图库的动作体系、姿势分类、服装标签、人像发型已全部翻译为中文，自动组装的提示词是纯中文结构化的；二次元服装保留了原始英文 Danbooru 标签便于精确检索，属于刻意保留的双语设计。

Q4：图库里的内容都适合公开场合使用吗？
不是。部分成人向素体姿势与性感穿搭参考默认被「安全模式（SFW）」隐藏，适合在公开环境直接使用的是默认可见的分类；请在合规前提下使用，未成年人不可解锁相关内容。

Q5：可以把这些图片打包分发或商用吗？
不可以。原图版权归 ギア 与 たき AI 所有，仓库仅作中文本地化存档，明确禁止打包倒卖与付费分发；商用与再分发条款以各原作者 LICENSE 为准。