ComfyUI-zip-ties:前端美化扩展,用扎带把连接线束成丝带,整理复杂工作流

插件23小时前发布 小马良
8 0

ComfyUI-zip-ties 是纯前端画布扩展,不增加任何节点、无Python依赖,作用是给节点之间的连线加上“扎带”,把多条线捆成一束丝带,用来梳理密密麻麻的复杂工作流,可读性大幅提升。

  • GitHub:https://github.com/safzanpirani/comfyui-zip-ties
ComfyUI-zip-ties:前端美化扩展,用扎带把连接线束成丝带,整理复杂工作流

核心操作

功能操作方式
捆绑连线按住Z,在线上拖画;也可以右键空白画布 → Tie wires 再拖拽
移动扎带直接拖动扎带
多选扎带Ctrl/Cmd 点选、Shift追加、框选(可同时选中节点+扎带)
删除扎带选中按Delete;按住Z在扎带上拖过;双击扎带
旋转扎带Shift拖动,默认15°磁吸;加Alt自由旋转
单扎带设置右键修改颜色、90°/45°快速旋转、移除
  • 快捷键可自定义:绑定按键支持换成 X/C/G/T/Y,不会和原有ComfyUI快捷键冲突
  • 颜色:默认随机色;全局设置可以改成「匹配线缆主色」或者统一灰色;单根扎带可单独改色
  • 一条连线可以穿过多个扎带;旋转扎带可以改变线束走向,轻松做出直角弯折效果
  • 支持重路由节点之间的连线段捆绑;扎带会跟随节点、重路由、分组一起移动

存储与联动特性

  • 扎带数据保存在工作流 extra.zipTies 字段里,保存、加载、撤销、复制粘贴节点时同步携带扎带
  • 复制节点时,连带对应的线束扎带一起复制粘贴;删除连线后,没有线的空扎带自动消失
  • 连线被隐藏(Hide Link)时,对应的扎带自动隐藏,连线恢复显示后扎带重新出现
  • 没装这个插件的ComfyUI打开工作流,只会正常显示连线,不会报错

安装方式

  1. ComfyUI Manager 搜索 Zip Ties 一键安装
  2. Comfy CLI:
comfy node install comfyui-zip-ties
  1. 手动克隆:
cd ComfyUI/custom_nodes
git clone https://github.com/safzanpirani/comfyui-zip-ties

重启ComfyUI即可生效。

实现原理

只有一个前端JS文件 web/zip_ties.js,通过Hook Litegraph原生渲染、序列化、选择、删除相关方法实现:

  • 劫持 renderLink,将线束偏移绘制,形成捆扎效果,复用原生连线样式、高亮逻辑
  • 接管序列化/反序列化,让扎带融入工作流json
  • 捕获鼠标事件,优先识别扎带拖拽手势

已知限制

  • 链接徽章生成的重路由段无法捆绑
  • 丝带形状针对贝塞尔曲线连线优化;直线模式下碰撞检测按直线处理
  • 测试版本:ComfyUI 0.42.0、前端1.57.1,经典画布、Vue节点模式都兼容
© 版权声明

相关文章