前言¶
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
