
DeepSeek Harness 把 dsh-comfyui-panel 變成可啟動 ComfyUI 的開發者工作台,讓生成圖、參數與對話留在同一個側欄。它不是新模型,而是一個通用 ComfyUI 前端,透過 ComfyUI 的 /object_info 讀取節點資料,把 API 格式工作流自動整理成可填寫的表單。
實際操作不只是在旁邊加一個圖片視窗。插件可從 ComfyUI 的 Workflow → Save (API Format) 匯出 JSON,貼入面板後便會辨識正負提示詞、種子、步數、CFG、尺寸、模型、LoRA 強度與圖片輸入,再依語義分組顯示。未知節點亦不會令匯入失敗,只會以「Class · field」形式提供通用控件。
這種做法省掉了在節點圖逐一尋找參數的步驟,但代價是自動表單未必符合每個工作流的閱讀習慣。多段採樣、遮罩或條件分支,會退化為較多通用欄位。插件目前只接受 API 格式工作流,ComfyUI 網頁介面所用的 UI 格式並不支援。
前置環境相當直接:ComfyUI 需在執行,版本建議為 0.26.0 或以上,預設連接 http://127.0.0.1:8188。ComfyUI 目錄必須指向包含 models/、input/、output/ 的位置,否則無法讀取生成圖或複製輸入圖片。自訂工作流也要先在 ComfyUI 網頁內成功出圖,再匯入面板。
硬體需求取決於所選工作流。內置 Krea 2 文生圖與風格參考預設採用 Q2_K 量化,在 8 GB 顯存、1024×1024 解析度及 8 步設定下,約 70 秒完成一次生成。這個數字只適用於內置預設;換用其他模型、節點或採樣設定後,不能直接套用。
插件同時提供面板與 agent 工具兩種入口。krea2_workflows 會列出工作流和可用參數,krea2_generate 則負責提交生成並等待圖片;兩者與面板共用同一條任務佇列、參數驗證及數值限制,因此不會出現一套介面接受、另一套介面拒絕的雙重規則。模型可按工具回傳的參數 ID 填入提示詞、步數與尺寸,毋須自行猜測節點名稱。
這套設計刻意採用串行執行。ComfyUI 的 /interrupt 是全域操作,若兩個生成同時爭用顯存,取消其中一項可能影響另一項。工具逾時設為 11 分鐘,略高於單次生成 10 分鐘上限,讓 agent 較容易先收到任務失敗訊息,而不是只看到工具逾時。
任務提交後,面板會輪詢進度、支援取消、顯示大圖及複製路徑。佇列檢視涵蓋 ComfyUI 的全部工作,而非只顯示插件建立的項目;等待中的任務可移除,亦可清空。歷史圖片則直接掃描 output/,可還原當時參數、在檔案管理器定位或刪除,但不能改名或移動。
面板亦可在本機 ComfyUI 未啟動時將其拉起,使用完成後先卸載模型釋放顯存,再停止程序。這個流程只適用於帶有 python_embeded/ 的 ComfyUI 便攜版;原始碼安裝、conda 環境或遠端 ComfyUI 仍須自行管理程序。若 ComfyUI 正在執行或仍有任何排隊任務,關閉操作會被拒絕,以免中止正在生成的圖片。
接口:
| 方法 | 路徑 | 作用 |
|---|---|---|
| GET | /krea2/status |
ComfyUI 狀態、預設列表與目前設定 |
| POST | /krea2/start |
啟動本機 ComfyUI 便攜版 |
| POST | /krea2/stop |
卸載模型並關閉本機 ComfyUI |
| GET | /krea2/workflow?id= |
取得指定工作流的參數發現結果與保存值 |
| POST | /krea2/workflow |
新增或覆蓋使用者預設 |
| DELETE | /krea2/workflow?id= |
刪除使用者預設 |
| GET/POST | /krea2/settings |
讀取或局部更新設定 |
| POST | /krea2/generate |
提交生成並立即傳回 job |
| GET | /krea2/job?id= |
取得單一任務狀態 |
| GET | /krea2/jobs |
取得最近任務 |
| POST | /krea2/cancel |
取消任務 |
| GET | /krea2/queue |
取得 ComfyUI 執行中及等待中的佇列 |
| POST | /krea2/queue |
移除等待項或清空佇列 |
| GET | /krea2/history?limit= |
掃描 output/ 內的圖片 |
| GET | /krea2/recover?path= |
從 PNG 中繼資料還原當時參數 |
| POST | /krea2/reveal |
在檔案管理器定位檔案 |
| DELETE | /krea2/image?path= |
刪除生成圖片 |
| GET/POST | /krea2/presets |
讀取或保存參數預設 |
| DELETE | /krea2/presets?id= |
刪除參數預設 |
| GET | /krea2/image?path= |
傳回生成圖片位元串流 |
瀏覽器以相對路徑呼叫這些接口,圖片亦由 Host 代理,不會直接連到 ComfyUI。凡帶 ?path= 的請求都會重新解析及核對路徑,只容許落在 output/ 或 temp/ 內;.. 路徑穿越與外部檔案均會以 404 拒絕。
插件與 krea2-mcp 是同一後端的兩個前端,兩者只需安裝其一。dsh-comfyui-panel 專為 DeepSeek Harness 提供面板和工具,krea2-mcp 則是可供其他 MCP 客戶端連接的純 MCP server。同時安裝會留下相近的工具能力,亦可能同時爭用顯存。
維護方面,GitHub Actions 會在每次 push 與 PR 執行語法檢查及 25 項測試,使用 Node 22,約 15 秒完成。測試涵蓋參數發現、工作流合併、路徑安全與工具參數;Host 端模組改動後則需停用再啟用插件,才會重新載入。
程式碼採 MIT 授權,但插件本身不附模型權重。內置 Krea 2 預設對應 Krea 2 Community License,商用須符合相關條件及內容過濾責任;使用其他工作流時,權重亦要遵守各自许可证。單次生成最多 10 分鐘,取消只屬尽力而為,進入採樣的任務仍可能繼續完成。