comfyui-bus:终结“意大利面式”布线,为 ComfyUI 带来动态、支持远程的总线节点

插件5小时前发布 小马良
4 0

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

  • GitHub:https://github.com/javierportillo/comfyui-bus
comfyui-bus:终结“意大利面式”布线,为 ComfyUI 带来动态、支持远程的总线节点

核心痛点与解决方案

在复杂的 ComfyUI 工作流中,传统的连线方式往往导致画布难以阅读、修改困难且容易出错。comfyui-bus 通过以下机制修复了传统上下文/总线节点的弱点:

  • 🔌 动态成员管理:只需将输出线拖入 Bus 尾部的 + 槽,即可自动创建并注册一个成员。断开连接不会删除成员,移除操作需刻意执行,确保结构稳定。
  • 🧬 远程继承与无连线传输:为 Bus 设置一个唯一的 id,其他任何位置的 Bus 节点只需选择该 id 作为源,即可瞬间获取所有成员数据,彻底消除跨画布的长距离连线。
  • 🪢 灵活的覆盖机制:在下游 Bus 中插入输入线即可临时覆盖继承的值,拔掉后自动恢复原始继承值,方便进行局部调试或变体测试。
  • ✏️ 身份与标签分离:成员的身份由隐藏的 UID 决定,而非显示的名称。这意味着你可以随意重命名、重新排序成员,而不会破坏下游的任何连接。
  • 🛡️ 智能错误报告:在排队生成前,系统会自动检测未喂入的成员、缺失的源、重复的 ID 或循环依赖,并通过清晰的消息提示用户。

快速上手指南

  1. 安装:
    • ComfyUI Manager:搜索 “Bus” 并安装。
    • Comfy CLI:运行 comfy node install comfyui-bus。
    • 手动:克隆仓库至 ComfyUI/custom_nodes 并重启。
    • 要求:ComfyUI 前端版本 ≥ 1.58.5,无 Python 依赖。
  2. 基本用法:
    • 发布数据:添加一个 Bus 节点,设置 id(例如 load)。将任意输出(如加载的图片、潜变量等)拖入其 + 槽,创建成员。
    • 接收数据:在画布另一处添加第二个 Bus 节点,将 source 设置为 load。此时它会以灰色显示所有来自源 Bus 的成员。
    • 使用数据:将 Bus 的输出连接到需要这些数据的节点。
    • 局部覆盖:若想修改某个成员的值,直接在该 Bus 对应的输入槽插入新的连线即可;拔掉连线则恢复继承值。

高级行为与技巧

操作结果
更改源 ID成员按 UID 重新映射。不匹配的已连线输出变为“孤儿”(红色),不匹配的覆盖变为本地成员。
上游重命名/排序变更自动向下流动,下游连接不受影响。
上游删除成员下游对应成员消失。若下游曾对该成员进行过覆盖,则该覆盖值会保留为本地成员。
复制/克隆 Bus成员保持 UID。若出现重复 ID,系统会自动添加 _N 后缀。副本会从复制的发布者读取数据。
子图支持Bus 在其自身图及每个封闭图中可见,子图可以直接读取外部 Bus 的数据。

技术优势:零后端足迹

comfyui-bus 的核心优势在于其纯前端实现。当工作流发送到后端执行时,Bus 节点会被解析为普通的链接关系。这意味着:

  • 兼容性完美:生成的 JSON 提示与手动连线的工作流无异。
  • 缓存有效:不影响 ComfyUI 的原生缓存机制。
  • API 导出稳定:通过 API 调用的行为与界面操作完全一致。

已知限制

  • 未喂入的成员在排队时会为每个已连线的消费者报告警告,即使该分支并未实际运行。
  • 当成员直接连接到子图的输入或输出节点时,系统会拒绝重新排序成员以防止逻辑混乱。
  • 目前主要针对经典画布渲染器构建,Vue 节点模式下的兼容性尚未经过充分测试。

comfyui-bus 是管理大规模、模块化 ComfyUI 工作流的利器,它让数据流变得清晰、可控且易于维护,是每一位资深 ComfyUI 用户值得拥有的效率工具。

© 版权声明

相关文章