跳到主要内容
AI教程

澜姿教程：用姿势与服装参考图生成一致角色，并接入 DeepSeek Harness

本教程介绍如何安装并使用澜姿，从 1439 张姿势线稿和 1407 套服装中选择参考素材，配置 Seedream、Gemini 或 OpenAI 兼容接口生成图片，并将完整工作室与生成工具接入 DeepSeek Harness。

AI我搜编辑部阅读约 8 分钟
澜姿教程：用姿势与服装参考图生成一致角色，并接入 DeepSeek Harness

澜姿是什么

澜姿既是一个可以独立运行的姿势工作室，也是 DeepSeek Harness 插件。它从 ai-pose-gallery-zh 收录的 288 组、1439 张姿势线稿中选择一个或多个姿势，再结合角色与服装参考图，生成同一位模特的不同动作图片。

项目默认使用社区鲸鱼娘的成年形象大肥鱼作为模特。她具有长波浪蓝发、鲸耳和蓝鲸尾，默认穿海军蓝与白色女仆装。你也可以导入最多三张其他模特照片，用来替换角色的脸和衣服。

姿势线稿只用于描述身体姿态，默认不会把线稿中的空白身体画进最终图片。线稿不会存放在项目仓库中，而是按需从公开图床读取。

核心功能

  • 丰富的姿势库：提供 288 组、1439 张姿势线稿，支持单选或多选。
  • 服装替换：可从 COSTUME-DB-01 的 1407 套服装中选择一套，并保留角色的脸、发型、鲸耳和鲸尾。
  • 自定义模特：最多导入三张模特照片，也可以继续使用默认的大肥鱼。
  • 多种生图接口：支持火山方舟 Seedream、Gemini，以及 OpenAI 兼容接口。
  • 无密钥工作流：未配置 API 密钥时仍会生成完整提示词，可复制到 dsh-image-gen 中使用。
  • Harness 集成：安装插件后，可在侧栏打开完整工作室，也可以让 Agent 搜索姿势、搜索服装和生成图片。
  • 响应式界面：宽屏使用多栏布局，窄屏会收成单列，并将出图按钮保留在底部。

运行本地工作室

1. 准备环境

澜姿要求使用 Node.js 22.19 或更新版本。确认 Node.js 版本满足要求后，在项目目录安装依赖并启动开发服务器：

npm install
npm run dev

启动后，在浏览器打开 http://127.0.0.1:43123。

2. 选择姿势

在工作室中间区域选择姿势。你可以一次选择多个姿势，让系统分别生成对应图片。标准全身姿势是默认页面；性感类和双人姿势不会默认显示，需要明确打开成人向开关。

3. 选择服装

切换到服装页面后，可以单选一套衣服。春、夏、秋、冬和派对分类默认可见；内衣、泳装和性感分类与成人向姿势共用同一个开关。

选中服装后，生成结果会使用这套衣服，并尽量保留角色的脸、发型及其他特征。此时默认的保持服装选项会暂时让位给所选服装。

澜姿工作室中已选择姿势和服装并生成图片

4. 设置或更换模特

左侧区域用于管理模特。你可以继续使用默认的大肥鱼，也可以导入最多三张自己的模特照片。多张参考图有助于提供角色的脸部、发型和服装信息，但实际效果仍取决于所使用的图像生成模型。

5. 配置图像生成接口

打开右上角的生图设置，填写 Gemini 或 OpenAI 兼容接口所需的密钥。密钥只保存在当前浏览器中，不会作为项目数据写入仓库。

澜姿支持以下默认配置：

  • Seedream：使用火山方舟地址 https://ark.cn-beijing.volces.com/api/v3，默认模型为 doubao-seedream-5-0-flash-260915。
  • Gemini：默认模型为 gemini-2.5-flash-image。
  • OpenAI 兼容接口：优先调用 images/edits；如果接口不支持编辑，则退回纯文本生成，并在结果中提示参考图没有被送出。

Seedream 会一起提交模特图、可选的服装图和姿势线稿。选择服装时，参考图顺序是角色、无人服装图、姿势线稿。

