DSH Visual Workbench：本地 Comfy MCP 可視化工作臺

前言¶

DeepSeek Harness（DSH）的插件化架構要求開發者將各類能力拆解爲獨立的插件。在本地開發場景中，如何將 Obsidian 風格的知識空間、ComfyUI 工作流管理以及 Comfy MCP（Model Context Protocol）的本地交互統一在一個界面中，是一個常見的工程需求。dsh-visual-workbench 是一個面向 DSH 的本地優先可視化工作臺插件，它將知識空間 facets、Comfy MCP 工作流貨架和本地 ComfyUI 操作集成到 DSH 的 conversation view 中，提供了一個統一的工作臺。

這是什麼¶

該插件由 Destined-at-Dawn 維護，採用 MIT 許可證。它通過三個層次構建了本地工作流環境：

靜態清單與門禁：包含靜態的 dsh-std v0.15 manifest 和離線門禁配置。
DSH Host：導出 Cordis apply(ctx)，註冊 dsh_visual_workbench_status 和 dsh_visual_workbench_run 兩個模型工具，提供同源的 loopback state、preview 和 run 路由。
DSH Browser Client：通過 conversation.view slot 注入工作臺 tab，展示 Obsidian-style facets、有界 wikilink graph、JSON workflow shelf、Comfy MCP 狀態以及可視化配置入口。

插件僅使用官方 TypeScript MCP client 連接 comfy-mcp，不復制 Comfy MCP 源碼。

核心功能¶

插件主要提供以下能力：

本地 Comfy MCP 可視化配置與測試：在 UI 中直接配置本地連接、端口覆蓋，並支持連接測試。
ComfyUI 生命週期管理：提供“啓動 ComfyUI”按鈕，支持 workflow 預檢、讀取節點目錄和讀取模型文件。
安全防護：內置安全守衛，包括 loopback 地址檢查、token 邊界、路徑邊界和 spending protection（默認不確認花費）。
知識空間集成：讀取配置 workspace 的 facets 和有界 wikilink graph，以及最多 40 個 workflow JSON。

安裝與啓用¶

使用該插件需要滿足 Node.js 版本要求（Node >= 22）。

安裝並構建插件的步驟如下：

pnpm install
pnpm check
pnpm build

構建完成後，package.json 中的 dsh.bundle.patch 會讓 DSH loader 插入 cordis.patch.yml，dsh.client 會提供瀏覽器端 lib/client.js。不同 DSH 發行 profile 的依賴版本可能不同，需按宿主實際包版本調整 peer dependencies。

典型用法¶

使用該工作臺通常需要先準備環境，再進行配置。

準備 Comfy MCP：按照 Comfy-Org/comfy-mcp 的官方說明安裝 comfy-mcp 與 comfy-cli，啓動本地 ComfyUI，並確認 server_info 可用。
配置 DSH Profile：設置必要的環境變量。例如：

DSH_WORKBENCH_ROOT=/absolute/path/to/your/workspace
DSH_COMFY_MCP_COMMAND=comfy-mcp
DSH_COMFY_MCP_ARGS=[]

注意：DSH_COMFY_MCP_ARGS 必須是一個最多包含 8 個字符串的 JSON 數組。

可視化配置與連接：在 DSH 的 Visual Workbench 中，進入 Local Comfy MCP Setup，填寫絕對路徑和可選的本地端口覆蓋。點擊“應用配置並連接”，再點擊“測試連接”。
執行本地操作：連接成功後，在 Local Operations 中點擊“啓動 ComfyUI”、預檢 workflow 或讀取模型。

適用場景與注意¶

該插件適合需要在 DSH Agent 對話中直接調用本地 ComfyUI 工作流，並希望統一管理知識圖譜和配置的開發者。

注意事項：

配置時效性：UI 中的配置是臨時的（in-process），不會把 COMFY_API_KEY 回顯，也不會寫入長期憑據文件。需要長期保存時，應按官方文檔手動配置。
安全邊界：默認傳 confirm_spend=false。只有用戶在界面或模型工具參數中明確給出 true，才允許 Comfy MCP 放行可能收費的 partner nodes。插件不包裝 Agent 填寫的布爾值。
驗證口徑：pnpm check 只能證明 JSON 形狀、來源衛生、TypeScript 類型和確定性測試通過，不能證明 DSH profile 接受、ComfyUI 可運行或 GPU 結果真實有效。
許可證：Comfy MCP 是獨立項目，其許可證邊界以倉庫爲準；插件本身爲 MIT 許可證。

短結尾¶

dsh-visual-workbench 通過可視化的方式降低了本地 Comfy MCP 在 DSH 環境中的配置門檻，將本地工具調用與知識管理整合。你可以通過查看源碼或目錄結構來了解其實現細節。