前言¶

在 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:...）：

1. 打開 插件 → 發現，點擊「添加索引源」。
2. 填入插件索引：

https://raw.githubusercontent.com/xingyeai23/dsh-comfyui-studio/main/plugin-index.json

3. 找到「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。

生成第一張圖¶

1. 選擇一個已保存的圖片工作流（列表爲空時，先在 ComfyUI 裏搭建並保存一個圖片工作流）。
2. 填寫正向提示詞（可按需點「AI 轉寫」）。
3. 右下角點「生成」。

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）：

安全：Host 路由只接受同源請求並校驗 base、工作流名和圖片座標；內嵌原生畫布的安全與登錄由 ComfyUI 自身負責。

結尾¶

dsh-comfyui-studio 把 ComfyUI 的高頻操作搬進 DSH 側欄：工作流與提示詞、資產檢查、LoRA 快捷編輯、簡化節點編輯與全屏預覽，並保持與本地 ComfyUI 實例對接。安裝走官方插件索引與 npm 包 dsh-comfyui-studio；使用前準備好已運行的 ComfyUI 與符合要求的 DSH 版本。

• 社區目錄：https://www.skillhub.cn/plugins/xingyeai23/dsh-comfyui-studio
• 源碼與 README：https://github.com/xingyeai23/dsh-comfyui-studio