ai-pose-gallery-zh README

The project's README from github.com/anhao/ai-pose-gallery-zh. As one markdown file: README.md.

AI 角色参考与合成工作台 · 中文版(3合1)

姿势库(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)。

画廊总览预览

AI 角色合成台预览

手机端预览

手机端预览

在线演示: https://ai-pose-gallery.anhao.app/ 原始站点:

原有图库作者: ギア(@giaaibusi);二次元服装作者:たき AI(@taki_auto · CharaDB)。 中文版维护: Anhao · X @anhao_ai GitHub: https://github.com/anhao/ai-pose-gallery-zh

⚠️ 免责声明(必读):

  1. 学习与创作限定:本项目及配套插件/工作流仅供个人学习、人体动态研究、合法艺术创作与技术交流使用,严禁用于任何违反法律法规、生成违法违规/淫秽色情内容或侵害他人合法权益(如未经授权的真人肖像换脸)的用途。
  2. NSFW 敏感内容提示:图库包含部分 18+ 成人向人体素体姿势与内衣/性感穿搭参考,系统默认开启「安全模式 (SFW)」隐藏,未成年人严禁解锁或访问。
  3. 来源与版权声明:原有姿势、现实服装、人像参考图源自原作者 ギア(@giaaibusi) 公开站点;440 套二次元服装源自 たき AI(@taki_auto) 的 CharaDB(详见其 LICENSE),版权归各自原作者所有;本仓库仅为中文翻译整理与工程学习存档,禁止将图库图片打包倒卖。使用者因违规使用产生的一切法律责任由使用者本人独立承担。

这是什么

原站是ギア(@giaaibusi)发布的三大 AI 绘画参考图库(姿势、服装、人像),元数据全部为日文,且分散在三个独立站点。本仓库(v2.0)完成了三站合一、全量中文化、AI 角色合成工作台与 ComfyUI 原生插件升级:

  1. 三库四站全量本地镜像(11,568 张图) —— 完整收录姿势库(素体白模 2,878 张 + 深度图 Depth 2,878 张 WebP)、服装库(2,814 张 WebP)、人像库(2,998 张,全尺寸 1600×2000 高清 WebP)的全部缩略图与高清原图,支持纯离线浏览与静态托管。
  2. 原有图库全中文元数据 —— 动作体系、姿势分类、服装款式、穿搭标签、人像分区、发长与 51 种细分发型全部译为地道中文,自动组装的生图提示词纯净无日文干扰。
  3. 三合一 AI 角色合成工作台(Web Studio) —— 基于 React 19 + Tailwind CSS 4 + TypeScript 7 + shadcn/ui + TanStack Router 构建的响应式多页面应用(兼容 PC / 平板 / 手机):
    • 从三大图库任意挑选 人像 + 服装 + 姿势(支持素体白模 / 深度图一键切换) 组合配方,或一键随机捏人;
    • 支持拖拽、剪贴板粘贴(Cmd+V / Ctrl+V)或 URL 添加多张自定义附加参考图;
    • 内置 5 大 AI 图像协议直连(Google Gemini、OpenAI GPT Image、阿里云百炼 Qwen、字节火山方舟 Doubao、本地 ComfyUI),生成记录通过 IndexedDB 本地持久化保存。
  4. 原生 ComfyUI 自定义节点插件(custom_nodes) —— 本仓库同时是一个即插即用的 ComfyUI 插件!直接 git clone 到 ComfyUI/custom_nodes/ 即可在 ComfyUI 画布内使用 姿势 / 服装 / 人像 / 三合一角色配方 4 个自定义节点(姿势与配方节点内置 use_depth 深度图切换,可直接接入 ControlNet Depth)与内置的 6,162 条中文可视化弹窗选图器。

核心功能

1. 三大参考图库(姿势 / 服装 / 人像)

2. AI 角色合成台(/studio)

本地 ComfyUI 三图合成(Qwen Image Edit 2509)的模型清单、工作流说明和本地运行方法见 docs/comfyui-local.md。

