前言¶
在 DSH 裏做圖像生成，常見做法是手寫 HTTP 調用 ComfyUI，或把整份 workflow JSON 塞進上下文。前者維護成本高，後者節點一多就佔 token，模型還難以判斷「哪些工作流當前可用、缺什麼模型」。若還需要瀏覽歷史出圖、按 sidecar 復跑參數，往往還要再掛一套腳本或相冊類插件。
下面介紹社區插件 dsh-comfyui-workbench（維護者 YuChenLiao，GitHub 倉庫 YuChenLiao/dsh-comfyui-workbench，目錄頁 skillhub.cn）。它在 DSH 側提供資產庫、工作流管理與 ComfyUI 終端三塊界面，並通過一組模型工具把「列出 / 檢查 / 運行 / 編輯」工作流接到對話裏；不內置獨立生圖前端，手工出圖仍可直接打開 ComfyUI。本插件是 dsh-comfyui-album 的繼任者，資產瀏覽能力與相冊同源——兩者同時啓用會出現兩套入口，建議只保留工作臺。
這是什麼¶
一句話：DSH ComfyUI workbench —— 資產庫 + 任意 API 格式工作流執行器（倉庫簡介：asset library + arbitrary workflow runner）。
面向用戶的界面只有三塊：資產庫、工作流管理、ComfyUI 終端，均由 ComfyUI 原生能力支撐，不另建一套平行狀態。工作流對用戶只暴露輸入與輸出；節點級細節通過 comfyui_workflow_inspect、comfyui_node_search 等工具按需查看。哪些工作流對模型「可用」由工作流目錄裏 <id>.meta.json 的 enabled 控制（缺省爲 true），面板與 comfyui_workflow_edit 寫同一份文件。
六個可獨立開關的組件¶
安裝後會在 profile 的 cordis.patch.yml 裏插入多條 loader entry，在宿主「設置 → 插件」中可單獨開關。關掉某一條隻影響它自己；關掉 comfyui-workbench:core 等於關掉整個插件（HTTP API 與瀏覽器端都會消失）。關掉 gallery 時資產庫路由 404，工作流管理與工具仍可用（批量導出工作流 ZIP 依賴相冊讀圖與 sidecar，需保留 gallery）。
| entry | 形態 | 職責 |
|---|---|---|
comfyui-workbench:core |
服務端 | 共享運行時（ComfyUI 客戶端 / 進程託管 / 資產索引 / 產物目錄）與瀏覽器端 |
comfyui-workbench:gallery |
面板 | 資產庫：列表、篩選、縮略圖、刪除、批量導出工作流 ZIP |
comfyui-workbench:workflow |
面板 | 工作流列表、enabled 開關、用途備註，以及 /run、/config 等 |
comfyui-workbench:generate |
工具 | comfyui_workflow_list、comfyui_run、comfyui_run_batch 等運行類工具 |
comfyui-workbench:edit |
工具 | comfyui_workflow_edit |
comfyui-workbench:danbooru |
工具 | danbooru_lookup 等標籤庫工具，不依賴 ComfyUI 運行時，可單獨關閉 |
comfyui-workbench:terminal |
面板 | 展示 ComfyUI 子進程輸出或 user/comfyui.log，可在面板上拉起服務 |
模型側能做什麼¶
工作流執行默認 異步：comfyui_run 提交後返回 promptId，後臺盯守並在出圖後通知對話；也可用 wait: true 同步等待。停用（enabled: false）的工作流會被拒絕執行。comfyui_rerun 從產物旁 sidecar 讀取當時的參數再跑，不必手抄 seed。comfyui_run_batch 一次提交多組任務，單條失敗不影響其它條。
輔助能力包括：comfyui_workflow_list 只列出可用工作流並摘要底模與 IO 形狀；comfyui_workflow_inspect 查看整圖 IO 或單節點配置，並報告缺節點、缺模型；comfyui_workflow_edit 改標題、說明或單節點參數（變量綁定項需經 comfyui_run 的 vars 傳入）；comfyui_runs 查排隊與完成狀態（進度字段僅在開啓 progressStream 且經面板 /run 提交時纔有）。寫提示詞前可用 danbooru_lookup 把中文名對齊 Danbooru tag，插件內聚中文標籤數據（來源 danbooru-tags-data-zh），本地未命中時會走在線接口。
安裝與啓用¶
DeepSeek Harness 採用「一切皆插件」的擴展方式；社區目錄 skillhub.cn 與 DeepSeek / 幻方無官方從屬關係，安裝前請自行查看倉庫源碼與許可證。插件以當前 DSH 進程權限運行，會訪問本機 ComfyUI 地址、工作區與配置的目錄。
發佈態安裝命令如下（來自倉庫 README）：
dsh plugin --profile desktop add github:YuChenLiao/dsh-comfyui-workbench
本地開發可改用 link: 指向倉庫路徑。裝完後 重啓 DSH。cordis.patch.yml 會插入七條 entry（包根 core + 六個組件），配置通過 YAML 錨點共享，例如：
- insert:
- id: comfyui-workbench:core
name: dsh-comfyui-workbench
config: &cwf
baseUrl: http://127.0.0.1:8188
autoStart: true
disabledComponents: []
- id: comfyui-workbench:gallery
name: dsh-comfyui-workbench/gallery
config: *cwf
常用配置項：
| 字段 | 說明 |
|---|---|
baseUrl |
ComfyUI 地址，默認 http://127.0.0.1:8188 |
outputDir |
產物目錄；留空時優先 <當前工作區>/comfyui-output |
workflowsDir |
工作流倉庫，默認 ~/.dsh-comfyui-workbench/workflows |
autoStart |
探測到本機安裝時是否自動拉起 ComfyUI |
disabledComponents |
要關閉的組件，如 ['panel.gallery'] |
progressStream |
是否經 /ws 讀精確進度；也可在工作流管理面板上開關，或設環境變量 COMFYUI_PROGRESS_WS=1 |
典型用法¶
1、先讓模型看見可用工作流
對話中模型調用 comfyui_workflow_list，得到 id、標題、用途備註、底模與輸入種類；被停用的工作流不會出現在列表裏（返回裏的 hiddenCount 表示藏了幾條）。
2、檢查再運行
對選定 id 調用 comfyui_workflow_inspect 確認缺模型或缺節點；再通過 comfyui_run 傳入工作流 id 與變量。默認異步，返回 promptId 後用 comfyui_runs 查狀態，或下次回合等待插件主動通知。
3、面板側手工試跑
在 DSH 裏打開「工作流管理」面板，對已啓用條目使用 /run；需要精確進度時在面板上打開 progressStream（寫入插件數據目錄的 settings.json）。
4、提示詞 tag 對齊（可選）
{ "ok": true, "tags": ["ganyu_(genshin_impact)"], "source": "local" }
上例爲 danbooru_lookup 的典型返回形態：只返回 tag，便於模型寫 prompt 時不跑偏。需要更新本地中文庫時，在 package.json 所在目錄（安裝後多爲 node_modules/dsh-comfyui-workbench/）執行：
npm run danbooru:zh
數據寫入 ~/.dsh-comfyui-workbench/danbooru/，不會改動隨包分發的 data/danbooru/ 快照。
適用場景與注意¶
適合：已在本地或局域網跑 ComfyUI、希望 DSH 智能體按「可用工作流清單」自動出圖並管理產物；需要資產庫統一瀏覽工作區與產物目錄；希望模型用工具改參數、批量跑圖或從 sidecar 復跑。
注意：
- 與
dsh-comfyui-album不要長期並存；從相冊遷移需使用倉庫內的scripts/migrate-album.mjs（須在有該腳本的倉庫目錄執行，README 說明僅發佈包內不含該腳本的完整遷移路徑時需 clone 倉庫再跑——按你實際安裝方式閱讀 README 對應段落）。 danbooru_sync全量同步請求量極大，僅在明確需要時調用；日常可依賴隨包數據或npm run danbooru:zh。- 當前 package 版本爲 0.5.1（以倉庫
package.json爲準）；GitHub 星標約 7（以目錄頁/倉庫爲準，會隨時間變化）。
結尾¶
dsh-comfyui-workbench 把 ComfyUI 的 workflow API、產物索引和 Danbooru 標籤查詢收進同一套 DSH 插件：人看三塊面板，模型用一組工具完成 list → inspect → run → rerun。進一步瞭解請閱 GitHub README 與 SkillHub 目錄頁。
