Qwen2.1 Align：ComfyUI 对齐节点，SIFT+RANSAC 校正图像编辑带来的偏移拉伸，不用 GPU 推理

Qwen2.1 Align 是一款专为 ComfyUI 设计的独立自定义节点，解决图像编辑过程中（尤其是 Qwen 图像编辑模型）产生的小幅偏移、拉伸或形变问题。该节点能够将编辑后的图像精准对齐回原始图像的坐标系中，且在保留足够原始细节的前提下，同样适用于其他图像编辑工具的输出校正。

• GitHub：https://github.com/CoreyCorza/Qwen2.1-Align

核心技术原理：轻量且高效的特征匹配

与依赖庞大神经网络或复杂掩码生成的传统对齐方案不同，Qwen2.1 Align 采用了经典的计算机视觉算法：

• SIFT 特征匹配与 RANSAC：节点利用 OpenCV 的 SIFT（尺度不变特征变换）算法提取图像特征点，并结合 RANSAC（随机采样一致性）算法来估计一个全局仿射变换矩阵。
• 全维度校正：该矩阵能够有效校正平移、旋转、独立的宽度/高度缩放以及剪切形变。
• 零额外负担：整个匹配与计算过程均在 CPU 上运行，无需下载额外的模型权重，不消耗 GPU 显存，也无需用户提供复杂的编辑掩码。

工作流集成与参数控制

在 ComfyUI 工作流中，该节点的使用极为直观：

• 输入与输出：将编辑前的图像连接至 original_image，编辑器的输出连接至 edited_image。节点将输出对齐后的 aligned_image（可直接连接至预览或保存节点）以及一份 report（描述匹配质量和应用的校正参数）。
• 边缘填充策略 (edge_fill)：由于仿射变换可能会暴露出图像边界，节点提供了两种填充模式：
  • Original image（默认）：使用原始图像的像素进行填充，并以 4 像素的羽化效果平滑过渡到对齐的编辑区域。需注意，若编辑本身有意改变了边缘内容，此模式可能会重新引入原始图像的细节。
  • Reflect：在边界处镜像反射编辑后的像素，适用于不希望引入任何原始图像内容的场景。
• 批次与格式处理：支持单张原始图像对齐一批编辑图像（批次大小不匹配时则要求严格对应）。输出始终为原始图像分辨率下的 RGB 格式，RGBA 输入的 Alpha 通道会被自动移除。计算过程保留编辑张量的设备与数据类型（dtype）。

安装与部署指南

该节点要求 ComfyUI 环境支持 comfy_api.latest 及现有的 PyTorch 安装。

1. 克隆仓库：在 ComfyUI/custom_nodes 目录下打开终端，执行：

   git clone https://github.com/CoreyCorza/Qwen2.1-Align.git
   

2. 安装依赖：
   • 标准环境：python -m pip install -r Qwen2.1-Align/requirements.txt
   • Windows 便携版：需在便携版根目录（包含 python_embeded 的文件夹）下执行：

   .\python_embeded\python.exe -m pip install -r .\ComfyUI\custom_nodes\Qwen2.1-Align\requirements.txt
   

3. 重启生效：重启 ComfyUI 后，即可在节点菜单的 Qwen2.1/image 分类下找到 “Qwen2.1 Align”。

使用限制与注意事项

为确保最佳效果，用户需了解该节点的适用边界：

• 仅限全局变换：专为微小的全局形变设计，不适用于局部变形（如液化）或重大的透视变化。
• 依赖图像纹理：匹配过程需要图像中分布有足够多且可识别的细节特征。对于大量编辑、重复纹理或低细节（如纯色背景）的图像，可能无法实现可靠对齐。
• 非掩码合成工具：该节点仅负责几何对齐，不检测或合成编辑掩码。仅当选择 “Original image” 填充模式时，暴露的边界才会使用原始图像像素。
• 容错机制：当算法检查并拒绝不可靠的变换估计时，节点将直接返回调整至原始分辨率的编辑图像，并在 report 中详细说明原因。接受的匹配仅为数学估计，并非绝对完美的视觉对齐保证。