导入 API 后的动态高级参数、设定集参考上传与可选显示声明见 ComfyUI 工作流高级参数。

WebSocket 实时进度、HTTP 保底与刷新恢复见 ComfyUI 任务连接与恢复。

3. ComfyUI 原生自定义节点插件(comfyui_plugin/)

将本仓库克隆到 ComfyUI/custom_nodes/ai-pose-gallery-zh 后,ComfyUI 画布右键菜单 「AI角色三合一参考图集」 下自动提供 4 个节点:


数据规模

图库 分类 / 体系划分 记录数 本地图片文件数
姿势库(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 张

在 ComfyUI 中使用(双模式支持)

模式 A:作为 ComfyUI 原生插件安装(在 ComfyUI 画布内选图)

无需安装额外 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 后:

  1. 在画布空白处右键 → 新建节点 → AI角色三合一参考图集;
  2. 选择 「AI 角色三合一合成配方 (3-in-1 Recipe)」 或单个姿势 / 服装 / 人像节点;
  3. 点击节点上的 「🎨 打开三合一选图器 (6,162张)」 按钮(或直接点击节点上的缩略图),即可在弹窗中按分类、视角、发长筛选或中文搜索,一键填入节点并输出 IMAGE 张量与中英文 Prompt。

模式 B:从 Web 合成台直连本地 ComfyUI API

如果您使用线上网页端(或本地 pnpm dev)选图,希望直接调用本机 ComfyUI 生图:

  1. 启动本地 ComfyUI 时开启跨域参数:
    python main.py --enable-cors-header "*"
    
  2. 打开本工作台 「接口配置」 页面 → 切换到 「本地 ComfyUI」 → 点击「检测连接」(默认 http://127.0.0.1:8188);
  3. 可直接导入您在 ComfyUI 中通过 工作流 -> 导出 (API) 保存的 .json 文件(支持 {{prompt}}、{{seed}}、{{width}}、{{height}}、{{composite_image}}、{{portrait_image}}、{{costume_image}}、{{pose_image}} 占位符,或由系统自动匹配 CLIPTextEncode / KSampler / LoadImage 节点),也可在 「合成台」 一键导出内置通用工作流模板。

技术栈与目录结构

.
├── __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

数据与图片维护脚本(Python 3)

# 拉取/补全三站图片(已存在的文件自动跳过,支持断点续传)
python3 scripts/download.py
WORKERS=64 python3 scripts/download.py   # 调整并发线程数

# 修改 scripts/i18n.py 词典后,重新生成三库中文 JSON
python3 scripts/apply_translation.py

# 校验全部图片文件是否完整
python3 scripts/verify.py

部署到 Cloudflare(Workers / Pages)

本项目自带 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)。

方式一:Cloudflare Workers 自动/命令行部署(推荐,内置 /api/proxy 解决千问/豆包跨域)

# 1. 构建前端与静态资源目录 dist/
bash scripts/build.sh

# 2. 本地或预览环境验证
npx wrangler versions upload

# 3. 正式部署到 Cloudflare Workers
npx wrangler deploy

若使用 Cloudflare Dashboard 连接 GitHub 自动构建 Workers:

方式二:Cloudflare Pages 部署

  1. 登录 Cloudflare Dashboard → Workers & Pages → Create → Pages → Connect to Git

  2. 选择本仓库 → 生产分支 main

  3. 构建设置:

    字段 值
    Framework preset None(或 Vite)
    Build command bash scripts/build.sh
    Build output directory dist

Agent 技能(Skills)

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,不保存图片,且适用独立来源限制。组合参考时须分别遵守各来源条件。


二次元服装(CharaDB)

新增 たき AI(@taki_auto) CharaDB 公开版 440 套二次元服装:服装页与 ComfyUI 选图器均支持按 [ 全部 | 现实 | 二次元 ] 一级分类、15 个二级分类及单品颜色标签筛选,支持中文名称、英文 Danbooru 标签和编号检索。

免责声明与版权说明(Disclaimer)

  1. 合法合规与学习用途声明(严禁违法)
    • 本项目(含前端工作台、ComfyUI 插件、工作流模板及 Agent 技能)仅供个人学习、人体结构研究、绘画动作参考与技术交流使用。
    • 严禁将本项目用于任何违法违规用途,包括但不限于生成制作传播淫秽色情物品、暴力恐怖内容、虚假违法信息,或未经他人明确授权使用真实人物照片进行换脸/深伪合成(Deepfake)等侵犯他人肖像权、隐私权与名誉权的行为。
    • 本工作台为纯前端/本地工具,所有 AI 生图请求均由使用者自行配置的云端 API 或使用者本机 ComfyUI 环境执行,平台不收集、不存储任何用户上传的图片或生成结果。使用者对其上传素材及生成内容承担全部法律责任,本仓库作者及贡献者不对使用者的任何不当或违法行为承担责任。
  2. NSFW(18+)敏感内容声明
    • 图库中包含部分成人向 3D 素体姿势(全身单人・性感系、双人缠绵)及性感/内衣穿搭参考,旨在服务插画师与创作者的人体动态与光影练习。
    • 站点与插件默认开启 「安全模式 (SFW)」 屏蔽上述分类;未满 18 周岁的未成年人严禁关闭安全模式或访问相关内容。
  3. 数据来源与版权归属声明
    • 本仓库原有姿势(ai-pose-gallery.pages.dev)、服装(ai-costume-gallery.pages.dev)、人像(ai-portrait-gallery.pages.dev,CC0 1.0 协议)图片与原始数据的著作权归原作者 ギア(@giaaibusi) 所有。
    • 本仓库仅为中文本地化翻译与前端工程实践存档,不对原始图片主张任何权利,严禁任何人将本仓库图片提取后进行商业倒卖或付费分发。若原作者对镜像存档有任何异议,请联系维护者立即处理。
  4. 开源协议
    • 前端应用代码(src/)、ComfyUI 插件(comfyui_plugin/)与数据处理脚本(scripts/)以 MIT 协议 开源;该协议不覆盖 img/、thumbs/ 与 data/ 中的图片及原始数据。

ai-pose-gallery-zh (anhao/ai-pose-gallery-zh)

chinese-localization
Searching Database…

What is this?A Chinese-translated, zero-dependency static gallery of AI pose reference images (originally Japanese), packaged with a build script that produces a ready-to-deploy static site for hosts like Cloudflare Pages.
How do I deploy this gallery?Run scripts/build.sh, which copies index.html, the headers file, data/, thumbs/ and img/ into a dist/ folder; then deploy dist/ to a static host such as Cloudflare Pages via the dashboard or its CLI.
Do I need to install any packages to run it?No build tools or runtime dependencies are needed beyond running the included shell script — it's advertised as a zero-dependency static gallery.
What's the main deployment pitfall I should avoid?Don't set the Cloudflare Pages build output directory to the repo root: the repo's .git folder is hundreds of MB, Cloudflare scans it as static assets, and pack files over the 25 MiB single-file limit will break the build. A .assetsignore file is included to exclude non-site files if you insist on using the root.
Is this gallery safe for all audiences?No — it explicitly contains adult-oriented pose references, with some category names using sexual terminology, and is intended only for art study and frontend practice, not for minors.
Where do the original pose images and data come from?They're translated from a Japanese pose-reference project credited to an artist named 'ギア'; this repo only adds Chinese localization, build scripts and static-site packaging, and credits the original source at the top of the page.
How big is the gallery, and does it fit Cloudflare's limits?It covers 1439 pose categories with 2878 images; the largest file is 917 KB and the repo has 2883 files total, comfortably within Cloudflare Pages' 25 MiB per-file and 20,000-file per-deploy limits.
Will images reload slowly after the first visit?No, the deployment headers configure a one-year strong cache for img/ and thumbs/, so images aren't re-fetched on repeat visits.
Creator
anhao
Size
1.1 GB
Stars
7.2K
Updated
CommitNov 04
Age
22d
Commits · 90 Days