dsh-cosplay-studio

Cosplay Studio（dsh-cosplay-studio）

把 cosplay-photo-set 技能 v2.1 的整套流程做成 DSH 插件：输入角色名、上传一张参考图，或者什么都不给让插件推荐热门角色 → 真人 cosplay 套图。

所有出图都在本机 ComfyUI（Z-Image-Turbo）上完成，图片不上传云端。

效果图

本机 ComfyUI + Z-Image-Turbo，1440×2560 成片（芙莉莲 / 芙宁娜）：

工作流程

四步都在同一个工作台里完成，每一步都能先看、再改，确认后才往下走：

步骤	界面
① 角色研究：联网检索 + 图片分类 + 视觉模型提取特征 + 粗略草图确认
② 基准图微调：输入要求手动改，或让视觉模型比对参考图后智能改
③ 镜头脚本：按角色特征生成 6 镜，可逐镜改、智能补镜、手动加镜
④ 成片与导出：先出 1440×2560 原图 PNG，再按需导出 JPEG / 预览 / 文案

---

一、安装

方式 A：装进本机 DSH 桌面端（推荐）

1. 把整个 dsh-cosplay-studio 目录放进 profile 的 node_modules：

D:\DSH\profiles\desktop\node_modules\dsh-cosplay-studio

2. 编辑 D:\DSH\profiles\desktop\package.json：

{
  "dependencies": {
    "dsh-cosplay-studio": "2.1.0"
  },
  "dsh": {
    "profile": {
      "bundles": ["...已有项...", "dsh-cosplay-studio"]
    }
  }
}

3. 完全退出并重新打开 DSH 桌面端（关闭窗口通常只是隐藏，需要在托盘/任务栏退出应用），再刷新页面。侧边栏出现 Cosplay 工作台 图标；设置页也会出现 Cosplay Studio 一节。

方式 B：打包分发

pnpm pack          # 产出 dsh-cosplay-studio-2.1.0.tgz

把 .tgz 或整个目录发给别人；对方按方式 A 解压/放入 node_modules 并在 package.json 登记即可。发布到 npm 后可走插件市场安装。

方式 C：从 GitHub 安装（插件市场收录后）

仓库地址：https://github.com/Wang-Shuanglin/dsh-cosplay-studio

不打包、不构建也能装：GitHub Release 上有一份预构建的 dsh-cosplay-studio.tgz（不含截图，约 60 KB），下载后按方式 A 解压进 node_modules 即可。

# 下载最新预构建包
curl -L -o dsh-cosplay-studio.tgz \
  https://github.com/Wang-Shuanglin/dsh-cosplay-studio/releases/latest/download/dsh-cosplay-studio.tgz

解压后目录结构是 package/，把它重命名成 dsh-cosplay-studio 放进 profile 的 node_modules，再按方式 A 第 2、3 步登记并重启。

---

二、第一次使用：教程 → 同意 → 自动部署 → 自动调试

插件第一次打开时不会直接开工，而是先展示六章教程：

1. 这个插件做什么
2. 部署会装什么（ComfyUI + 三个模型）
3. 自动调试什么（模型能否加载、采样能否出图、显存是否够）
4. 硬件与时间（NVIDIA 8GB+；1152×2048 约 75 秒，1440×2560 约 4 分钟）
5. 两道人工闸门（基准图、镜头脚本）
6. 内容边界（一律 18 岁以上成人形象）

勾选同意后可以选择：

• 同意并开始部署：自动定位/安装 ComfyUI、补齐模型、启动服务，并跑一次 640×1152 / 4 步自检（约 11 秒）。本机已装过 ComfyUI 与模型时只做复用与校验，不会重复下载。
• 仅同意，稍后手动部署：只记录同意，不碰 ComfyUI。

部署与自检的结果、每一步日志、运行环境（ComfyUI 路径、Python、服务状态、显卡、模型是否齐全）都显示在「安装与设置」页。

---

三、工作台：三种入口

入口	做法	说明
A 角色名	输入角色名（可加作品名）	自动联网检索角色资料与立绘/cosplay 图，视觉模型提取发型、服装、道具、性格等特征
B 参考图	上传一张二次元角色图	图是唯一设计依据；视觉模型读图提取特征，必要时可「补充网络参考图」
C 随机推荐	点「随机推荐 3 个热门角色」/「换一批」	内置 28 个近年高热角色池，选中后自动走入口 A 的研究流程

