comfyui-bus 是一款专为解决大型 ComfyUI 工作流中连线混乱问题而设计的前端扩展插件。它引入了“总线(Bus)”概念,允许用户通过 ID 在不同节点间传递数据,无需物理连线即可实现数据的继承、覆盖和共享。该插件完全基于前端 JavaScript 实现,零后端依赖,确保生成的 API 提示与普通手动连线的工作流完全一致,从而保持缓存、验证及导出的稳定性。
- GitHub:https://github.com/javierportillo/comfyui-bus

核心痛点与解决方案
在复杂的 ComfyUI 工作流中,传统的连线方式往往导致画布难以阅读、修改困难且容易出错。comfyui-bus 通过以下机制修复了传统上下文/总线节点的弱点:
- 🔌 动态成员管理:只需将输出线拖入 Bus 尾部的
+槽,即可自动创建并注册一个成员。断开连接不会删除成员,移除操作需刻意执行,确保结构稳定。 - 🧬 远程继承与无连线传输:为 Bus 设置一个唯一的
id,其他任何位置的 Bus 节点只需选择该id作为源,即可瞬间获取所有成员数据,彻底消除跨画布的长距离连线。 - 🪢 灵活的覆盖机制:在下游 Bus 中插入输入线即可临时覆盖继承的值,拔掉后自动恢复原始继承值,方便进行局部调试或变体测试。
- ✏️ 身份与标签分离:成员的身份由隐藏的 UID 决定,而非显示的名称。这意味着你可以随意重命名、重新排序成员,而不会破坏下游的任何连接。
- 🛡️ 智能错误报告:在排队生成前,系统会自动检测未喂入的成员、缺失的源、重复的 ID 或循环依赖,并通过清晰的消息提示用户。
快速上手指南
- 安装:
- ComfyUI Manager:搜索 “Bus” 并安装。
- Comfy CLI:运行
comfy node install comfyui-bus。 - 手动:克隆仓库至
ComfyUI/custom_nodes并重启。 - 要求:ComfyUI 前端版本 ≥ 1.58.5,无 Python 依赖。
- 基本用法:
- 发布数据:添加一个 Bus 节点,设置
id(例如load)。将任意输出(如加载的图片、潜变量等)拖入其+槽,创建成员。 - 接收数据:在画布另一处添加第二个 Bus 节点,将
source设置为load。此时它会以灰色显示所有来自源 Bus 的成员。 - 使用数据:将 Bus 的输出连接到需要这些数据的节点。
- 局部覆盖:若想修改某个成员的值,直接在该 Bus 对应的输入槽插入新的连线即可;拔掉连线则恢复继承值。
- 发布数据:添加一个 Bus 节点,设置
高级行为与技巧
| 操作 | 结果 |
|---|---|
| 更改源 ID | 成员按 UID 重新映射。不匹配的已连线输出变为“孤儿”(红色),不匹配的覆盖变为本地成员。 |
| 上游重命名/排序 | 变更自动向下流动,下游连接不受影响。 |
| 上游删除成员 | 下游对应成员消失。若下游曾对该成员进行过覆盖,则该覆盖值会保留为本地成员。 |
| 复制/克隆 Bus | 成员保持 UID。若出现重复 ID,系统会自动添加 _N 后缀。副本会从复制的发布者读取数据。 |
| 子图支持 | Bus 在其自身图及每个封闭图中可见,子图可以直接读取外部 Bus 的数据。 |
技术优势:零后端足迹
comfyui-bus 的核心优势在于其纯前端实现。当工作流发送到后端执行时,Bus 节点会被解析为普通的链接关系。这意味着:
- 兼容性完美:生成的 JSON 提示与手动连线的工作流无异。
- 缓存有效:不影响 ComfyUI 的原生缓存机制。
- API 导出稳定:通过 API 调用的行为与界面操作完全一致。
已知限制
- 未喂入的成员在排队时会为每个已连线的消费者报告警告,即使该分支并未实际运行。
- 当成员直接连接到子图的输入或输出节点时,系统会拒绝重新排序成员以防止逻辑混乱。
- 目前主要针对经典画布渲染器构建,Vue 节点模式下的兼容性尚未经过充分测试。
comfyui-bus 是管理大规模、模块化 ComfyUI 工作流的利器,它让数据流变得清晰、可控且易于维护,是每一位资深 ComfyUI 用户值得拥有的效率工具。
© 版权声明
文章版权归作者所有,未经允许请勿转载。















