wzc520pyfm/gen-ai-pose-image

English

澜姿

可选的 ComfyUI 浏览器直连：在在线网站填写本机或远程 HTTPS 地址，用一套带开关的工作流完成换装、姿势、组合生成及逐格拼图，无需在显卡电脑启动网站。原云端功能保留，详见连接与工作流说明。

DeepSeek Harness 插件，也是一个可以单独打开的姿势工作室。从 ai-pose-gallery-zh 的 288 组、1439 张姿势线稿里选一个或多个姿势，生成同一位模特的图。

默认模特是 大肥鱼：社区鲸鱼娘的成年形象，长波浪蓝发、鲸耳、蓝鲸尾，穿海军蓝与白色女仆装。参考图用的是 TreapGoGo 的 deepseek-whale-girl 里的 dafeiyu-mature-character-sheet.png。可以导入最多三张别的模特照片，用来替换脸和衣服。姿势图只提供身体姿态，默认不会把线稿里的空白身体画进成图。

姿势线稿不在这个仓库里。页面会按需读取公开图床 ai-pose-gallery.anhao.app。图片与原始数据的著作权归 ギア 所有，中文译名来自 Anhao 的图库。

服装来自 ギア 的 衣装集 COSTUME-DB-01，共 1407 套，图里没有人物。页面按需读取该站点的缩略图，本仓库只保存编号和关键词。选中一套之后，生图会换成这身衣服，并保留角色的脸、发型、鲸耳和鲸尾。内衣、泳装和性感分类跟成人向姿势共用同一个开关。

脸部参考同样来自 ギア 的 AI 模型脸数据库，共 1499 张，许可是 CC0。分区是脸部特写和造型，可以按发长筛选。中文分区和造型名参考 sleepy-zone/ai-ref-library-cn，图像作者仍是ギア。本仓库只保存编号、标签和公开图地址，缩略图和原图按需从原站读取。选中一张之后，生图把它当作脸部和表情参考：五官、表情、脸型和发型跟这张图，姿势和服装仍按各自的参考，鲸耳和鲸尾保留。脸库没有单独的成人向分类。

效果

同一套站立姿势「站立・对立式平衡・手扶腰」。第一张保持女仆装，第二张换成衣装集 SPR-0001。

选了「女孩坐・双手抱头后」，并换成 SPR-0045 之后，成图出现在右侧。

窄屏时模特收在顶上，分类用下拉，出图按钮留在底部。

服装分类会换行，卡片说明留在屏幕里。

装进 Harness 之后，左侧栏是「澜姿 / 工作室」。点开后用的是同一套工作室：模特、姿势、服装、生图设置和出图都在这一页里。面板够宽时仍是三栏；窄面板收成一列，出图按钮留在底部。

本地工作室

需要 Node.js 22.19 或更新版本。

npm install
npm run dev

打开 http://127.0.0.1:43123。

1. 在中间点选姿势，可以多选。标准全身是默认页；性感系和双人姿势需要明确打开「成人向」。 2. 切到「服装」可以单选一套衣服。春夏秋冬和派对默认可见；内衣、泳装、性感需要打开「成人向」。 3. 切到「脸部」可以单选一张脸部参考。可以按脸部特写或造型、发长筛选，也可以搜索编号和造型名，或点「随机一张」。不选则保持角色原来的脸。 4. 左侧可以导入其他模特，或继续用大肥鱼。选了服装之后，「保持服装」会暂时让位给这套衣服。选了脸部之后，五官、表情和发型改用这张参考。 5. 右上角「生图设置」里填写 Gemini 或 OpenAI 兼容接口的密钥。密钥只留在这台浏览器里。 6. 没有密钥时，右侧仍会写出每一张图的提示词，可以复制到已安装的 dsh-image-gen 里生图。参考图顺序是角色、可选的脸部参考、可选的没有人物的衣服、姿势线稿。 7. 姿势和服装页都有「自定义」。可以上传参考图，也可以写一句描述，让当前接口把描述扩写成提示词再生成参考图。姿势参考偏向线稿。服装参考会先生成一位穿着这套衣服的模特，再把人抠掉，只留下衣服。没有密钥或文本接口不可用时，会在本地扩写，提示词仍可复制。自定义内容只存在这台浏览器里。 8. 出图成功后会出现在右侧「历史」。刷新后还在。点开可以看当时的参数，「再用」会恢复姿势、服装、脸部和补充描述，然后再出图。可以删除一条，或清空全部。存储快满时会提示清理。

