ComfyUI-NodeAligner is a lightweight ComfyUI layout plugin that includes features such as node alignment, distribution, and resizing. This plugin is designed to simplify layout adjustments in visual node editors or custom UI components, making node arrangement more convenient and efficient.

功能 Features

节点左对齐、右对齐、顶部对齐、底部对齐
Align nodes to left, right, top, bottom.
水平和垂直居中对齐
Center nodes horizontally and vertically.
使选中的节点等宽等高
Equalize the width and height of selected nodes.
水平或垂直均匀分布节点
Distribute nodes evenly across horizontal or vertical space.

使用方法 Method of Application

选中节点后使用工具栏进行对齐、分布或统一尺寸。单个节点对齐时保持当前位置。 Select nodes and use the toolbar to align, distribute, or equalize their sizes. Aligning a single node preserves its position.
按住 Shift 键或 Ctrl 键，点选多个节点，点击按钮，即可完成对齐和分布。
Hold the Shift or Ctrl key, select multiple nodes, and click the button to complete alignment and distribution.
点击空白处取消选择。
Click on the blank space to deselect.
未选中节点时，点击左对齐会恢复预设起始视图和 100% 缩放。 With no nodes selected, left alignment restores the preset starting view at 100% zoom.
点中对齐按钮中间的黑色分割线可实现组件的拖拽，进行移动。 The black division line in the center of the right alignment button allows for component dragging and movement.
右键点击本功能栏可选择模式，可选驻留或选中节点后显示。（选择点击>=2个时在鼠标旁显示此功能栏） Right-click on this toolbar to choose the mode, with options for either pinning it or showing it after selecting nodes. (When selecting two or more nodes, this toolbar will appear next to the mouse.)

ps: 按住 Shift 进行拖拽可以对多个选择节点同时进行拖拽。 ps: Hold Shift to drag and move multiple selected nodes.

视频演示：https://space.bilibili.com/15855661?spm_id_from=333.337.search-card.all.click

安装 Installation

克隆仓库：
Clone the repository:

git clone https://github.com/Tenney95/ComfyUI-NodeAligner.git

将 ComfyUI-NodeAligner 文件夹复制到 ComfyUI/custom_nodes 目录下。

1.0.4 修复对齐时整列偏移 Fix unintended track movement

修复矮节点行内错位超过节点高度时的行列识别，覆盖实际 270×58 节点、行内错位 78 的六节点排列。
对齐保留原行列基准，移除把重叠行列自动推开的行为。需要调整间距时使用分布按钮。
保留已对齐的共同边线，修复不同宽度节点重复右对齐时合并相邻列的问题。
在用户当前工作流的真实节点上验证先左后上、先上后左、重复点击和撤销；缩放与视图偏移保持不变。35 项回归检查通过。

Preserves track reference positions during alignment, recognizes offset rows of short nodes, and keeps repeated alignment stable. Spacing changes remain part of distribution.

1.0.3 网格匹配与对齐基准 Grid matching and reference nodes

修复同一网格中偏移较大的节点被当作独立行/列，导致左对齐后再上对齐仍不整齐的问题。
通过跨行/列的有序匹配找回对应单元，允许缺格，不将不完整的行直接压缩到左侧。
在识别出的网格内，左对齐以每列最上方节点的左边为基准，上对齐以每行最左方节点的上边为基准。
当时的六节点验证使用了 Note 节点，未覆盖用户实际节点的高度与错位比例；相关缺口在 1.0.4 中修复。

Matches cells across rows and columns, including missing cells. Grid left alignment follows the top node of each column; grid top alignment follows the left node of each row.

1.0.2 行列布局修复 Grid layout fixes

修复选中 4 个及以上节点时，偏移节点被自动拆组、未参与对齐的问题。
左右和水平居中按列整理，上下和垂直居中按行整理；水平分布按行，垂直分布按列。
支持不同尺寸、轻微错位及缺格网格；结果不依赖选中顺序，重复点击保持稳定。
每行/列独立计算间距，分布只改变对应方向。空间不足时从首个节点向后展开，至少留 20 个画布单位。1.0.4 起，对齐按钮保留原行列基准，不自动调整行列间距。
布局使用实际渲染尺寸，兼容 Nodes 2.0 的控件最小尺寸；保留旧前端的尺寸接口。

Aligns within established rows/columns, distributes each track independently, uses rendered node dimensions, and fixes offset nodes being omitted from selections of four or more.

只有一条成形的行/列时，会把孤立的偏移节点一起整理。稀疏布局若希望保留独立行列，可以按行/列分批选择。

2026-11-05 验证：32 项回归检查通过，涵盖 4/8 节点、2×3/3×3 网格、缺中心格、异尺寸、重叠、选择顺序和重复点击；另对固定样本进行 20,000 次稀疏网格动作检查，未发现选择顺序差异或重复点击漂移。

本机前端 1.57.6 已实测四节点错位对齐及撤销、传统节点的多行多列整理、Nodes 2.0 的实际边界对齐及重复点击稳定性。

1.0.1 兼容更新 Compatibility update

接入 ComfyUI 扩展生命周期，优先使用 selectedItems，保留旧前端选区兼容。
对齐、分布和尺寸修改接入撤销/重做；调整尺寸调用节点的 setSize，同步控件布局。
修复重复拖动监听、普通点击覆盖驻留位置、临时浮栏定位和监听清理。
保留原有分组、分布和尺寸取整规则，按钮增加中文提示。

Uses ComfyUI extension setup and modern selection APIs, records undoable edits, updates widget layouts through setSize, and fixes toolbar dragging and positioning while preserving existing layout rules.

2026-11-05 验证：本机前端 1.57.6 的传统节点和 Nodes 2.0 均已实测多选浮栏、顶部对齐、等宽及单次撤销；另已核对官方 1.60.0 的相关接口，尚未在该版本完整环境实测。

验证命令（仅需 Node.js，无额外依赖）：

node --check node_info.js
node tests/node_info.test.cjs

更新后先保存工作流，再刷新 ComfyUI 页面。

README.md Unescape Escape

ComfyUI-NodeAligner