dsh-comfyui:讓 DeepSeek Harness Agent 驅動 ComfyUI 生成內容

前言

DSH 插件生態強調「一切皆插件」。這裏的社區目錄是獨立站點,不與 DeepSeek / 幻方存在官方從屬關係,本文只按插件事實介紹。

對要在 DeepSeek Harness(DSH)裏接入 ComfyUI 的開發者來說,常見難點有幾個:Agent 需要知道當前服務器支持哪些節點、工作流有哪些參數;生成結果需要在面板裏預覽和下載;遠程 ComfyUI 的 API Key 不應直接下發到瀏覽器;複雜工作流的注意事項也容易被 Agent 漏掉。

dsh-comfyui 把這些事情收進一個插件:Agent 工具、UI 面板、工作流技能包、同源媒體代理,都由插件提供。

這是什麼

dsh-comfyui 是 fandc520 維護的 DSH 插件,MIT 許可。

它讓 DeepSeek Harness 的 Agent 智能驅動本地或遠程 ComfyUI 生成任何內容,附帶工作流、資產管理面板與技能包管理掛載。

下面介紹它的核心能力、安裝方式、典型用法和注意事項。

版本、依賴與安裝

先確認版本配對,再執行安裝。已覈實事實給出的版本要求如下:

dsh-comfyui 0.4.0
DeepSeek Harness >= 0.1.2

dsh-comfyui 0.3.x beta 線
DeepSeek Harness 0.1.1

如果版本不配對,dshmarket 會報風險提示。

安裝命令:

dsh plugin --profile web add dsh-comfyui

運行環境要求包括:

DeepSeek Harness web/desktop profile
運行中的 ComfyUI 服務器
默認服務器地址 http://127.0.0.1:8188
Node >=22.19
@deepseek-ai/cordis ^4.0.1
@deepseek-ai/dsh-settings ^0.1.2-alpha.4

如果要使用 video 模板,還需要:

ComfyUI-WanVideoWrapper
Wan 2.1 模型

Agent 工具

插件給 Agent 提供四個工具。

comfyui_run

comfyui_run 用於提交生成任務。

它可以提交 API 格式工作流,也可以使用內置模板:

txt2img
img2img
video

它支持兩種執行方式:

同步等待
異步後臺任務

comfyui_object_info

comfyui_object_info 用於列出服務器支持的節點定義。

Agent 可以基於節點定義現場構造合法工作流,而不是憑空猜測節點名和參數名。

comfyui_workflow

comfyui_workflow 用於管理工作流庫。

它支持以下操作:

list
run
skill
refresh

comfyui_skill

comfyui_skill 用於讀寫工作流技能包。

它支持以下操作:

list
read
write
append
mkdir
rename
delete
enable
require

UI 面板

插件提供 UI 面板,包含三個頁籤:

工作流
資產
隊列

各頁籤承擔的職責如下:

  • 工作流:工作流管理。
  • 資產:生成結果預覽下載。
  • 隊列:隊列操作。

加載區

加載區提供媒體加載器,可可視化選擇:

圖片
視頻
音頻

已放入的素材會按順序自動填入工作流中未顯式指定的加載參數。

這樣 Agent 不需要猜文件名,也可以按加載區素材完成對應任務。

工作流技能包

工作流技能包用於沉澱某個工作流的使用說明。

它支持以下能力:

按需三級披露文檔
面板編輯
Agent 編寫
運行前必讀校驗

參數清單隻能說明工作流有哪些參數,而技能包可以繼續補充適用場景、關鍵參數和注意事項。Agent 也可以通過 comfyui_skill 工具讀寫技能包。

媒體代理與設置

生成文件會經過同源路由轉發:

/comfyui/media

它按文件名轉發,不依賴 ComfyUI 內存態歷史。

設置頁新增 ComfyUI 分區,可配置:

服務器地址
API Key 環境變量名
本機 ComfyUI 目錄
媒體訪問地址

遠程 ComfyUI 若位於需鑑權的代理之後,可以通過憑據存儲或 apiKeyEnv 指定的環境變量提供密鑰。密鑰絕不發給瀏覽器。

API Key 不下發到瀏覽器;瀏覽器不直接接觸 ComfyUI,避免 CORS 與混合內容問題。

典型用法

可以直接告訴 Agent 下面這些需求:

用 ComfyUI 畫一張紅貓的圖
把這幅圖轉成賽博朋克風格
把加載區這張動漫圖轉成真人照片,分辨率跟原圖一致
生成一段 5 秒的短視頻:日落下的城市
用我之前在 ComfyUI 裏保存的 Krea-Afterlight 跑一下

這些例子對應的是插件已覈實的使用示例,不額外假設額外操作。

適用場景與注意

適合以下場景:

已有 DeepSeek Harness web/desktop profile
有本地或遠程 ComfyUI 服務器
希望 Agent 直接提交 txt2img / img2img / video 任務
需要在面板中管理工作流、查看資產、操作隊列

需要注意:

  1. 先確認 dsh-comfyui 與 DeepSeek Harness 的版本配對。
  2. video 模板依賴 ComfyUI-WanVideoWrapperWan 2.1 模型。
  3. 運行環境需要滿足 Node >=22.19
  4. 插件以當前 dsh 進程權限運行,安裝前應檢查源碼與許可證;當前許可證爲 MIT
  5. 如果使用遠程鑑權,密鑰只放在服務端、憑據存儲或環境變量中,不下發到瀏覽器。

結尾

dsh-comfyui 的價值在於把 ComfyUI 從手動畫布操作變成 DSH Agent 可調用的生成後端:Agent 能提交任務、查看節點、管理工作流和技能包;面板能查看工作流、資產和隊列;媒體經同源路由訪問,API Key 不下發到瀏覽器。

鏈接:

GitHub: https://github.com/fandc520/dsh-comfyui
目錄頁: https://www.skillhub.cn/plugins/fandc520/dsh-comfyui

目錄頁地址來自插件線索;本次已抓取資料未直接出現該 URL。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