Zip Ties:将连线捆绑成缎带的 ComfyUI 扩展

ComfyUI Wikinews

一款 ComfyUI 画布前端扩展,用小扎带把连线捆绑成缎带:按住 Z 拖拽即可捆绑,右键可改色或旋转,扎带会随工作流一起保存。

Zip Ties 是一款前端扩展,它把穿过某条直线的连线捆绑成一条缎带,由可以移动、旋转和改色的小扎带固定。它不添加任何节点,也没有 Python 依赖关系;整个扩展只有一个 JavaScript 文件。0.4.0 版本于 2026 年 10 月 26 日发布。

大型工作流在任何地方都有同样的视觉问题:一侧是加载器,另一侧是采样器,中间是密密麻麻的连线,每一条都画成独立的贝塞尔曲线,只能用眼睛一条条追踪。Zip Ties 并不会把它们隐藏起来,也不会让它们绕开障碍。它会收集穿过你所画直线的连线,并把每条连线固定到这条直线上,就像扎带捆住一束线缆那样。

该扩展基于 @cmzw_ 的原型 构建,在首次发布后的一天内就登上了 r/comfyui 和 r/StableDiffusion 的首页。

演示录像中的一帧

手势

操作手势
将连线捆绑在一起按住 Z 并拖出一条横穿连线的直线
不用键盘捆绑连线右键点击画布空白处,选择 Tie wires,然后横穿连线拖拽
移动扎带拖拽该扎带
选择多个扎带按住 Ctrl/Cmd 逐个点击扎带,按住 Shift 点击可追加一个,或与节点一起框选
旋转扎带按住 Shift 拖拽。它以 15 度为步进吸附;同时按住 Alt 可自由旋转
更改颜色、旋转 90 度或 45 度、移除右键点击该扎带
移除扎带按住 Z 拖过该扎带,或双击它

拖拽过程中,被直线穿过的连线会变成白色。如果直线穿过已有的扎带,直线和扎带都会变红,松开鼠标即移除该扎带。按键可在 Zip Ties → Key to hold while dragging across wires 中配置,其中只提供 ComfyUI 尚未单独占用的字母:X、C、G、T 或 Y。按住 Alt、Ctrl、Cmd 或 Shift 时,拖拽保持其通常含义,因此 Alt 拖拽仍然是克隆节点。

缎带的行为

每个新扎带会随机取一种扎带颜色。Zip Ties → Colour of new ties 可以把它切换为 Match wires,即选取该扎带内连线的常见颜色,或改为纯灰色;右键点击则只更改单个扎带。连线保留各自的颜色,在扎带之间并排穿行,悬停或拖拽某个扎带会高亮其中的每条连线。

一条连线可以穿过多个扎带,而旋转扎带会改变连线穿过它的方向,因此 0 度和 90 度的扎带可以形成直角转折。重新路由之间的线段也可以被捆绑:扎带只固定它所画过的那一段,而终止于某个重新路由的线段由所有经过该重新路由的连线共享。

扎带跟随其连线。移动扎带所连接的全部节点和重新路由时,扎带会随之移动;只移动其中一部分时,它留在原处,这与重新路由遵循的规则相同。位于组内的扎带会随组移动,而按住 Ctrl/Cmd 拖拽组边框时,它会和节点一起被留下。选中的扎带会随选中的节点一起移动,按 Delete 可在同一步撤销中同时删除两者。

扎带保存在工作流的 extra.zipTies 中,因此会随画面其余部分一起保存、加载和撤销。在未安装该扩展的情况下打开工作流,仍能正常加载并绘制连线,而格式错误的条目会在加载时被丢弃。复制粘贴节点时,如果某个扎带内的所有连线都属于这次复制,该扎带也会一并被带过去,同样处在同一步撤销中。

内部实现与局限

该扩展包装了画布上的几个 litegraph(旧版)方法:renderLink 记录每段连线的起止位置,并把被捆绑的线段重绘为从扎带中心向两侧偏移的股线;_renderAllLinkSegments 让被捆绑的连线在扎带位于屏幕内时保持绘制,即使两端都在屏幕外;drawConnections 会清理连线已消失的扎带,并移动那些应当跟随的扎带。线段绘制交回 ComfyUI 自带的连线渲染器,因此颜色、边框和高亮行为都得以保留。拖拽手势在 window 上的捕获阶段监听器中运行,因此能先于 litegraph 收到指针事件,所画的直线会与每条连线的贝塞尔曲线做相交测试。

项目列出了两个限制。通过连线徽标绘制的重新路由线段,也就是隐藏连线快捷方式,无法被捆绑。此外,缎带形状是为曲线连线调校的:直角线和线性连线模式仍会穿过扎带,但切割检测会把每段视为直线。它已在 ComfyUI 0.42.0(前端 1.57.1)上测试,涵盖经典画布和 Vue 节点模式。

获取方式

在 ComfyUI-Manager 中搜索“Zip Ties”,或使用 comfy node install comfyui-zip-ties,也可以把仓库克隆到 ComfyUI/custom_nodes 后重启来完成安装。发行版本与完整手势列表见 GitHub。

评论

使用 GitHub 登录后即可参与讨论。

评论加载中…
Zip Ties:将连线捆绑成缎带的 ComfyUI 扩展 | ComfyUI Wiki