Seedream 走火山方舟 https://ark.cn-beijing.volces.com/api/v3，默认模型 doubao-seedream-5-0-flash-260915，会按同一顺序提交参考图：模特图、可选的脸部原图、可选的服装图、姿势线稿。Gemini 把同一组图放进 generateContent 的 inline data。OpenAI 兼容接口会先走 images/edits，按同样顺序附加 image 字段；接口不支持编辑时，会退回纯文生图，并在结果上说明参考图没有送出。Gemini 默认模型是 gemini-2.5-flash-image。

服务器若已配置密钥，可以不把密钥放进浏览器：

POSE_MUSE_PROVIDER=seedream \
POSE_MUSE_MODEL=doubao-seedream-5-0-flash-260915 \
POSE_MUSE_BASE_URL=https://ark.cn-beijing.volces.com/api/v3 \
POSE_MUSE_API_KEY=你的密钥 \
npm run dev

装进 DeepSeek Harness

在已经装好 DeepSeek Harness 的机器上执行：

dsh plugin --profile web add gen-ai-pose-image

包名是 gen-ai-pose-image。还没发布、或要改本地代码时，把包名换成这个仓库的路径也行。

重启对应 profile 后：

• 左侧栏多一项「澜姿 / 工作室」，和「插件」「自动化任务」排在一起。点开后是完整工作室，可以选姿势、换服装、换脸部参考、换模特并生图。
• Agent 可以使用 search_poses、search_costumes、search_faces 和 generate_pose_images。换装时把服装编号传给 costume_id。换脸或表情时把脸部编号传给 face_id。工作室打开后，自定义姿势和服装也会出现在搜索里，并标成 source: custom。generate_pose_images 可以传这些 id。如果这台机器上还没有对应的参考图，工具会说明需要先在工作室上传或生成，不会换成图库里的别的姿势或服装。脸部参考没有自定义项，生成时从原站读取原图。
• 给进程设置 POSE_MUSE_API_KEY 后，工具会直接出图并挂到会话里。没有密钥时，工具返回写好的提示词，方便交给 dsh-image-gen 的 generate_image / edit_image。

检查

npm test
npm run typecheck

许可

澜姿自己的程序使用 MIT License。数据来源和各自的版权写在 shared/license.mjs，并附在 LICENSE 末尾。

这份 MIT 许可只覆盖程序。下面的作者和作品另外标注，图片按需读取、不放进仓库：

• 姿势线稿和原始数据的著作权归 ギア。作品是 AI Pose Gallery；中文译名由 Anhao 维护在 ai-pose-gallery-zh，图床是 ai-pose-gallery.anhao.app。上游说明这些图不得用于商业用途。
• 服装图同样来自 ギア 的 衣装集 COSTUME-DB-01。仓库里只有编号和关键词。
• 脸部参考图来自 ギア 的 AI 模型脸数据库，许可是 CC0。仓库里只有编号、分区、发长、造型名和公开图地址。中文目录参考 sleepy-zone/ai-ref-library-cn，不表示图像作者改成了该仓库的维护者。
• 大肥鱼的角色设计来自 上善无形 的原创角色和 ZipZipPipe 的女仆装鲸鱼娘，按 CC BY-NC-SA 4.0 授权（署名、非商业、相同方式共享）。这张设定图收录于社区仓库 TreapGoGo/deepseek-whale-girl，由 ChatGPT 生成；该仓库的 MIT 只覆盖它的网站代码，不覆盖这张图。这是非官方社区形象，不代表深度求索。
• DeepSeek 是深度求索的商标。这份许可不授予该商标。