6. 开始生成

完成模特、姿势、服装和接口设置后，点击出图按钮即可生成。没有配置密钥时，右侧仍会为每个所选姿势生成提示词。你可以复制这些提示词，交给已安装的 dsh-image-gen 执行生成。

在服务器端配置密钥

如果不希望把密钥填写到浏览器中，可以通过环境变量为服务器进程配置提供商、模型、接口地址和密钥：

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，可以将澜姿作为插件加入 web profile：

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

插件包名是 gen-ai-pose-image。如果包尚未发布，或者你需要调试本地修改，可以将包名替换成仓库的本地路径。安装完成后，重启对应的 profile。

DeepSeek Harness 中的澜姿工作室

重启后，左侧栏会增加澜姿 / 工作室入口，并与插件和自动化任务并列。打开后可以在同一个页面中选择模特、姿势和服装，调整生图设置并查看结果。

让 Agent 调用澜姿工具

插件向 Agent 提供三个工具：

  • search_poses：搜索符合条件的姿势。
  • search_costumes：搜索服装。
  • generate_pose_images：根据选定内容生成姿势图片。

需要换装时，把服装编号传给 costume_id。如果 Harness 进程设置了 POSE_MUSE_API_KEY，工具会直接生成图片并挂载到会话中；没有密钥时，工具会返回准备好的提示词，方便继续交给 dsh-image-gen 的 generate_image 或 edit_image。

成人向姿势和成人向服装默认不会出现在搜索结果中。只有在用户明确要求时，才应向 search_poses 或 search_costumes 传入 include_adult: true。

移动端与窄面板使用

澜姿支持响应式布局。窄屏时，模特区域会收在顶部，姿势分类改为下拉选择，出图按钮固定保留在页面底部。服装分类会自动换行，卡片说明也会保持在可视区域内。

手机宽度下的澜姿服装选择页面

在 Harness 的窄面板中，原本的多栏工作室同样会收成单列，因此无需切换到单独的移动版本。

进阶使用建议

合理组织多姿势生成

澜姿允许同时选择多个姿势。需要对比动作时，可以先固定模特和服装，再选择一组姿势批量生成，这样更便于观察同一角色在不同姿态下的一致性。

理解服装参考图的作用

服装库中的图片不包含人物，主要用于提供衣服外观。选择服装后，澜姿会同时结合角色参考、服装参考和姿势线稿。若接口不支持图片编辑并退回纯文本生成，参考图不会被提交，结果页会明确说明这一情况。

先用提示词验证流程

如果暂时没有可用的 API 密钥，可以先完成姿势、模特和服装选择，检查右侧生成的提示词，再将其复制到其他生图工具。这样可以在配置正式接口之前验证工作流。

执行项目检查

修改本地代码或准备提交前，可以运行测试和类型检查：

npm test
npm run typecheck

版权与使用限制

澜姿自身程序采用 MIT License，但该许可只覆盖程序代码，不会自动覆盖姿势、服装和角色参考图。

  • 姿势线稿及原始数据著作权归 ギア 所有，上游说明这些图片不得用于商业用途。
  • 服装图来自ギア的 衣装集 COSTUME-DB-01，仓库只保存编号和关键词。
  • 大肥鱼设定图来自 deepseek-whale-girl，作者为 TreapGoGo，并按对应仓库的 MIT 许可使用。
  • 大肥鱼是社区形象，不代表深度求索；DeepSeek 是深度求索的商标，项目许可不授予该商标。

在发布或使用生成结果前，应查看项目中的 shared/license.mjs 和 LICENSE，并遵守各项素材的独立许可与使用限制。

总结

澜姿将角色参考、姿势线稿、无人服装图和图像生成接口整合到一个工作室中。你可以在本地快速选择姿势与服装，也可以将插件安装到 DeepSeek Harness，让 Agent 搜索素材并生成图片。开始使用时，先运行本地工作室验证流程，再根据实际接口配置浏览器或服务器端密钥即可。