前言¶
在 DeepSeek Harness(DSH)里做 ComfyUI 工作流,常见做法是切到浏览器或单独开画布页面,智能体这边要查节点状态、改图、触发生成,往往得靠手写脚本或零散 API。无界画布本身是面向节点的无限画布前端,若把它的内置 Agent 和 DSH Agent 叠在一起,职责容易搅在一起。
下面介绍社区插件 dsh-wujie-canvas(维护者 1314521gjy):把生产版无界画布打进 DSH 左侧栏,在本机回环地址起静态服务并代理本地网关;画布不自带 Agent,改由 DSH Agent 通过一组工具读写画布、启停本机「无界工作台」。前提是本机已安装无界工作台与 ComfyUI——插件不捆绑 ComfyUI、CUDA、模型或 API Key。
这是什么¶
dsh-wujie-canvas 属于 DSH 社区目录中的客户端类插件(SkillHub:目录页,仓库:GitHub)。当前 release 对应包版本 0.3.0,许可证 MIT;内嵌 web/ 来自 ComfyUI-Local-Infinite-Canvas 生产构建,ComfyUI 本体为 GPL-3.0 且未随插件分发。
运行环境要求:
- DeepSeek Harness 0.2.1 或更新(
package.json中engines.dsh为>=0.2.1-rc.1 <0.3.0-0) - 本机已安装带 ComfyUI 的无界工作台
- Node.js 22+(DSH 通常已提供)
核心功能¶
界面与本地服务¶
- 在 DSH 左侧栏增加 无界画布 入口,画布在中间区域打开。
- 用仅监听回环的服务提供内嵌前端,默认
127.0.0.1:8294。 - 将本机网关
http://127.0.0.1:8190代理到同一 Origin,标签页可查看 gateway / ComfyUI 状态。 - 本机工作台未在线时显示 启动本机工作台 封面;启动须用户明确操作,调用已安装的
start-local.bat(Windows)或start-local.sh(Linux/macOS),不会自动拉起。
DSH Agent 工具(无画布内置 Agent)¶
插件刻意省略画布内置 Agent 与 canvas-assistant 插件加载;DSH 仍是唯一 Agent,通过下列工具操作画布(画布页须打开在某个项目上,状态类与 apply_ops 才有效):
| 工具名 | 作用 |
|---|---|
wujie_canvas_status |
工作台 / 网关 / ComfyUI 状态 |
wujie_canvas_deploy_check |
只读部署检查:工作台、网关、ComfyUI、模型扫描、资源缺口及有序问题列表与修复建议 |
wujie_canvas_start |
显式启动工作台(launcher、gateway、ComfyUI) |
wujie_canvas_state |
项目标题、节点(id/类型/位置/状态/prompt/model)、连线、选区、视口 |
wujie_canvas_apply_ops |
增删改节点、连线、选区、视口、运行生成 |
另附带 wujie-canvas-deploy skill,供 DSH 自行走首次部署或修复流程。DSH 的 whale widget 是独立插件,不是本画布的 Agent。
配置与工作台发现¶
可在 profile 的 cordis.patch.yml 中为插件 dsh-wujie-canvas 增加可选 config:
- id: dsh-wujie-canvas
config:
workbenchRoot: 'C:\path\to\无界工作台'
launcherPort: 8290
gateway: 'http://127.0.0.1:8190'
工作台根目录发现顺序:workbenchRoot → 环境变量 WUJIE_WORKBENCH_ROOT → 插件父目录 → 常见路径(如 ~/Documents、~/Desktop、C:/D:/E:\无界工作台 等)。若脚本不存在,回退为 node launcher/start.mjs --no-open。
画布项目保存在浏览器存储中,与 Origin 绑定:127.0.0.1:8294 插件页与直接在 :3000 打开的画布不共享数据,需用画布自带的导入/导出迁移。
安装与启用¶
社区目录 listing 为可选项,不阻塞直接安装。安装命令以仓库 README 为准。
Web profile:release 包直装¶
dsh plugin --profile web add https://github.com/1314521gjy/dsh-wujie-canvas/releases/download/v0.3.0/dsh-wujie-canvas-0.3.0.tgz
预构建包地址:releases/latest。
仅接受 GitHub 源的 DSH 构建¶
dsh plugin --profile web add github:1314521gjy/dsh-wujie-canvas
桌面版 DSH¶
下载 release 压缩包,用应用内插件管理器安装;若只接受 npm 包名,可用 GitHub 源配合 profile bundle(将目录链到 node_modules,并在 dsh.profile.bundles 中加入 dsh-wujie-canvas)。
安装前建议浏览仓库源码与 LICENSE / NOTICE.md:插件以当前 DSH 进程权限运行,会访问本机工作台路径与回环上的网关。
典型用法¶
- 在本机按无界工作台文档安装 ComfyUI 与网关,确认
8190等端口与插件配置一致。 - 按上文命令为 web profile 安装插件,重启或重载 DSH 后点击左侧 无界画布。
- 若封面提示工作台离线,在界面中执行 启动本机工作台,或让 Agent 调用
wujie_canvas_start(仍为显式启动语义)。 - 首次部署或环境异常时,可让 DSH 使用
wujie-canvas-deployskill,或调用wujie_canvas_deploy_check阅读问题列表再按需修复。 - 打开具体项目后,用
wujie_canvas_state查看图结构,用wujie_canvas_apply_ops改节点、连线或触发生成。
适用场景与注意¶
适合:已在用无界工作台 + ComfyUI,希望在 DSH 单窗口内看图、看网关状态,并由 DSH Agent 统一编排画布与工作台,而不是在画布里再开一个 AI 助手。
不适合:期望插件自带 ComfyUI、模型或云端 Key;或不愿在本机维护无界工作台安装。
注意:
- 画布数据按 Origin 隔离,换端口或换入口要记得导入/导出项目。
- 内嵌前端应使用 release 树构建(README 提及当前捆绑为 v0.24.13 生产树),开发树含未发布实验,不宜直接打进插件。
- DeepSeek Harness 插件生态以「一切皆插件」为方向;SkillHub 等为社区目录,与 DeepSeek / 幻方无官方从属关系,安装来源以 README 与 release 为准。
结尾¶
dsh-wujie-canvas 把无界画布收进 DSH 左侧栏,用回环服务与网关代理对齐本机 ComfyUI,并把画布操作收成 Agent 工具,避免双 Agent 并存。需要目录说明时见 SkillHub 插件页;安装与工具列表以 GitHub 仓库 README 为准。