前言¶
DSH 里的模型要出图时，常见做法是调云端接口：有额度消耗，有内容审核，素材也不出本机。dsh-comfyui-studio 换一条路：插件直接调你本机或远程的 ComfyUI，出图、出短视频都走本地 GPU，参数在应用内的控制面板里改，改完写回 cordis.patch.yml，重启后配置还在。
它归 Lcxy0316 所有，仓库是 dsh-comfyui-studio，目录页把它归到「模型推理」一类。README 标注版本 0.2.0、许可证 MIT。下面介绍它怎么装、怎么用。
一、它是什么¶
一句话定位：给 DeepSeek Harness 装上一个「ComfyUI 控制台」，模型（智能体）通过三个工具调用本地 ComfyUI 出图和出短视频。插件不预设任何本机路径，装完是空的，需要自己填。
需要说明的是，你看到的那个插件目录页是独立站点，与 DeepSeek / 幻方没有官方从属关系，不是官方应用商店。
二、提供的三个工具¶
装好之后，模型可以直接调三类接口。
comfyui_generate¶
出图接口。所有参数都可省略，省略就落到设置里的默认值，所以一句 comfyui_generate({ prompt: "..." })就是一次完整调用。
| 参数 | 类型 | 说明 |
|---|---|---|
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_video¶
出视频接口，走 Wan 2.1 文生视频，返回两个产物：mp4 文件和它的首帧 png。原因是对话界面只渲染图片、不播视频，首帧才是能直接看到的那张。
| 参数 | 类型 | 说明 |
|---|---|---|
prompt |
string，必填 | 正向提示词，写清主体、动作、镜头运动 |
negative |
string | 负向提示词，省略用设置默认值 |
width / height |
integer | 像素，自动取 16 的倍数（4G 显存建议 480×832） |
frames |
integer | 帧数，4n+1，如 49 |
fps |
integer | 帧率，如 16 |
steps |
integer | 采样步数，Wan 官方用 20 |
cfg |
number | CFG，Wan 官方用 6.0 |
shift |
number | ModelSamplingSD3 的 shift，Wan2.1 用 8.0 |
seed |
integer | -1 或省略 = 随机 |
filenamePrefix |
string | 落盘文件名前缀 |
comfyui_studio¶
调试与控制接口，按 action 区分：
action |
作用 |
|---|---|
status |
检查连通性、ComfyUI 版本、显卡与显存、默认模型、出图目录 |
models |
列出服务器上所有 checkpoint、VAE、UNET 与文本编码器 |
launch |
启动本机 ComfyUI（用设置里的 python 与参数） |
stop |
停掉本插件启动的那个进程 |
interrupt |
中断当前正在跑的任务 |
三、安装与启用¶
安装按「先拿到目录，再放进 profile，再登记，最后重启」的顺序做。
1. 拿到目录¶
README 提供的是直接下载 zip 的方式，解包后得到 dsh-comfyui-studio 目录：
https://github.com/Lcxy0316/dsh-comfyui-studio/archive/refs/heads/main.zip
2. 放进 profile¶
cp -r dsh-comfyui-studio "$HOME/.dsh/profiles/desktop/node_modules/"
3. 在 package.json 里登记¶
在 profile 的 package.json 里做两处修改：
"dependencies": {
"dsh-comfyui-studio": "file:./node_modules/dsh-comfyui-studio"
}
"dsh": {
"profile": {
"bundles": [
"dsh-comfyui-studio"
]
}
}
4. 重启 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
5. 首次启动要填的四项¶
插件不预设任何本机路径，装完是空的：
| 字段 | 填什么 | 留空的后果 |
|---|---|---|
checkpoint |
点「读取模型」从服务器拉列表选一个 | 出图直接报错，提示你去选 |
outputDir |
一个你有的绝对路径，如 D:/images |
不落盘，图只作为附件回到对话 |
comfyuiDir |
ComfyUI 安装目录（有 main.py 那层） |
「启动服务」按钮不可用 |
pythonPath |
能跑 ComfyUI 的 python.exe |
同上 |
前两项不填也能出图（只要 ComfyUI 已经在跑），后两项只影响一键启动。其余字段（尺寸、步数、提示词等）因人而异，但不改也能跑。
四、典型用法：从探测到出图¶
先做探测，再做模型选择，最后出图。
- 打开设置页，先看连接组。
serverUrl默认http://127.0.0.1:8188，requestTimeoutMs默认 600000（10 分钟），4G 显存跑 832×1216 / 28 步大约 90–120 秒，所以默认超时给得宽。 - 点「读取模型」，从服务器拉列表，选一个
checkpoint。 - 填
outputDir，是一个你有的绝对路径，例如D:/images。 - 调用
comfyui_generate({ prompt: "..." })出图。
常用生成参数：width、height、steps、cfg、sampler、scheduler、batchSize、seed。SDXL 写实模型的常用组合是 dpmpp_2m + karras + CFG 5–6 + 28 步。
提示词有三层来源，优先级是「工具调用显式给的 > 提示词文件 > 设置里的默认值」。字段是 positivePrompt、negativePrompt、positivePromptFile、negativePromptFile。用提示词文件的好处是换词只改 txt，不动插件、不用重启。
输出组里，outputDir 留空等于不落盘；saveToOutputDir 默认 true；filenamePrefix 默认 dsh；attachToConversation 默认 true，决定是否把图内联回对话。
五、硬件预设¶
设置页按 8 组排列（连接、模型、生成参数、提示词、输出、视频、启动器、高级），另有四档硬件预设：
| 预设 | 尺寸 | 步数 | 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 左右）。
六、想用视频要多做一步¶
Wan 2.1 文生视频不是「一个 checkpoint」，它拆成三个文件，都得放进 ComfyUI 的模型目录：
| 文件 | 放到 | 从哪来 |
|---|---|---|
wan2.1_t2v_1.3B_fp16.safetensors |
models/diffusion_models/ |
Comfy-Org/Wan_2.1_ComfyUI_repackaged → split_files/diffusion_models/ |
umt5_xxl_fp8_e4m3fn_scaled.safetensors |
models/text_encoders/ |
同一个仓库 → split_files/text_encoders/ |
wan_2.1_vae.safetensors |
models/vae/ |
同一个仓库 → split_files/vae/ |
国内直连 HuggingFace 一般不通，把域名换成 hf-mirror.com 就行。三个文件合计约 9.8 GB。
放完点一次「读取模型」，再到设置页「视频（Wan 2.1）」这组把 videoUnet、videoClip、videoVae 三项选上。视频组默认值：videoWidth / videoHeight 480 / 832，videoFrames 49，videoFps 16，videoSteps / videoCfg 20 / 6.0，videoSampler / videoScheduler uni_pc / simple，videoShift 8.0。
显存实话：Wan2.1 1.3B 在 4G 上能跑，但慢，480×832 / 49 帧 / 20 步是几分钟级别。先用 frames=9、steps=4 摸通链路，再往上加。1.3B 是 4G 显存唯一现实的选择。
七、排错¶
| 现象 | 原因 | 处理 |
|---|---|---|
状态徽章红，probe 报 ECONNREFUSED |
ComfyUI 没开 | 点「启动服务」，或手动开 |
启动服务 按钮灰 |
comfyuiDir / pythonPath 不对 |
检查目录里有没有 main.py，python 能不能跑 |
出图报 EXECUTION_ERROR |
模型名不对 / 显存爆了 | 点「读取模型」核对名字；降分辨率或加 --lowvram |
| 卡在「生成中」很久 | 首次加载模型要 30–60 秒 | 等；maxPollSeconds 默认 900 |
| 图片显示不出来 | outputDir 不在允许范围内 |
预览只允许读 outputDir 和 workspaceFolder 下的文件 |
| 设置改了重启又变回去 | 改的是暂存值没保存 | 点「保存设置」 |
八、适合谁、注意什么¶
适合已经有本机或远程 ComfyUI、希望模型出图出视频不出本机、且愿意自己在设置页填路径的开发者。不想碰本地环境、只想用现成云端接口的人，这个插件不是对口的选择。
两条提醒。第一，插件本身以当前 dsh 进程的权限运行，安装前应检查它的源码和许可证。第二，它不经过任何云端接口，没有额度消耗、没有内容审核，图片与视频都不出本机——这意味着安全边界完全由你自己的 ComfyUI 环境决定。
九、链接¶
- 插件目录页：https://www.skillhub.cn/plugins/Lcxy0316/dsh-comfyui-studio
- GitHub：https://github.com/Lcxy0316/dsh-comfyui-studio
