gen-ai-pose-image
澜姿:从姿势线稿和衣装集给社区鲸鱼娘大肥鱼模特出图,调整姿势加变装,也可装进 DeepSeek Harness。Lanpose generates images of the community whale-girl Dafeiyu from pose sketches and costumes, and installs into DeepSeek Harness.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/wzc520pyfm/gen-ai-pose-image with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/wzc520pyfm/gen-ai-pose-image'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/wzc520pyfm--gen-ai-pose-image)HTML
<a href="/listings/wzc520pyfm--gen-ai-pose-image"><img src="/api/listings/wzc520pyfm--gen-ai-pose-image/badge.svg" alt="findsafeskills safety rating" /></a>Install
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 153 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- [English](./README.en.md)
- # 澜姿
- [](https://www.npmjs.com/package/gen-ai-pose-image)
- 
- 可选的 **ComfyUI 浏览器直连**:在在线网站填写本机或远程 HTTPS 地址,用一套带开关的工作流完成换装、姿势、组合生成及逐格拼图,无需在显卡电脑启动网站。原云端功能保留,详见[连接与工作流说明](docs/comfyui-local.md)。
- DeepSeek Harness 插件,也是一个可以单独打开的姿势工作室。从 [ai-pose-gallery-zh](https://github.com/anhao/ai-pose-gallery-zh) 的 288 组、1439 张姿势线稿里选一个或多个姿势,生成同一位模特的图。
- 默认模特是 **大肥鱼**:社区鲸鱼娘的成年形象,长波浪蓝发、鲸耳、蓝鲸尾,穿海军蓝与白色女仆装。参考图用的是 [TreapGoGo](https://github.com/TreapGoGo) 的 [deepseek-whale-girl](https://github.com/TreapGoGo/deepseek-whale-girl) 里的 `dafeiyu-mature-character-sheet.png`。可以导入最多三张别的模特照片,用来替换脸和衣服。姿势图只提供身体姿态,默认不会把线稿里的空白身体画进成图。
- 姿势线稿不在这个仓库里。页面会按需读取公开图床 [ai-pose-gallery.anhao.app](https://ai-pose-gallery.anhao.app)。图片与原始数据的著作权归 [ギア](https://x.com/giaaibusi) 所有,中文译名来自 [Anhao](https://github.com/anhao) 的图库。
- 服装来自 [ギア](https://x.com/giaaibusi) 的 [衣装集 COSTUME-DB-01](https://ai-costume-gallery.pages.dev/),共 1407 套,图里没有人物。页面按需读取该站点的缩略图,本仓库只保存编号和关键词。选中一套之后,生图会换成这身衣服,并保留角色的脸、发型、鲸耳和鲸尾。内衣、泳装和性感分类跟成人向姿势共用同一个开关。
- 脸部参考同样来自 [ギア](https://x.com/giaaibusi) 的 [AI 模型脸数据库](https://ai-portrait-gallery.pages.dev/),共 1499 张,许可是 CC0。分区是脸部特写和造型,可以按发长筛选。中文分区和造型名参考 [sleepy-zone/ai-ref-library-cn](https://github.com/sleepy-zone/ai-ref-library-cn),图像作者仍是ギア。本仓库只保存编号、标签和公开图地址,缩略图和原图按需从原站读取。选中一张之后,生图把它当作脸部和表情参考:五官、表情、脸型和发型跟这张图,姿势和服装仍按各自的参考,鲸耳和鲸尾保留。脸库没有单独的成人向分类。
- ## 效果
- 同一套站立姿势「站立・对立式平衡・手扶腰」。第一张保持女仆装,第二张换成衣装集 SPR-0001。
- <p>
- <img src="docs/result-pose.jpg" alt="保持服装:大肥鱼按站立姿势出的图" width="360">
- <img src="docs/result-costume.jpg" alt="换装:同一姿势换成 SPR-0001 的春装" width="360">
- </p>
- 选了「女孩坐・双手抱头后」,并换成 SPR-0045 之后,成图出现在右侧。
- 
- 窄屏时模特收在顶上,分类用下拉,出图按钮留在底部。
- 
- 服装分类会换行,卡片说明留在屏幕里。
- 
- 装进 Harness 之后,左侧栏是「澜姿 / 工作室」。点开后用的是同一套工作室:模特、姿势、服装、生图设置和出图都在这一页里。面板够宽时仍是三栏;窄面板收成一列,出图按钮留在底部。
- 
- ## 本地工作室
- Docker 和 Node.js 任选一种即可启动同一个网页版工作室。图片由你在「生图设置」里选择的服务生成。
- ### 使用 Docker Compose
- 1. 启动 Docker(需带 Compose),在 `compose.yaml` 所在目录运行下面的命令,构建并在后台启动工作室。使用默认设置时可以跳过 `.env`。
- ```bash
- docker compose up -d --build
- ```
- 2. 在这台电脑的浏览器里打开 [http://127.0.0.1:43123](http://127.0.0.1:43123)。默认只有本机能访问这个网页。
- 3. 想出图时,点右上角「生图设置」。用 Gemini、OpenAI 或 Seedream 时,选对应服务商并填入密钥。已有 ComfyUI 的话,选「ComfyUI」,填它的地址,点「测试连接」。浏览器会直接连接 ComfyUI。[ComfyUI 连接说明](docs/comfyui-local.md)
- 查看日志用 `docker compose logs -f web`。要停止工作室并释放端口,运行 `docker compose down`。
- <details>
- <summary>什么时候需要配置 .env?</summary>
- <p>把需要的设置写进 <code>compose.yaml</code> 同目录的 <code>.env</code>。每次修改后,在该目录运行 <code>docker compose up -d</code> 让配置生效。</p>
- <p><strong>想换网页端口。</strong>比如 Node.js 版已占用 <code>43123</code>,写入下面这行就能用 <a href="http://127.0.0.1:43124">http://127.0.0.1:43124</a> 打开 Docker 版。浏览器按站点(包括端口)保存生成历史和自定义素材。</p>
- <pre><code class="language-dotenv">POSE_MUSE_PORT=43124</code></pre>
- <p><strong>想把生图密钥放在服务端。</strong>比如希望换个浏览器也能用自己的 Gemini 密钥,就写入下面两行,把 <code>your-gemini-api-key</code> 换成实际密钥。在网页选用 Gemini 默认接口时,密钥栏可以留空。</p>
- <pre><code class="language-dotenv">POSE_MUSE_PROVIDER=gemini
- POSE_MUSE_API_KEY=your-gemini-api-key</code></pre>
- <p>要指定模型或接口地址,可以加上 <code>POSE_MUSE_MODEL</code> 或 <code>POSE_MUSE_BASE_URL</code>。这些变量也可以通过 shell 传给 Compose。</p>
- </details>
- <details>
- <summary>本机另有 OpenAI 兼容生图接口,地址填在哪里?</summary>
- <table>
- <thead><tr><th>填写位置</th><th>地址示例</th></tr></thead>
- <tbody>
- <tr><td>浏览器地址栏</td><td><code>http://127.0.0.1:43123</code>(工作室的默认网址)</td></tr>
- <tr><td>工作室的「生图设置」→「OpenAI」→「接口根地址」</td><td><code>http://localhost:8000/v1</code>(按你的生图服务实际地址填写)</td></tr>
- </tbody>
- </table>
- <p>容器会通过 Docker 网关访问这个本机 HTTP 接口。在原生 Linux 上,生图服务需要监听 Docker 网桥可达的地址。</p>
- </details>
- ### 使用 Node.js
- 需要 Node.js 22.19 或更新版本。
- ```bash
- npm install
- npm run dev
- ```
- 启动后,在浏览器打开 [http://127.0.0.1:43123](http://127.0.0.1:43123)。
- <details>
- <summary>用服务端密钥启动 Node.js(Seedream 示例)</summary>
- <pre><code class="language-bash">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</code></pre>
- </details>
- ### 使用工作室
- 1. 在中间点选姿势,可以多选。标准全身是默认页;性感系和双人姿势需要明确打开「成人向」。
- 2. 切到「服装」可以单选一套衣服。春夏秋冬和派对默认可见;内衣、泳装、性感需要打开「成人向」。
- 3. 切到「脸部」可以单选一张脸部参考。可以按脸部特写或造型、发长筛选,也可以搜索编号和造型名,或点「随机一张」。不选则保持角色原来的脸。
- 4. 左侧可以导入其他模特,或继续用大肥鱼。选了服装之后,「保持服装」会暂时让位给这套衣服。选了脸部之后,五官、表情和发型改用这张参考。
- 5. 云端生图的密钥可以在右上角「生图设置」里填写。服务端已为该接口配置密钥时,网页的密钥栏可以留空。手动填写的密钥保存在当前浏览器。装进 DeepSeek Harness 后,生图请求带上的密钥也会写入插件配置,供 agent 工具使用。
- 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`。
- ## 装进 DeepSeek Harness
- 在已经装好 DeepSeek Harness 的机器上执行:
- ```bash
- 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`。
- 成人向姿势和成人向服装默认不进搜索结果。只有明确要求时才给 `search_poses` 或 `search_costumes` 传 `include_adult: true`。
- ## 检查
- ```bash
- npm test
- npm run typecheck
- ```
- ## 许可
- 澜姿自己的程序使用 [MIT License](./LICENSE)。数据来源和各自的版权写在 [`shared/license.mjs`](./shared/license.mjs),并附在 [`LICENSE`](./LICENSE) 末尾。
- 这份 MIT 许可只覆盖程序。下面的作者和作品另外标注,图片按需读取、不放进仓库:
- - 姿势线稿和原始数据的著作权归 [ギア](https://x.com/giaaibusi)。作品是 [AI Pose Gallery](https://ai-pose-gallery.pages.dev/);中文译名由 [Anhao](https://github.com/anhao) 维护在 [ai-pose-gallery-zh](https://github.com/anhao/ai-pose-gallery-zh),图床是 [ai-pose-gallery.anhao.app](https://ai-pose-gallery.anhao.app)。上游说明这些图不得用于商业用途。
- - 服装图同样来自 [ギア](https://x.com/giaaibusi) 的 [衣装集 COSTUME-DB-01](https://ai-costume-gallery.pages.dev/)。仓库里只有编号和关键词。
- - 脸部参考图来自 [ギア](https://x.com/giaaibusi) 的 [AI 模型脸数据库](https://ai-portrait-gallery.pages.dev/),许可是 CC0。仓库里只有编号、分区、发长、造型名和公开图地址。中文目录参考 [sleepy-zone/ai-ref-library-cn](https://github.com/sleepy-zone/ai-ref-library-cn),不表示图像作者改成了该仓库的维护者。
- - 大肥鱼的角色设计来自 上善无形 的原创角色和 ZipZipPipe 的女仆装鲸鱼娘,按 [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/) 授权(署名、非商业、相同方式共享)。这张设定图收录于社区仓库 [TreapGoGo/deepseek-whale-girl](https://github.com/TreapGoGo/deepseek-whale-girl),由 ChatGPT 生成;该仓库的 MIT 只覆盖它的网站代码,不覆盖这张图。这是非官方社区形象,不代表深度求索。
- - [DeepSeek](https://www.deepseek.com/) 是深度求索的商标。这份许可不授予该商标。
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.