项目的 README,来自 github.com/anhao/ai-pose-gallery-zh。合并为一个 markdown 文件:README.md。
姿势库(1,439 张素体白模 + 1,439 张深度图 Depth) + 服装库(3,224 套:ギア写实 1,407 + Shisei 中国历代 57 套/227 视角 + ギア动漫 1,320 + CharaDB 二次元 440) + 人像库(1,499 位) = 6,162 条全中文参考数据 / 12,022 张本地高清图,另有 1,760 张来源站点参考图,集成 5 大 AI 图像协议直连工作台 与 原生 ComfyUI 自定义节点插件(
custom_nodes)。



在线演示: https://ai-pose-gallery.anhao.app/ 原始站点:
原有图库作者: ギア(@giaaibusi);二次元服装作者:たき AI(@taki_auto · CharaDB)。 中文版维护: Anhao · X @anhao_ai GitHub: https://github.com/anhao/ai-pose-gallery-zh
⚠️ 免责声明(必读):
- 学习与创作限定:本项目及配套插件/工作流仅供个人学习、人体动态研究、合法艺术创作与技术交流使用,严禁用于任何违反法律法规、生成违法违规/淫秽色情内容或侵害他人合法权益(如未经授权的真人肖像换脸)的用途。
- NSFW 敏感内容提示:图库包含部分 18+ 成人向人体素体姿势与内衣/性感穿搭参考,系统默认开启「安全模式 (SFW)」隐藏,未成年人严禁解锁或访问。
- 来源与版权声明:原有姿势、现实服装、人像参考图源自原作者 ギア(@giaaibusi) 公开站点;440 套二次元服装源自 たき AI(@taki_auto) 的 CharaDB(详见其 LICENSE),版权归各自原作者所有;本仓库仅为中文翻译整理与工程学习存档,禁止将图库图片打包倒卖。使用者因违规使用产生的一切法律责任由使用者本人独立承担。
原站是ギア(@giaaibusi)发布的三大 AI 绘画参考图库(姿势、服装、人像),元数据全部为日文,且分散在三个独立站点。本仓库(v2.0)完成了三站合一、全量中文化、AI 角色合成工作台与 ComfyUI 原生插件升级:
1600×2000 高清 WebP)的全部缩略图与高清原图,支持纯离线浏览与静态托管。Cmd+V / Ctrl+V)或 URL 添加多张自定义附加参考图;custom_nodes) —— 本仓库同时是一个即插即用的 ComfyUI 插件!直接 git clone 到 ComfyUI/custom_nodes/ 即可在 ComfyUI 画布内使用 姿势 / 服装 / 人像 / 三合一角色配方 4 个自定义节点(姿势与配方节点内置 use_depth 深度图切换,可直接接入 ControlNet Depth)与内置的 6,162 条中文可视化弹窗选图器。/poses):4 大体系(全身单人・标准系 / 全身单人・性感系 / 上半身单人 / 双人缠绵)、26 个动作分类、288 组姿势、5 种视角(正面 / 斜前 / 侧面 / 背面 / 俯视),支持按姿势分组 / 逐张浏览双模式、卡片内多角度切换,以及 [ 素体白模 | 深度图 (Depth) ] 一键切换预览与下载。/costumes):8 大穿搭分类(春季 / 夏季 / 秋季 / 冬季 / 内衣・睡衣 / 性感穿搭 / 泳装・度假 / 派对・礼服)、86 个中文细节标签与英文 Prompt 关键词。/portraits):2 大分区(正脸参考 893 / 造型氛围 606)、4 种发长(短发 / 中发 / 中长发 / 长发)、51 种细分发型,支持精选题集与热门榜单一键筛选。/studio)[ 白模 | 深度 ] 实时切换)+ 任意张自定义附加参考图(点击上传、拖拽文件、剪贴板粘贴、填写图片 URL)。1800×1200 Canvas 实时合成),支持一键下载拼图 PNG。gemini-3.1-flash-image-preview、gemini-3-pro-image-preview、gemini-2.5-flash-image(支持宽高比 aspectRatio、分辨率 1K/2K/4K)gpt-image-2.5、gpt-image-2、gpt-image-1.5、gpt-image-1(支持 /v1/images/edits JSON URL 直传 / Multipart 上传、尺寸、质量、背景透明度)qwen-image-3.0-pro、qwen-image-2.1-pro、qwen-image-2.0-pro、qwen-image-edit-plus(支持 multimodal-generation 多图参考输入、智能改写 prompt_extend、水印开关)doubao-seedream-5-0、doubao-seedream-4-5-251128、doubao-seedream-4-0-250828、doubao-seededit-3-0-i2i-250628(支持多图融合 image: [...]、2K/4K 分辨率)/upload/image),注入自定义 API 工作流占位符或自动识别节点提交 /prompt 队列并轮询取回成品图;支持导入/导出通用 .api.json 工作流模板。localStorage 容量限制),支持复用提示词与原图下载。本地 ComfyUI 三图合成(Qwen Image Edit 2509)的模型清单、工作流说明和本地运行方法见 docs/comfyui-local.md。
导入 API 后的动态高级参数、设定集参考上传与可选显示声明见 ComfyUI 工作流高级参数。
WebSocket 实时进度、HTTP 保底与刷新恢复见 ComfyUI 任务连接与恢复。
comfyui_plugin/)将本仓库克隆到 ComfyUI/custom_nodes/ai-pose-gallery-zh 后,ComfyUI 画布右键菜单 「AI角色三合一参考图集」 下自动提供 4 个节点:
PoseGalleryNode):输出 姿势图 (IMAGE)、图片ID、姿势提示词(支持 use_depth 开关一键切换输出素体白模或深度图)CostumeGalleryNode):输出 服装图 (IMAGE)、图片ID、中文服装描述、英文服装PromptPortraitGalleryNode):输出 人像图 (IMAGE)、图片ID、人像发型描述CharacterRecipeNode):单节点同时输出 人像图、服装图、姿势图(支持 use_depth 深度图切换)、三合一拼图 以及自动组装的 中文合成Prompt 与 英文合成Prompt,并内置 **6,162 条中文可视化弹窗选图器(含 🌗 深度图预览开关)**与节点内实时缩略图预览。| 图库 | 分类 / 体系划分 | 记录数 | 本地图片文件数 |
|---|---|---|---|
| 姿势库(Pose 白模) | 全身标准 (365) · 全身性感 (399) · 上半身 (400) · 双人缠绵 (275) | 1,439 | 2,878 张(缩略图 .jpg + 原图 .png) |
| 姿势深度图(Pose Depth) | 与 1,439 条姿势 ID 一一对应(POSE-DB-02) |
1,439(共享索引) | 2,878 张(缩略图 .webp + 原图 .webp) |
| 服装库(ギア写实) | 春季 (215) · 夏季 (254) · 秋季 (244) · 冬季 (253) · 内衣睡衣 (199) · 性感 (140) · 泳装 (54) · 礼服 (48) | 1,407 | 2,814 张(缩略图 .webp + 原图 .webp) |
| 中国历代服装(Shisei) | 商至清代历代服装(正面 / 斜侧 / 侧面 / 背面多视角) | 57(227 视角) | 454 张(缩略图 .webp + 原图 .png) |
| 动漫服装(ギア动漫) | 春季 · 夏季 · 秋季 · 冬季 · 内衣睡衣 · 性感 · 泳装 · 礼服 | 1,320 | 原站热链,仓库与发布包不存图 |
| 二次元服装(CharaDB) | 15类,中文名称与原始Danbooru标签 | 440 | 原站热链,仓库与发布包不存图 |
| 人像库(Portrait) | 正脸参考 (893) · 造型氛围 (606) / 短发 (727) · 中发 (376) · 中长发 (260) · 长发 (136) | 1,499 | 2,998 张(缩略图 .webp + 1600×2000 原图 .webp) |
| 合计 | 3 大图库全中文索引(含白模 + 深度双视图) | 6,162 | 12,022 张 |
无需安装额外 Python 依赖(直接复用 ComfyUI 自带的 torch、numpy、Pillow、aiohttp):
cd /path/to/ComfyUI/custom_nodes
git clone --depth 1 https://github.com/anhao/ai-pose-gallery-zh.git
重启 ComfyUI 后:
IMAGE 张量与中英文 Prompt。如果您使用线上网页端(或本地 pnpm dev)选图,希望直接调用本机 ComfyUI 生图:
python main.py --enable-cors-header "*"
http://127.0.0.1:8188);工作流 -> 导出 (API) 保存的 .json 文件(支持 {{prompt}}、{{seed}}、{{width}}、{{height}}、{{composite_image}}、{{portrait_image}}、{{costume_image}}、{{pose_image}} 占位符,或由系统自动匹配 CLIPTextEncode / KSampler / LoadImage 节点),也可在 「合成台」 一键导出内置通用工作流模板。aiohttp + Pillow + torch) + LiteGraph Frontend Extension.
├── __init__.py # ComfyUI 自定义节点插件根入口 (NODE_CLASS_MAPPINGS / WEB_DIRECTORY)
├── comfyui_plugin/ # ComfyUI 原生插件模块
│ ├── nodes.py # 姿势 / 服装 / 人像 / 三合一角色配方 4 个 ComfyUI 节点实现
│ ├── routes.py # ComfyUI PromptServer 本地目录与图片静态服务路由
│ └── web/ # ComfyUI 画布节点缩略图预览与 4,785 张可视化弹窗选图器 (extension.js / style.css)
├── src/
│ ├── components/ # 通用组件、AppLayout 响应式导航、GalleryLightbox 灯箱、RecipeDock
│ ├── routes/ # 页面路由:概览(index)、姿势(poses)、服装(costumes)、人像(portraits)、合成台(studio)、配置(settings)、指南(guide)
│ ├── services/ # 5 大 AI 图像协议客户端 (aiGenerator.ts) 与 Canvas 拼图合成 (canvasComposer.ts)
│ ├── store/ # 全局配方、生图状态与 IndexedDB 历史管理 (studioStore.tsx)
│ ├── lib/ # 数据加载器 (dataLoader.ts) 与 IndexedDB 工具 (idbStorage.ts)
│ └── types/ # 三库数据结构与 5 大 AI 协议类型定义 (gallery.ts)
├── functions/api/proxy.ts # Cloudflare Pages Functions / Workers 同源 CORS 代理 (/api/proxy)
├── worker.ts # Cloudflare Workers 入口(静态资源 ASSETS + /api/proxy 路由)
├── wrangler.jsonc # Cloudflare Workers 配置文件
├── data/
│ ├── pose.json / pose-zh.json # 姿势库原始数据 & 中文数据(1,439 条)
│ ├── costume.json / costume-zh.json # 服装库原始数据 & 中文数据(1,407 条)
│ ├── portrait.json / portrait-zh.json # 人像库原始数据 & 中文数据(1,499 条)
│ ├── meta-zh.json / *-meta-zh.json # 三库中文体系分类元数据与热门榜单
│ └── translations.csv # 日⇄中翻译对照表
├── thumbs/ # 缩略图目录(姿势根目录 + depth/ + costume/ + portrait/)
├── img/ # 高清原图目录(姿势根目录 + depth/ + costume/ + portrait/)
├── scripts/
│ ├── download.py # 四站并发下载器(支持 DATASET=all|pose|depth|costume|portrait)
│ ├── i18n.py # 日译中词典与人像发型/服装标签映射
│ ├── apply_translation.py# 生成三库 *-zh.json 纯中文数据与检索索引
│ ├── verify.py # 校验本地图片完整性(存在性 / 大小 / 文件头)
│ └── build.sh # 构建 Cloudflare 发布目录 dist/
├── skills/ # Claude Code / Agent 姿势・服装・人像检索技能包
└── README.md
需要 Node.js 20+ 与 pnpm:
# 1. 安装依赖
pnpm install
# 2. 启动本地开发服务器(默认 http://localhost:5173)
pnpm dev
# 3. 类型检查 + 生产构建 + 代码规范检查
pnpm build && pnpm lint
# 拉取/补全三站图片(已存在的文件自动跳过,支持断点续传)
python3 scripts/download.py
WORKERS=64 python3 scripts/download.py # 调整并发线程数
# 修改 scripts/i18n.py 词典后,重新生成三库中文 JSON
python3 scripts/apply_translation.py
# 校验全部图片文件是否完整
python3 scripts/verify.py
本项目自带 wrangler.jsonc 与 worker.ts,同时支持 Cloudflare Workers(含静态 Assets + /api/proxy 同源代理) 与 Cloudflare Pages 部署。仓库总体积约 1.1 GB、总文件数约 11,600 个、单文件全部 < 2 MB,完全符合 Cloudflare 免费版限制(单文件 ≤ 25 MiB,文件数 ≤ 20,000)。
💡 自定义代理域名白名单(可选):
/api/proxy默认放行五大官方 AI 接口域名,并在切换至阿里云百炼(Qwen)或火山方舟(Doubao)时自动开启。若需通过服务端代理转发自定义中转站,可在 Cloudflare 环境变量或wrangler.jsonc的vars.PROXY_ALLOWED_ORIGINS中配置逗号分隔的来源白名单(支持精确域名与泛子域名,如https://api.example.com,https://*.openai.com)。
/api/proxy 解决千问/豆包跨域)# 1. 构建前端与静态资源目录 dist/
bash scripts/build.sh
# 2. 本地或预览环境验证
npx wrangler versions upload
# 3. 正式部署到 Cloudflare Workers
npx wrangler deploy
若使用 Cloudflare Dashboard 连接 GitHub 自动构建 Workers:
bash scripts/build.shnpx wrangler deploy登录 Cloudflare Dashboard → Workers & Pages → Create → Pages → Connect to Git
选择本仓库 → 生产分支 main
构建设置:
| 字段 | 值 |
|---|---|
| Framework preset | None(或 Vite) |
| Build command | bash scripts/build.sh |
| Build output directory | dist |
skills/ 下提供 9 个 SKILL.md 格式的 Agent 技能,让 AI Agent 检索姿势、服装、人像参考。原有技能的 references/catalog.csv 用相对路径(../../img/…)指向本仓库 img/;二次元技能使用原站URL,不重复存图:
| 技能 | 图片数 | 范围 |
|---|---|---|
pose-reference-standard |
365 | 全身单人・标准系 |
pose-reference-upper |
400 | 上半身单人 |
pose-reference-sexy |
399 | 全身单人・性感系(18+) |
pose-reference-couple |
275 | 双人缠绵(18+) |
pose-reference-all |
1,439 | 全部姿势 |
costume-reference |
1,068 | 服装:春夏秋冬・派对礼服・泳装度假(按单品 / 颜色 / 英文关键词检索) |
costume-reference-anime |
440 | CharaDB 二次元服装,联网参考图,独立来源限制 |
costume-reference-sexy |
339 | 服装:内衣睡衣・性感穿搭(18+) |
portrait-reference |
1,499 | 人像:正脸参考・造型氛围,按发长 / 51 种发型检索 |
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/,请软链而不是复制,并保留整个仓库。costume-reference-anime 使用原站URL,不保存图片,且适用独立来源限制。组合参考时须分别遵守各来源条件。
新增 たき AI(@taki_auto) CharaDB 公开版 440 套二次元服装:服装页与 ComfyUI 选图器均支持按 [ 全部 | 现实 | 二次元 ] 一级分类、15 个二级分类及单品颜色标签筛选,支持中文名称、英文 Danbooru 标签和编号检索。
data/costume-anime-zh.json),图片直接从原站在线加载,不随本仓库打包分发。python3 scripts/import_charadb.py
ai-pose-gallery.pages.dev)、服装(ai-costume-gallery.pages.dev)、人像(ai-portrait-gallery.pages.dev,CC0 1.0 协议)图片与原始数据的著作权归原作者 ギア(@giaaibusi) 所有。src/)、ComfyUI 插件(comfyui_plugin/)与数据处理脚本(scripts/)以 MIT 协议 开源;该协议不覆盖 img/、thumbs/ 与 data/ 中的图片及原始数据。