前言¶
在 DeepSeek Harness(DSH)里写提示词、调模型,同时又要用 ComfyUI 跑图时,常见做法是反复切换浏览器标签或窗口:一边在 DSH 里对话,一边打开 ComfyUI 网页选工作流、改节点、看队列。提示词从 A1111 复制过来还带 Steps、CFG、Sampler 等参数堆,LoRA 强度要进画布改,缺 checkpoint 往往要到生成失败才知道。下面介绍维护者 xingyeai23 发布的 dsh-comfyui-studio(npm 包名 dsh-comfyui-studio):把工作流选择、提示词、生成、预览和节点编辑收进 DSH 左侧栏的一个面板,通过本机 Host 连你已经启动的 ComfyUI 实例(默认 http://127.0.0.1:8188)。
这是什么¶
dsh-comfyui-studio 是 DeepSeek Harness 的 ComfyUI 工作室插件,分类属于工作流类能力。它在侧栏提供「ComfyUI」入口:从 ComfyUI 已保存的图片工作流里下拉选择,填写正向提示词并生成,查看结果大图与全屏预览,对工作流里的 LoRA 做快捷编辑,必要时从底部滑出简化节点编辑器或切换内嵌的官方 ComfyUI 网页(原生画布)。插件不收集遥测、不上传生成结果;面板经 Host 访问你配置的 ComfyUI 地址。源码与文档在 GitHub:xingyeai23/dsh-comfyui-studio;社区目录页:skillhub 插件页。许可证为 MIT;当前 package 版本为 0.3.5(以仓库 package.json 为准)。
核心功能¶
下列能力均来自项目 README 与 package.json 说明,可按需选用。
一个面板完成生成与状态查看¶
- 从 ComfyUI
workflows/中列出图片输出、且不含子图的工作流;视频工作流和子图工作流不会出现在下拉里。 - 写正向提示词后点「生成」;结果以大图与列表形式展示。
- 显存 / 内存 / 队列 / 活动四张状态卡片;生成时通过 WebSocket 显示队列进度。
提示词与参数¶
- A1111 参数自动清理:提示词里混入的 Steps、CFG、Sampler 等会被清理并还原默认值。
- 步数 / CFG、采样器 / 调度器、种子(随机 / 固定 / 递增 / 递减)、宽高分开编辑。
- AI 提示词转写:按当前工作流的 checkpoint / unet 判断标签模型(如 NoobAI、SDXL)或自然语言模型(如 Flux);中文参考可点「译成中文」。转写 / 翻译会把提示词发给当前 profile 配置的 LLM provider(需在配置里填写
llmProvider、llmModel等)。
资产检查与 LoRA¶
- 缺 checkpoint、VAE、LoRA 时,资产检查给出具体文件名和目标目录,并禁用生成。
- 存在
LoraLoader/LoraLoaderModelOnly时出现 LoRA 卡片:选文件、改模型 / CLIP 强度、勾选启用;取消启用会在提交时绕过该节点。
工作流编辑与原生画布¶
- 工作流卡片「编辑」:底部画布支持拖动、缩放、右键添加 / 编辑 / 绕过 / 删除节点,保存回
workflows/<名称>.json。 - 工具栏「原生画布」:macOS 与 DSH Web 可内嵌 ComfyUI 官方网页(Windows 桌面版 README 写明暂不提供该入口)。HTTPS 的 DSH 嵌 HTTP 的 ComfyUI 可能被混合内容拦截,需用「新窗口打开」。
全屏图片预览¶
单击结果大图:淡入缩放、上一张 / 下一张、下载、复制 PNG 到剪贴板、从结果列表删除(不删服务器文件),可查看并复制生成种子。
首次连接引导¶
连不上 ComfyUI 时整页显示安装步骤、官方下载链接和地址输入框;地址记在浏览器本地,每 5 秒自动重连,支持「扫描局域网」。
安装与启用¶
插件以当前 DSH 进程权限运行,安装前建议在 GitHub 查看源码与 MIT 许可证。要求 DeepSeek Harness >=0.2.2-rc.1、Node.js >=20.3;ComfyUI 在 0.44 上验证,依赖 /system_stats、/object_info、/history、/userdata/workflows 和 /ws。
推荐在 DSH 内安装(命令与索引 URL 以 README 为准,不要自行拼接 dsh plugin add github:...):
- 打开 插件 → 发现,点击「添加索引源」。
- 填入插件索引:
https://raw.githubusercontent.com/xingyeai23/dsh-comfyui-studio/main/plugin-index.json
- 找到「ComfyUI 工作室」并安装(实际安装的是 npm 包
dsh-comfyui-studio)。
刷新页面(⌘R)后,左侧栏会出现「ComfyUI」入口。其他方式:从源码目录用 plugin_manager 的 install_bundle 安装,见仓库 CONTRIBUTING.md。
典型用法¶
首次连接 ComfyUI¶
先启动 ComfyUI:ComfyUI Desktop 打开应用并启动实例(默认端口 8188);Windows 便携版可双击 run_nvidia_gpu.bat(默认 8188)。打开左侧栏「ComfyUI」,若端口或 IP 不同,在输入框改成正确地址(支持 192.168.1.10:8188),点「保存并连接」。
远程或局域网可在 profile 的 cordis.patch.yml 中覆盖(改完后需重载插件或重启 DSH):
- id: comfyui-panel
config:
baseUrl: http://192.168.1.10:8188 # 改成你的 ComfyUI 地址
discoveryPort: 8188
requestTimeoutMs: 8000
llmProvider: ''
llmModel: ''
rewriteMaxTokens: 800
rewriteReasoningEffort: off
首次离线引导里填写的地址存在浏览器 localStorage,优先于 profile 默认本机 http://127.0.0.1:8188。
生成第一张图¶
- 选择一个已保存的图片工作流(列表为空时,先在 ComfyUI 里搭建并保存一个图片工作流)。
- 填写正向提示词(可按需点「AI 转写」)。
- 右下角点「生成」。
Host 会把 ComfyUI 前端图转成 /prompt 所需的 API 图:映射控件值、还原连线、从 KSampler 反查 CLIP 与 latent 参数,提交前检查模型与下拉输入是否在服务端存在。
编辑工作流与 LoRA¶
- 点工作流卡片右上角「编辑」进入底部画布;未保存修改收起时会提示保存。
- 工作流含 LoRA 节点时,用左侧 LoRA 卡片改强度与启用,无需每次进完整画布。
各工作流的提示词、参数和栏宽保存在浏览器 localStorage(键名 dsh-comfyui-studio:v2)。
适用场景与注意¶
适合谁:日常在 DSH 里跑 SDXL、NoobAI、Anima、Flux 等 ComfyUI 工作流,希望少切换窗口、在侧栏完成选流、写词、生成和简单改节点的人。
平台:README 标明支持 macOS、Windows、Linux;DSH 桌面与 Web 均可,Web 端经 Host 代理访问 ComfyUI。ComfyUI Desktop 端口被占用时以实例显示地址为准;局域网访问需在 Desktop 设置里允许监听。
故障排查要点(详见 TROUBLESHOOTING.md):
| 现象 | 处理 |
|---|---|
| 面板连不上 | 确认 ComfyUI 已启动,地址端口一致;局域网需开启监听;可点「立即重试」。 |
| 提示缺模型 / VAE | 按弹窗文件名与目录补文件后刷新。 |
| 下拉无工作流 | 仅图片输出且无子图;先在 ComfyUI 保存合格工作流。 |
安全:Host 路由只接受同源请求并校验 base、工作流名和图片坐标;内嵌原生画布的安全与登录由 ComfyUI 自身负责。
结尾¶
dsh-comfyui-studio 把 ComfyUI 的高频操作搬进 DSH 侧栏:工作流与提示词、资产检查、LoRA 快捷编辑、简化节点编辑与全屏预览,并保持与本地 ComfyUI 实例对接。安装走官方插件索引与 npm 包 dsh-comfyui-studio;使用前准备好已运行的 ComfyUI 与符合要求的 DSH 版本。