ComfyUI-NodeAlign：轻量级节点对齐工具栏，支持快捷键与自定义外观

在 ComfyUI 中构建复杂工作流时，节点排版混乱是许多用户的痛点：节点歪斜、大小不一、间距不均，不仅影响美观，还降低调试效率。

• GitHub：https://github.com/1038lab/ComfyUI-NodeAlign

ComfyUI-NodeAlign 正是为此而生——一款轻量、无干扰、高度可定制的节点对齐工具栏插件，帮助你快速整理工作流，让图表整洁如专业设计。

核心功能

• 节点对齐：支持水平/垂直六种对齐方式（左、中、右 / 顶、中、底）；
• 统一尺寸：一键将选中节点设为等宽、等高或两者同时；
• 智能分布：按自定义间距水平或垂直均匀分布节点，告别手动拖拽；
• 快捷键支持：使用 Shift + WASD 快速对齐（W=顶，A=左，S=底，D=右）；
• 浮动/附着模式：工具栏可自由拖放，或附着到菜单栏，不遮挡画布；
• 全外观自定义：调整按钮大小、背景色、透明度、图标颜色、分隔线等。

安装与配置

✅ 安装步骤

cd ComfyUI/extensions/
git clone https://github.com/yourusername/ComfyUI-NodeAlign.git

重启 ComfyUI 后生效。若未显示，请尝试硬刷新（禁用缓存），并检查控制台是否输出 [NodeAlign] init。

⚙️ 自定义设置（通过 ComfyUI 设置面板）

• 显示模式：Permanent（常显）、On-Select（选中节点时显示）、Disabled（隐藏）；
• 定位模式：Floating（自由浮动）、Attached（附着菜单栏）、Always（默认上方）；
• 视觉风格：支持设置背景色（如 #1C1C1C）、透明度（0–100）、图标色（如 #FFFFFF）等；
• 按钮大小：默认 25px，可调至 20px 实现更紧凑布局。

💡 推荐配置：深色背景 + 白色图标 + 绿色分隔线（如 #00FF55），清晰醒目又不喧宾夺主。

使用技巧

1. 批量整理：框选多个节点 → 点击“水平居中”+“等宽” → 瞬间对齐；
2. 快捷键高效操作：选中节点后，按 Shift + A 立即左对齐，无需移动鼠标；
3. 重置位置：双击工具栏可将其恢复到默认位置；
4. 浮动拖放：在 Floating 模式下，可将工具栏拖至画布边缘，释放主工作区空间。

兼容性与维护

• 已在 ComfyUI v3.7.3 前端 测试通过；
• 插件体积小、无外部依赖，不影响 ComfyUI 启动性能；
• 所有设置实时生效，无需重启。