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 环境中的配置门槛，将本地工具调用与知识管理整合。你可以通过查看源码或目录结构来了解其实现细节。