dsh-comfyui-studio
在 DeepSeek Harness 里直接调用本机（或远程）ComfyUI 出图。全部参数都能在 GUI 里改，改完写回 cordis.patch.yml，重启后依然是你的配置。
- 模型、尺寸、步数、CFG、采样器、调度器、种子、批量 —— 全部可调
- 提示词可以写在设置里，也可以指向磁盘上的
.txt（改文件即改词，不用动插件） - 自带启动器：ComfyUI 没开时，一个按钮拉起本机进程（可配 python 路径与启动参数）
- 自带调试面板：探测连通性、读模型列表、试跑一张、中断任务、看显存
- 硬件预设：4G / 8G / 16G / 远程服务器，一键套用
- 中英双语，跟随 DSH 主题
- 不经过任何云端接口：没有额度消耗，没有内容审核，图片不出本机
实测
RTX 3050 Laptop（4G 显存）+ RealVisXL V4.0 + --lowvram --reserve-vram 0.4：
| 分辨率 | 步数 | 耗时 |
|---|---|---|
| 512×512 | 8 | 15 秒 |
| 832×1216 | 28 | 41 秒 |
1. 它给你两个工具
装好之后，模型（也就是我）可以直接调：
comfyui_generate
| 参数 | 类型 | 说明 |
|---|---|---|
prompt |
string，必填 | 正向提示词。英文效果最好 |
negative |
string | 负向提示词，省略用设置里的默认值 |
width / height |
integer | 像素，自动取 8 的倍数 |
steps |
integer | 采样步数 |
cfg |
number | CFG 强度 |
sampler |
string | 如 dpmpp_2m |
scheduler |
string | 如 karras |
seed |
integer | -1 或省略 = 每次随机 |
batch |
integer | 一次几张 |
checkpoint |
string | checkpoint 文件名 |
filenamePrefix |
string | 落盘文件名前缀 |
所有参数都可以省略，省略就落到设置里的默认值 —— 所以一句 comfyui_generate({ prompt: "..." }) 就是一次完整调用。
comfyui_studio
action |
作用 |
|---|---|
status |
检查连通性、ComfyUI 版本、显卡与显存、默认模型、出图目录 |
models |
列出服务器上所有 checkpoint 与 VAE |
launch |
启动本机 ComfyUI（用设置里的 python 与参数） |
stop |
停掉本插件启动的那个进程 |
interrupt |
中断当前正在跑的任务 |
2. 安装
2.0 一键（推荐）
git clone https://github.com/Lcxy0316/dsh-comfyui-studio.git
cd dsh-comfyui-studio
然后把目录拷进 profile 并登记，见下。
不想用 git 就直接下 zip：
https://github.com/Lcxy0316/dsh-comfyui-studio/archive/refs/heads/main.zip
2.1 已经装好 ComfyUI 的机器
# 1. 把整个目录放进 profile
cp -r dsh-comfyui-studio "$HOME/.dsh/profiles/desktop/node_modules/"
# 2. 在 profile 的 package.json 里登记
# dependencies 里加： "dsh-comfyui-studio": "file:./node_modules/dsh-comfyui-studio"
# dsh.profile.bundles 末尾加： "dsh-comfyui-studio"
# 3. 重启 DSH
插件自带的 cordis.patch.yml 会作为 bundle 层自动生效，用户层不用加任何东西。要覆盖默认值时才在 profile 的 cordis.patch.yml 末尾追加：
- id: comfyui-studio
name: dsh-comfyui-studio
config:
serverUrl: http://127.0.0.1:8188
outputDir: D:/images
2.2 还没装 ComfyUI
按官方方式装一份 ComfyUI（Windows 便携包最省事），然后在插件设置页填两个路径：
- ComfyUI 目录 →
.../ComfyUI（里面有main.py的那一层） - Python 可执行文件 →
.../python_embeded/python.exe（便携包）或你的 venv 里的python.exe
填完点「探测服务」。没起来就点「启动服务」。
2.3 首次启动要填的四项
插件不预设任何本机路径，装完是空的，必须自己填：
| 字段 | 填什么 | 留空的后果 |
|---|---|---|
checkpoint |
点「读取模型」从服务器拉列表选一个 | 出图直接报错，提示你去选 |
outputDir |
一个你有的绝对路径，如 D:/images |
不落盘，图只作为附件回到对话 |
comfyuiDir |
ComfyUI 安装目录（有 main.py 那层） |
「启动服务」按钮不可用 |
pythonPath |
能跑 ComfyUI 的 python.exe |
同上 |
前两项不填也能出图（只要 ComfyUI 已经在跑），后两项只影响「一键启动」。
其余字段（尺寸、步数、提示词……）因人而异，但不改也能跑。
3. 配置项全表
设置页按 7 组排列，每个字段下面都有说明。这里只列关键的：
连接
| 字段 | 默认 | 说明 |
|---|---|---|
serverUrl |
http://127.0.0.1:8188 |
ComfyUI 地址 |
requestTimeoutMs |
600000 |
单次生成总超时（10 分钟） |
pollIntervalMs |
1000 |
轮询间隔 |
maxPollSeconds |
900 |
超过就放弃 |
4G 显存跑 832×1216 / 28 步大约 90–120 秒，所以默认超时给得很宽。
模型
| 字段 | 说明 |
|---|---|
checkpoint |
空。点「读取模型」从服务器拉列表选一个 |
vae |
留空用 checkpoint 自带的 |
生成参数
width height steps cfg sampler scheduler batchSize seed
SDXL 写实模型的常用组合：dpmpp_2m + karras + CFG 5–6 + 28 步。
提示词
| 字段 | 说明 |
|---|---|
positivePrompt |
默认正向词 |
negativePrompt |
默认负向词 |
positivePromptFile |
填了就覆盖上面的正向词；相对路径基于 ComfyUI 目录 |
negativePromptFile |
同上，负向 |
优先级：工具调用显式给的 > 提示词文件 > 设置里的默认值。
用提示词文件的好处：换词只改 txt，不动插件、不用重启。
输出
| 字段 | 默认 | 说明 |
|---|---|---|
outputDir |
空 | 每张图落盘的位置；空 = 不落盘 |
saveToOutputDir |
true |
关掉就只作为附件返回 |
filenamePrefix |
dsh |
文件名前缀 |
attachToConversation |
true |
是否把图内联回对话 |
saveImagesToWorkspace |
false |
额外往会话工作区拷一份 |
workspaceFolder |
comfyui-studio |
上面那个子目录名 |
启动器
| 字段 | 说明 |
|---|---|
launcherEnabled |
允许插件拉起本机 ComfyUI |
comfyuiDir |
空。ComfyUI 安装目录 |
pythonPath |
空。python.exe 路径 |
launchArgs |
启动参数，4G 显存必须带 --lowvram --reserve-vram 0.4 |
autoLaunchOnGenerate |
出图时发现服务没开就自动拉起 |
launchWaitSeconds |
等它起来的最长秒数 |
高级
| 字段 | 说明 |
|---|---|
preset |
当前硬件预设（只是记录，改参数要点「套用预设」） |
extraWorkflowJson |
自定义 ComfyUI API 工作流 JSON，会覆盖默认图的已知节点 |
4. 硬件预设
| 预设 | 尺寸 | 步数 | CFG | 批量 | 启动参数 |
|---|---|---|---|---|---|
| 低显存 4G | 832×1216 | 28 | 5.5 | 1 | --lowvram --reserve-vram 0.4 |
| 中端 8G | 896×1216 | 30 | 6 | 1 | --normalvram |
| 高端 16G | 1024×1408 | 32 | 6 | 2 | --highvram |
| 远程服务器 | 1024×1408 | 30 | 6 | 2 | （空） |
套用预设只改页面上的暂存值，点「保存设置」才写回。
4G 显存的经验值：
- 批量保持 1
- 分辨率别超过 1024×1408
- 要更大就先生成再放大（Hires fix 用
4x-UltraSharp，denoise 0.35 左右）
5. 排错
| 现象 | 原因 | 处理 |
|---|---|---|
状态徽章红，probe 报 ECONNREFUSED |
ComfyUI 没开 | 点「启动服务」，或手动开 |
启动服务 按钮灰 |
comfyuiDir / pythonPath 不对 |
检查目录里有没有 main.py，python 能不能跑 |
出图报 EXECUTION_ERROR |
模型名不对 / 显存爆了 | 点「读取模型」核对名字；降分辨率或加 --lowvram |
| 卡在「生成中」很久 | 首次加载模型要 30–60 秒 | 等；maxPollSeconds 默认 900 |
| 图片显示不出来 | outputDir 不在允许范围内 |
预览只允许读 outputDir 和 workspaceFolder 下的文件 |
| 设置改了重启又变回去 | 改的是暂存值没保存 | 点「保存设置」 |
保存报 Config field ... is not volatile |
字段没标 volatile | 这是插件 bug，提 issue |
调试面板会打印每一步的时间戳与结果，出错时先看那里。
6. 它是怎么工作的
浏览器（设置页 / 输入区药丸）
│ fetch /comfyui-studio/*
▼
宿主（lib/index.js）
│ 读设置 → resolveConfig → planGeneration
▼
lib/comfy.js
│ POST /prompt → 轮询 /history/{id} → GET /view
▼
ComfyUI
- 浏览器半是手写 bundle（
lib/client.js），只require('react')，不需要构建链 - 宿主半是纯 ESM，
@deepseek-ai/*由 DSH 自己的 resolve hook 解析 - 设置全部标了
.volatile()，所以能在运行中写回 - 路由用
ctx.effect持有，reload 不会报 duplicate route
文件：
| 文件 | 行数 | 内容 |
|---|---|---|
lib/config.js |
~350 | schema、默认值、预设、resolveConfig |
lib/comfy.js |
~390 | ComfyUI HTTP 客户端、工作流构造、启动器 |
lib/index.js |
~760 | 路由、工具、设置读写、出图编排 |
lib/client.js |
~1090 | 浏览器 UI（设置页 + 药丸） |
7. 二次开发
改完 lib/*.js 后：
cp -f lib/*.js "$HOME/.dsh/profiles/desktop/node_modules/dsh-comfyui-studio/lib/"
# 重启 DSH
宿主端代码改动需要重启才生效（dsh-hmr 只监视 patch 文件和 manifest，不监视 node_modules 里的源码）。
浏览器半的改动同样需要重启 —— 它的 bundle 由 dsh-client-modules 在 boot 时快照，运行中换文件不会重新读取。
8. 许可
MIT。拿去改，改完记得把 serverUrl / comfyuiDir / pythonPath 换成自己的。
No comments yet. Be the first to write one.