dsh-comfyui-web

dsh-comfyui-web

[简体中文](README.md) | [English](README.en.md)

在 dsh 里直接使用 ComfyUI，让 AI 通过 MCP 操作当前工作流。改提示词、调参数、运行生图，节点变化和生成预览都在同一个页面里看得见。

安装

需要已安装的 [dsh](https://github.com/deepseek-ai/deepseek-harness)、pnpm 和本机 ComfyUI，Node.js 22 及以上。

| 插件版本 | 支持的 dsh 版本 |

| --- | --- |

| 0.5.13–0.5.18 | 0.2.0-rc.2、0.2.1-rc.2 |

| 0.5.12 | 0.2.0-rc.2 |

插件通过 engines.dsh 和 DSH peer dependencies 同时声明已验证的宿主版本，兼容新旧宿主的检查方式。其他 DSH 版本需要另行验证；升级后若提示版本不兼容，请先更新插件。

dsh plugin --profile web add github:mangfufu/dsh-comfyui-web

从 DSH 启动本机 ComfyUI（Windows）

只打开 DSH 时，ComfyUI 面板会显示本机启动入口。点击 自动检测，或用 选择文件夹 / 选择启动文件 打开 Windows 文件选择窗口；也可以手动填写绝对路径。支持任意名称的 .exe 启动器、.bat / .cmd / .ps1 启动脚本、.lnk 快捷方式，以及 ComfyUI 目录 / main.py，不限制启动器品牌，也不要求启动器旁边存在 ComfyUI 源码。

• 直接启动 ComfyUI：使用安装目录里的 Python（支持 AKi、Windows 便携包和本地 .venv / venv），按面板配置的本机地址和端口启动。服务就绪后面板自动连接。
• 使用启动器或脚本：使用自己的启动器、脚本或快捷方式，保留原有启动流程；如果打开的是启动器界面，请在其中点击启动。快捷方式保留其目标参数和工作目录。服务地址和端口需与面板设置一致，服务就绪后 DSH 自动连接。

自动检测只检查已配置路径、常见安装位置和带启动特征的文件名；手动选择文件不限制名称，选择文件夹会列出其中的启动文件。检测不会运行程序。点击启动后会保存入口；仅在识别出 ComfyUI 安装目录时配置桥接扩展，独立启动器沿用已有桥接配置。已运行或正在启动时不会重复启动。启动日志位于 ~/.dsh/comfyui/launch.log，快捷方式目标程序的日志由目标程序管理。PowerShell 脚本遵循本机执行策略，失败时可查看日志。直接启动不会读取第三方启动器的自定义参数。远程 / Docker 地址仍需在对应环境中启动服务。

首次安装时，填写 ComfyUI 前端目录

创建或编辑 ~/.dsh/comfyui/config.json，将示例中的前端目录替换为本机实际路径。Windows 的 ~ 是用户目录；Linux 同样填写实际路径。

{
  "url": "http://127.0.0.1:8188",
  "frontendExtensionsDir": "D:/ComfyUI/python/Lib/site-packages/comfyui_frontend_package/static/extensions"
}

首次安装或更新后，先保存工作流，再刷新已打开的 ComfyUI 原网页和 dsh 内的面板。

目录未配置或写入失败时，面板的 连接设置和 dsh 启动日志会提示原因。能看到 ComfyUI 网页，还需等到 AI 已连接 才能让 AI 操作。

Docker / WSL 中的 ComfyUI

推荐使用已经持久化挂载的 custom_nodes 目录。编辑运行 dsh 的系统中的 ~/.dsh/comfyui/config.json：

{
  "url": "http://127.0.0.1:8188",
  "customNodesDir": "/mnt/data/ai/comfyui/storage-nodes/custom_nodes"
}

上面是 Linux 路径示例。dsh 在 Windows 运行时，应填写 Windows 能写入的路径，例如 D:/ComfyUI/custom_nodes，或实际 WSL 发行版的共享目录 //wsl.localhost/Ubuntu/mnt/data/ai/comfyui/storage-nodes/custom_nodes。

确认对应宿主目录已挂载到容器的 custom_nodes，例如：

volumes:
  - /mnt/data/ai/comfyui/storage-nodes/custom_nodes:/root/ComfyUI/custom_nodes

启动 dsh 后会生成 dsh-comfyui-bridge 扩展。先保存工作流，再重启 ComfyUI、刷新 dsh 面板。扩展保存在挂载目录中，容器重建后仍保留。

customNodesDir 与 frontendExtensionsDir 二选一。如果沿用前端目录方式，目录同样必须是 dsh 可写、容器可见 的持久化挂载路径，不能直接填写容器内的 /usr/local/... 路径。

如果 Windows 无法直接访问挂载目录，也可在该目录手动创建 dsh-comfyui-bridge/__init__.py：

WEB_DIRECTORY = "./web"
NODE_CLASS_MAPPINGS = {}

再将插件中的 comfy-extension.js 复制为 dsh-comfyui-bridge/web/loader.js，重启 ComfyUI。从 dsh 面板打开时会自动取得桥接地址，无需编辑脚本。手动安装完成并连接后，可忽略宿主的“尚未配置”日志提示。

使用

1. 启动并打开

1. 先启动 ComfyUI。

2. 启动 dsh web，打开 http://127.0.0.1:3080。

3. 进入对话，点击右上角 ComfyUI。

左边聊需求，右边改节点、看预览。手动编辑和 AI 操作都落在当前工作流上。

插件界面跟随 dsh 的语言设置，支持中文和 English。ComfyUI 自身的语言在 ComfyUI 设置中选择。

2. 确认连接地址

默认连接 http://127.0.0.1:8188。如果更换了端口，打开 连接设置，修改地址后点击 保存并连接。

MCP 默认开启，dsh 已自动接入。这里也能关闭 MCP，或复制配置给其他本机 AI 客户端使用。

3. 让 AI 操作工作流