seek://map/dsh-comfyui-canvas
dsh-comfyui-canvas 可视化画布
#comfyui #canvas #workflow #image-generation #multimodal
TL;DR
据其 README,dsh-comfyui-canvas 把 ComfyUI(本地或云端)以「画布左 + 对话右」的分屏形态嵌入 DSH Web,自称「可视化工作流 IDE」:agent 操作你正在看的活画布——节点出现、连线接上、参数变化、运行触发全部实时可见,而非黑盒改 JSON;产出覆盖图像、音乐、视频与 3D,经 get_outputs 直接带回对话。包内自带 ComfyUI 侧桥接节点(一键安装),内置画布、管理、视频音频、节点开发技能包,batch_run 支持参数矩阵批量扫参,export_api 可导出给 comfy-cli 或 MCP 无人值守复跑。由 wbin0001 维护;npm 包 dsh-comfyui-canvas 已发布,本站 2026-09-14 探测 registry,latest 读到 0.1.7,与其 README 徽章一致。
dsh-comfyui-canvas 把本地或云端的 ComfyUI 以「画布左 + 对话右」的分屏形态嵌入 DSH Web:agent 操作你正在看的活画布——节点、连线、参数、运行、查错全程可见,而非黑盒改 JSON;图像、音乐、视频与 3D 产物直接带回对话,每次下载追加 runs.json 可回溯生成参数,ComfyUI 侧桥接节点内嵌于包内、一键安装。需要无人值守规模化时,export_api 把调好的图导出交给 comfy-cli 或 MCP——据其 README,两者并非二选一,而是互补的驾驶方式。它与本图谱 dsh-image-gen 条目共用 comfyui 标签但属不同项目:前者是接多家 Provider 的 BYOK 图像套件,本插件驱动的是 ComfyUI 本身。
速览
- install
- dsh plugin add dsh-comfyui-canvas
- platforms
- Windows · macOS · Linux
- license
- MIT
- note
- 据其 README:需运行中的 ComfyUI 与已装桥接节点、且浏览器打开过画布页;comfyui_reload 仅支持 Windows;非官方桌面封装不保证兼容。
要点
- 据其 README,分屏形态自 v0.1.4 起完全自包含:只用官方 DSH 插槽(conversation.session.header.utilities)与 DOM data-* 锚点、零核心改动,任何官方 DSH v0.1.x(含带破坏性 client 更新的 v0.1.2+)开箱即用、无需补丁;README 同时提醒:非官方桌面封装不保证兼容,请以官方 DSH 为准
- 画布操作工具组覆盖 read_workflow / add_node / connect / set_param / remove_node / inject_text / load_workflow / run / debug / clear / group:在活画布上搭建与修复工作流,group 把复杂工作流分成具名组(提示词区 / 采样区 / 输出区),inject_text 把对话文本注入为可连线节点;agent 操作的是用户正在看的画布,每步实时可见而非黑盒改 JSON
- 生产工具:batch_run 支持显式 runs 或声明式 matrix(zip 并行槽位 / product 笛卡尔展开)做参数矩阵批量扫描;get_outputs 把图像、视频、GIF、音频取回对话,outputStem 自动编号(stem.01.png)、永不覆盖;attach_file 可把本机任意文件(图片/音频/视频/3D/文本)上传进 ComfyUI input/;export_api 导出 API 格式工作流供 comfy-cli 无人值守批量
- 桥接节点是唯一的 ComfyUI 侧依赖:暴露 /dsh-bridge/* 路由并经 app.registerExtension 注入画布页;setup_bridge 检测/安装/更新它到 custom_nodes/(幂等、校验文件、提示何时重启),桥接内嵌于包内 comfyui-bridge/ComfyUI-DSH-Canvas,离线机器可手动复制;云端 ComfyUI 需把桥接装在「跑 ComfyUI 的那台机器」上
- 项目目录与溯源:下载默认落「项目目录」(默认 <工作区>/projects,设置页可改);每次下载追加 runs.json(promptId / overrides / 时间戳 / 文件),任意产物可回溯生成参数;运行失败返回结构化 executionError(节点 id / 节点类型 / 异常 / 信息)而非一堵 JSON 墙
- 内置技能包随插件自带、无需额外配置:comfyui-canvas-ops(读→确认→改→跑→取回→自检)、comfyui-admin-ops(配置/启动/升级/节点管理)、comfyui-video-audio-ops(视频+配音/音轨)、comfyui-dev-ops(开发/调试自定义节点);升级工具 comfyui_upgrade 可并发更新核心与全部 git 自定义节点(跳过本地改过的仓库)
- 安全模型据其 README:默认桥接无鉴权,与 ComfyUI 自身 /prompt 的信任模型一致——能访问端口者可读画布、上报状态、下发命令(run 会消耗 GPU);命令在前端有白名单、无法执行任意代码,但 README 明言这个攻击面真实存在;可选共享 DSH_BRIDGE_TOKEN(agent 侧请求须带 Bearer),README 建议 ComfyUI 保持绑定回环地址;平台支持 Windows / macOS / Linux,已知问题 comfyui_reload 仅支持 Windows
常见问题
它和本地图谱的 dsh-image-gen 条目是什么关系?
不同作者的独立项目,互补而非重复:dsh-image-gen 是 BYOK 图像创作套件,把 Gemini、OpenAI Images、Seedream、DashScope 及本地 ComfyUI 等多家提供方接进 DSH 做对话生图、连续修图、Studio 批量与多模型对比;dsh-comfyui-canvas 则把 ComfyUI 本身当「可视化工作流 IDE」驱动——操作节点、连线、参数与运行,产出还覆盖音乐、视频与 3D。
只想无人值守批量跑,需要装这个画布插件吗?
据其 README,不必:画布插件的定位是「正在看画布时」的搭建与调优(IDE 角色);无人值守 / 规模化场景,用 export_api 把调好的图导出为 API 格式工作流,交给 ComfyUI 官方的 comfy-cli(pip 安装的独立 CLI,非 DSH 插件)或 MCP 服务器无头复跑即可——据其 README,两者互补而非替代的驾驶方式。
把 ComfyUI 暴露到局域网或云端安全吗?
据其 README 安全章节:默认桥接无鉴权(与 ComfyUI /prompt 信任模型一致),任何能访问 ComfyUI 端口的人都能读画布、上报状态、下发命令,run 会消耗 GPU;命令白名单挡住任意代码执行,但攻击面真实存在。建议 ComfyUI 保持绑定回环地址;确需暴露时,在 DSH 与 ComfyUI 双侧设置一致的 DSH_BRIDGE_TOKEN,此后由 agent 发起的读画布 / 下发命令 / 轮询结果请求都必须携带 Bearer Token;前端自身的 /report 与结果回传保持开放,只改动内存快照、从不触发执行。
云端或托管 SaaS 的 ComfyUI 怎么接?
据其 README:云端 / 远程 ComfyUI 需把桥接节点装在「跑 ComfyUI 的那台机器」上(npm pack 解包复制,或从 GitHub 稀疏检出桥接目录),重启后把插件 baseUrl 指向云端地址,推荐两端设一致的 DSH_BRIDGE_TOKEN;托管 SaaS 若只有 API、无 shell、装不了自定义节点,则桥接与可视化画布均不可用,走纯 API/MCP 路径(export_api → comfy-cli / MCP server),此时 comfyui_config 会报告 bridgeInstalled: false。
官方参考
- docsRepository ↗
- docsREADME (English) ↗
- docs中文 README ↗
- docsnpm package page ↗