选定角色后点「创建项目」，插件会用 DSH 宿主的检索 / 视觉能力做一轮角色形象研究：检索资料 → 下载并分类角色参考图（自动跳过风景、汉字、截图）→ 提取外观特征 → 生成 640×1024 粗略草图供确认。整个过程有分阶段进度（正在检索信息 / 正在根据参考图分析特征 / 正在生成粗略草图）。研究结果不满意可以「重新研究」，参考图项目可以「补充网络参考图」。

三道闸门

1. 角色形象：看研究出的特征与粗略草图，必要时直接改特征字段后保存。
2. 基准图：生成 1152×2048 基准图。确认人物、服装、背景都对了再往下；不满意可以「微调基准图」——输入要求手动改，或让视觉模型比对参考图/角色卡后智能改，结果作为新版本追加，旧图保留。
3. 镜头脚本：按角色特征生成 6 镜（每镜含情境/表情/动作/手/机位/道具，且带角色专属细节），可逐镜改，也可「智能补 2 镜（不重复）」或手动加一镜。确认后才跑 1440×2560 成片。

出片与导出

成片直接按 1440×2560 出原图（raw/*.png，不额外压缩），先看原图：

• 每张成片可以单独「微调」：输入要求手动改，或「智能修改」让视觉模型比对参考图/已确认基准图后只修最需要改的瑕疵（手、脚、五官、衣边）；改动幅度可选，改坏了可以「撤销上次微调」。
• 满意后再「导出成片」：可选 去油光 / 身体化妆，导出 JPEG（默认 q95、上限 6 MB）并生成：
  • 00_基准角色_<角色>.jpg
  • 00_全套预览.jpg（2×2 拼图）
  • 01_动作名.jpg、02_动作名.jpg …
  • 文案.txt（标题 3 条 / 正文 / 标签）

导出时会把参考图带来的白色海报留白自动补成角色配色的满幅渐变（不需要可以关闭）。去油光 / 身体化妆 / 预览 / 文案都改为可选的后续步骤，不再强制和出片绑在一起。

---

四、设置页入口与侧边栏开关

• 设置页 设置 → Cosplay Studio 里可以：打开工作台、重新检测环境、启动/停止 ComfyUI、开关「侧边栏显示 Cosplay 工作台」、开关「成片自动做身体化妆」。
• 侧边栏图标被隐藏后，主面板依然存在，从设置页点「打开工作台」即可进入。

---

五、配置项（<DSH_HOME>/data/dsh-cosplay-studio/config.json）

键	默认	说明
comfyDir	自动探测	ComfyUI 目录
comfyPort	8188	ComfyUI 端口
pythonExe	自动探测	运行 ComfyUI 的 Python
baseSize	1152x2048	基准图尺寸
finalSize	1440x2560	成片尺寸
steps / cfg / shift	6 / 2 / 3	采样参数
vaeTileSize / vaeOverlap	1024 / 128	放大重绘的分块，避免背景接缝
deoil	true	P7 去油光
bodyMakeup	true	P7b 身体化妆
makeupStrength / legStrength	0.35 / 0.85	P7b 强度（与技能脚本一致）
llm.baseUrl / llm.apiKey / llm.model	空	可选：OpenAI 兼容对话模型，用于角色情报与镜头脚本
showSidebar	true	是否在侧边栏显示入口

---

六、已知限制

• 只支持 NVIDIA GPU（8GB 显存起步）；4K 会 OOM。
• 本地 Z-Image-Turbo 的 img2img 结构惯性较强：基准图/成片微调能可靠地改道具、服饰细节、手部细节，但抬手臂、换姿势这类大幅动作会被原图压住；姿势请交给镜头脚本，或直接用更大改动幅度重绘（可能改变人物与构图）。
• 智能修改会先给出问题清单再重绘，对已有成片重绘仍可能把鞋子/边缘改坏；每次覆盖前都备份在 raw/.history/，可随时「撤销上次微调」。
• 联网检索使用 Bing 网页兜底（DSH 账号的 web.search 在插件 HTTP 请求里拿不到发起会话），个别角色可能仍混入不相关图片；插件会用视觉模型过滤风景、汉字、截图，并在研究日志里写明跳过原因。
• 背景渐变颜色刻意避开米/沙/驼等接近肤色的色系，否则 P7b 的肤色遮罩会把背景一起提亮。