前言¶
DeepSeek Harness 的生態理念是“一切皆插件”。對於需要處理複雜視頻生成任務的開發者而言，ComfyUI 提供了極高的靈活性，但直接使用其原生 API 往往缺乏持久化的工作流界面管理，且多服務器調度較爲繁瑣。該插件旨在解決這一問題，通過將 ComfyUI API JSON 導入爲可長期保存的動態工作流頁面，並提供跨服務器的任務隊列管理與輸出歸檔功能。
插件簡介¶
dsh-comfy-video-studio 是一個由 a1303845406 開發的開源工作流插件（MIT 許可證）。它不再內置 MiniMax、Wan 等特定模型模板，而是支持導入任意 ComfyUI API 格式的 JSON，將其轉化爲可視化的工作流頁面，並具備運行時兼容性檢查、多服務器併發管理和視頻輸出管理能力。
核心功能¶
-
API JSON 導入與解析
插件支持導入 ComfyUI 的“導出（API 格式）”產生的 JSON。它會自動識別節點中的常量參數、圖片或視頻上傳接口、枚舉類型、模型引用以及 SaveVideo 輸出節點。 -
運行時兼容性檢查
在導入或運行前，插件會調用目標 ComfyUI 服務器的 /object_info 接口，檢查缺失的節點、模型、無效的枚舉值以及端口類型，防止任務在遠端執行時報錯。 -
工作流頁面管理
導入成功後，用戶可以保存、重命名工作流頁面，並對字段進行編輯。支持修改字段的顯示標籤、分組、順序以及標記高級參數。 -
多服務器與任務隊列
插件支持動態保存多個 ComfyUI 服務器。它能夠檢測各服務器的延遲、設備狀態、顯存佔用和遠端隊列情況。每臺服務器可獨立設置 1 到 3 個插件活動槽。超出活動槽的任務會保留在本地 FIFO 隊列中，等待執行。 -
輸出管理與持久化
所有視頻輸出均會被保存。用戶可以指定其中一個作爲任務的主預覽。工作流、連接、任務和隊列數據會持久化存儲，確保 Harness 重啓後能恢復等待中的任務和已有 prompt_id 的監控狀態。
使用流程¶
- 在“服務器管理”頁面添加或檢查目標 ComfyUI 服務器。
- 在“導入”頁面上傳符合 API 格式的 JSON 文件。
- 查看插件生成的運行時兼容性報告。
- 在工作流定義中選擇主 SaveVideo 輸出節點，並勾選需要在界面上顯示的參數。
- 保存工作流頁面，隨後即可通過動態頁面提交任務。
配置與數據存儲¶
插件支持通過 YAML 配置文件進行基礎設置。默認持久化目錄位於 $DSH_HOME/storages/dsh-comfy-video-studio/，包含連接設置、歷史記錄、原始 JSON 和頁面定義文件。
配置示例：
- insert:
- id: comfy-video-studio
name: dsh-comfy-video-studio
config:
baseUrl: http://127.0.0.1:8188
maxUploadMb: 100
maxWorkflowMb: 5
requestTimeoutMs: 30000
historyLimit: 200
注意事項¶
- JSON 格式限制：插件只支持“導出（API 格式）”產生的 JSON。這種格式要求頂層鍵是節點 ID，每個節點包含
class_type和inputs。畫布 JSON 會被拒絕並提示重新導出。 - 認證方式：服務器地址只接受無內嵌賬號密碼的 HTTP(S) URL。如果 ComfyUI 需要認證，應由反向代理處理。
- 依賴處理：缺失的節點或模型依賴只會阻止任務執行，不會阻止保存工作流頁面。插件不會聯網查詢或自動安裝節點和模型。
- 併發執行：標準單 GPU ComfyUI 通常仍會串行執行遠端 prompt。活動槽 2–3 的設置控制的是插件提前提交任務的數量，並不保證 GPU 在硬件層面真正並行。
結語¶
該插件爲在 DeepSeek Harness 中集成 ComfyUI 提供了標準化的工作流入口和隊列管理方案。開發者可以通過社區目錄頁或 GitHub 倉庫獲取源碼與更多細節。
