ComfyUI-FlowLinks 是一款纯前端的 ComfyUI 扩展插件,旨在将静态的工作流画布转化为充满活力的动态视觉体验。它通过接管底层的连线渲染层,实现了“水管流水”式的动态连线效果,并根据节点类型自动分配荧光边框颜色。用户不仅能看到数据在节点间流动的轨迹,还能通过流速和颜色的变化直观感知生成进度与状态。该插件零依赖、无需 Python 环境,安装即用,且完全不影响工作流的逻辑与生成结果。
- GitHub:https://github.com/Daroumm/ComfyUI-FlowLinks

核心功能亮点
1. 🌊 动态水管流水连线
- 视觉拟真:连线被渲染为半透明的管壁,内部有亮色水段、白色高光虚线以及随水流移动的小气泡,极具科技感。
- 流速跟随执行:连线的流动速度实时跟踪前端的生成速度(steps/s)。生成越快,水段越长、越亮;生成结束后,连线逐渐停止流动,模拟“数据已送达”的状态。
- 状态感知反馈:
- 活跃中:连线快速流动,带有呼吸感。
- 空闲时:连线以极低速度缓慢漂移,保持画面生动。
- 出错时:连接到错误节点的连线会闪烁红色,帮助用户快速定位问题。
2. 🎨 按类型配色的节点荧光
- 智能配色:根据节点类型名称进行哈希计算,并按黄金角散布算法分配专属颜色。同类节点拥有相同的荧光色,不同类型互不撞色,使工作流结构一目了然。
- 动态特效:
- 执行脉冲:正在运行的节点周围会出现呼吸式的脉冲光效。
- 标题渐变:节点标题栏背景呈现同色系渐变,增强视觉层次感。
3. ⚙️ 高度可定制的设置面板
点击画布右下角的「流水」按钮即可打开设置面板,支持 9 项精细调节,配置自动保存至 localStorage:
- 流水控制:启用/禁用、流速倍率(0.2–3.0x)、管径粗细(2–14)、辉光开关、气泡开关、空闲流速。
- 节点特效:节点荧光开关、执行脉冲开关、标题渐变开关。
- 多语言支持:面板语言自动跟随 ComfyUI 界面语言(English / 简体中文)。

技术原理与兼容性
- 纯前端实现:基于 JavaScript 编写,不依赖任何 Python 节点或模型,无需
pip install。它通过包裹LitegraphLinkAdapter.renderLinkDirect和替换CanvasPathRenderer.drawFlowAnimation来实现渲染接管。 - 广泛兼容:适用于所有官方节点及第三方自定义节点包(如 GGUF 加载器、姿势工具等)。唯一例外是 Set/Get 无线连接(无可见连线)和被禁用的连线。
- 性能优化:动画由
requestAnimationFrame驱动(约 30 fps),标签页隐藏时自动暂停以节省资源。即使在开启全效特效的情况下,画布仍能保持流畅运行。对于超大工作流(100+ 节点),建议关闭辉光或节点荧光以避免掉帧。 - 系统要求:ComfyUI 前端版本 ≥ 1.55(已在 1.55.18 / ComfyUI 0.45.x 上实测)。支持 macOS、Windows、Linux。
安装指南
方法一:ComfyUI Manager(推荐)
- 打开 ComfyUI Manager。
- 搜索 FlowLinks。
- 点击 Install。
- 重启 ComfyUI。
方法二:手动安装
cd ComfyUI/custom_nodes
git clone https://github.com/Daroumm/ComfyUI-FlowLinks.git
重启 ComfyUI 即可生效。
方法三:Release 压缩包
从 GitHub Releases 页面下载 ComfyUI-FlowLinks-v0.1.0-beta.1.zip,解压至 ComfyUI/custom_nodes/ 目录下,重启 ComfyUI。
常见问题解答
- Q: 它会修改我的工作流或生成结果吗?
- A: 不会。FlowLinks 仅改变连线和节点边框的视觉渲染方式,绝不触碰图数据、提示词或生成的图片文件。
- Q: 它会拖慢生成速度吗?
- A: 不会。渲染过程完全在浏览器前端进行,与后端生成逻辑隔离。测试显示全效开启时画布仍保持约 60 fps 的流畅度。
- Q: 为什么有些连线不流动?
- A: 被禁用的连线会被特意跳过动画;Set/Get 节点之间的无线连接由于没有可见的物理连线,因此无法展示流水效果。
ComfyUI-FlowLinks 不仅是一个美化插件,更是一个直观的调试辅助工具。通过可视化的数据流动和状态反馈,它能帮助开发者更清晰地理解工作流的执行逻辑,让复杂的节点网络变得生动而易于掌控。
© 版权声明
文章版权归作者所有,未经允许请勿转载。















