前言¶
在 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 为准。
