22 KiB
EasyKit-NodeAlign-Pro [↙切换中文] 🎨
📋 项目简介
EasyKit-NodeAlign-Pro 由设计师独立开发(原名称：ComfyUI_EasyKitHT_NodeAlign Pro)：
用于管理 ComfyUI 中节点布局和配色方案的必备插件，具备专业的对齐功能和实时节点取色器 已适配ComfyUI Node2.0 。
原创基于节点的实时预览调色/取色组件，方便快速节点取色/上色。该插件旨在提升ComfyUI用户的工作效率，通过直观的界面和丰富的功能简化节点布局与颜色管理流程。
v2.1.14版首发支持-最新版ComfyUI Node2.0节点。首创基于 Node2.0 的对齐算法（创新性适配）:
功能能涵盖对齐分布、实时节点取色器、调色盘、7 种预设颜色、灰度/自定义模式以及一键反向对齐等功能，提供全新对齐工具和专业的节点色彩管理系统。内置对齐工具的布局更符合设业通用的操作逻辑和体验，多种上色模式的上色工具更合理。（原生支持多语言UI界面显示）
🔥 新版v2.1更新说明 (适配Node2.0)
新版v2.0全新适配i18n多语言配置文件，原生支持中文、English等语言（后续视情况还可扩展支持更多诸如俄语、法语等语言），对世界各地的国际友人更友好。
✅【h260201更新】：新增自动主题色(自动跟随ComfyUI主题色)👇
✅【h260125更新】：新增ComfyUI菜单、新增i18n多语言适配 (现以集成到官方菜单页面)👇
⚠️旧版v1.0.4_rc UI界面...
旧版v1.0.4_rc： 只提供基础的节点对齐工具和固定的上色工具：
如果觉得还可以，欢迎帮忙点颗星**⭐Star**~
📺️ 视频教程
v1旧版教程：https://www.bilibili.com/video/BV1V7G9z9EcU- v2新版教程(适配Node2.0)：https://www.bilibili.com/video/BV1zeFZzLEvP
✨ 核心功能
| 💫Node2.0节点对齐系统 | 💫全新上色系统 | 💫人性化交互设计 | 💫全新取色器(原创设计) |
|---|---|---|---|
| 🔥 新版Node2.0节点算法 | 🖼️ 一键式颜色管理方案 | 🖱️ 悬浮式工具面板 | ✅ 原创实时预览调色/取色组件 |
| 🔥 原创Alt反向基准对齐算法 | 🔗 实时联动全屏取色器 | ⚙️ ComfyUI系统菜单集成 | 🎨 色卡模式: 彩色/灰度/自定义 |
| 📊 两套独立对齐分布算法 | 🎨 整体上色/仅标题上色模式 | 🔥 ComfyUI主题自适应(9+1+1) | 🧩 色卡：随机/收藏/移除/手动 |
| 🧩 多种对齐分布模式 | 🧩 自定义色卡收藏与恢复系统 | 🌐 原生i18n多语言UI适配 | 🎨 预置色：色值特调优化 |
🎯 高级特性
- i18n多语言：原生适配i18n多语言系统
- 支持Node2.0节点：全新支持ComfyUI Node2.0节点 【v2.1.13+新增】
- ComfyUI系统菜单集成：可在ComfyUI系统菜单里进行相关设置(含高级设置项) 【v2.0.3_rc新增】
- 自定义拖动及缩放：可自由拖拽和缩放的操作面板
- AcBar联动模式：与ComfyUI运行按钮联动拖移定位
- 右键菜单：丰富的设置选项和快捷操作
- 节点批量选择：多种选择工具和魔棒功能 （开发调试中...）
- 节点批量重命名：批量重命名节点功能 （开发调试中...）
🎨 颜色管理模块
- 两种上色模式：仅节点标题上色 / 节点整体上色【v2.0.3_rc新增】
- 七组预设颜色：快速应用标准颜色到选中节点
- 灰度色板：按住Shift键切换至灰度颜色模式【v2.0.1_rc新增】
- 自定义色板：按住Alt键进入自定义颜色模式【v2.0.1_rc新增】
- 颜色收藏：Ctrl+Alt组合锁定/解锁自定义颜色【v2.0.1_rc新增】
- 随机颜色：点击随机颜色按钮即可随机一种颜色【v2.0.1_rc新增】
- 超级随机色：按Alt键 + 随机颜色按钮可一次性随机7种颜色，并对选中节点实时随机上色【v2.0.1_rc新增】
- 实时取色器：内置全屏实时取色器【v2.0.1_rc新增】（0依赖，纯原生js+css开发设计）
- 节点调色实时预览组件：原创基于节点的实时预览调色/取色组件【v2.0.1_rc新增】（0依赖，纯原生js+css开发设计）
🔧 节点对齐模块
- 基础对齐：左对齐、右对齐、顶部对齐、底部对齐
- 居中分布：垂直居中和水平居中
- 等距分布：水平等距分布和垂直等距分布
- 尺寸统一：等宽和等高调整
- 反基准模式：按Alt键 + 点击对应对齐按钮可实现反向基准对齐【v2.0.1_rc新增】
🚀 插件安装
方法一：ComfyUI Manager管理器（推荐）
-
在 ComfyUI Manager 管理器搜索 "node2.0"（是的，就这么简单，目前是唯一一个）
👉 如果搜 "node2.0" 没有搜到：说明你的ComfyUI和Manager管理器没有更新到最新版本，请先更新ComfyUI和Manager管理器到最新版本;
👉 如不想更新ComfyUI和Manager：请直接在旧版上搜索 "Easykit" 或 "NodeAlign Pro" 即可搜到。
-
找到
EasyKit-NodeAlign-Pro，点击安装(此方式为ComfyUI注册版插件：会自动生成ComfyUI官方标准生态的easykit-node-align目录)
-
等待提示重启ComfyUI 即可使用
方法二：Git克隆（推荐）
- 打开ComfyUI/custom_nodes目录，执行如下命令
(此方式为git版插件：会自动生成ComfyUI_EasyKitHT_NodeAlignPro目录)：
git clone https://github.com/ArtsticH/ComfyUI_EasyKitHT_NodeAlignPro.git
- 中国用户及无法访问github的用户请使用gitee镜像源：
git clone https://gitee.com/ArtsticH/ComfyUI_EasyKitHT_NodeAlignPro.git
- 重启ComfyUI 即可使用
方法三：comfy install安装
(此方式为ComfyUI注册版插件：会自动生成ComfyUI官方标准生态的easykit-node-align目录)
comfy node install easykit-node-align
方法四：Git手动安装
- 打开本项目地址：https://github.com/ArtsticH/ComfyUI_EasyKitHT_NodeAlignPro
- 下载插件压缩包（
<>Code>Download ZIP） - 解压到
ComfyUI/custom_nodes目录 （注意正确目录层级应为：ComfyUI/custom_nodes/ComfyUI_EasyKitHT_NodeAlignPro） - 重启ComfyUI 即可使用
🚀 插件更新
方法一：ComfyUI Manager管理器更新（推荐）
- 在 ComfyUI Manager 管理器搜索 "node2.0"（是的，就这么简单，目前是唯一一个）
- 找到
EasyKit-NodeAlign-Pro，点击安装(此方式为ComfyUI注册版插件：会自动生成ComfyUI官方标准生态的easykit-node-align目录)
- 等待提示重启ComfyUI 即可使用
方法一：Git更新（需先手动导航至ComfyUI_EasyKitHT_NodeAlignPro目录内）
git fetch --all && git reset --hard origin/main
🚀 快速开始（简要指南）
成功安装NodeAlignPro之后，基础操作(仅供参考)
- 节点上色：进入ComfyUI选中任一节点 > 点击NodeAlignPr面板（以下简称NAP面板）内任意颜色按钮即可（🔴🟠🟡🟢🔵🟣🟤,
清除颜色取色器随机颜色）； - 自定义颜色：选中任一节点 > 点击NAP面板内取色器按钮即可；
- 节点对齐： 选中任一节点 > 点击NAP面板内任意对齐按钮即可；
- 反向对齐：选中任一节点 > 按Alt键 + 点击对应对齐按钮可实现反向基准对齐；
└例：
左对齐→选中多个节点 > 按Alt键+左对齐按钮，则以最右侧节点为基准进行左对齐（默认左对齐是以最左侧节点为基准进行左对齐）； - 拖动NAP面板：无需选中任何节点 > 点击NAP面板左右两侧的按钮，出现四向箭头光标（↕↔）即可拖动
- 重置设置：无需选中任何节点 > 在NAP面板内 >【鼠标右键】 >【一键重置】 即可；
- 进阶技巧：请参阅下面使用指南👇。
🖥️ 《使用指南》...
基本操作
- 启动插件：ComfyUI启动后，插件自动加载
- 显示/隐藏：通过右键菜单或快捷键控制显示
- 拖拽移动：拖动标题栏或分隔线移动面板
- 缩放调整：通过右键菜单调整UI缩放比例
颜色模式切换
| 按键组合 | 模式说明 | 功能描述 |
|---|---|---|
| 无按键 | 默认模式 | 七种预设颜色 |
| Shift | 灰度模式 | 黑白灰系列颜色 |
| Alt | 自定义模式 | 自定义颜色管理 |
| Ctrl+Alt | 锁定模式 | 锁定/解锁自定义颜色 |
对齐操作
- 在ComfyUI画布上选择2个或更多节点
- 点击对齐面板上的相应按钮：
- 左对齐：所有节点向左对齐
- 垂直居中：所有节点垂直居中
- 右对齐：所有节点向右对齐
- 顶部对齐：所有节点向顶部对齐
- 水平居中：所有节点水平居中
- 底部对齐：所有节点向底部对齐
高级技巧
- Alt+对齐按钮：使用"反向基准"进行对齐
- 双击取色器预览：切换节点整体/仅标题上色模式
- 右键菜单：访问完整设置和重置功能
- 容器联动：将操作面板与运行按钮联动定位
🐛 常见问题
Q: 如何开启/关闭【自动】主题色？
→A: 直接点击ComfyUI左下角菜单> 🔥 NodeAlignPro> 🎨NodeAlignPro颜色预设(Color preset)> 使用ComfyUI主题配色(Use ComfyUI theme color)> 【开启/关闭】；
Q: 如何【自定义】主题色？
→A: ...> 🔥 NodeAlignPro> 🎨NodeAlignPro颜色预设(Color preset)> 使用ComfyUI主题配色(Use ComfyUI theme color)> 【开启】；
Q: 如何切换语言？
→A: ...> 🔥 NodeAlignPro> NodeAlignPro基本设置(Basic Settings)> NodeAlignPro UI语言(Language)；
Q: 如何在新版Node2.0模式下使用对齐/分布/上色功能？
→A-方式1: 插件工具栏上右键> 工作模式(Work Mode)> Node2.0
→A-方式2: ...> 🔥 NodeAlignPro> NodeAlignPro基本设置(Basic Settings)> 工作模式 (Work Mode)> Node2.0；
Q: 我的插件开启了Node2.0模式，但点击对齐按钮后存在明显延迟？
→A-方式1: 您当前使用的是传统Canvas节点。若需保持当前传统Canvas节点的使用环境，请切换插件的工作模式为传统模式：工作模式(Work Mode)> 传统对齐(AlignStd)
→A-方式2: 您当前使用的是传统Canvas节点。若就是需要使用新版Node2.0模式，请手动开启ComfyUI的新版Node2.开关（详见下图）
Q: 颜色无法应用到节点？→A: 确保已选中节点，检查节点是否处于锁定状态，尝试刷新页面；
Q: 对齐功能无效？→A: 确保选中2个或更多节点，检查节点选择状态，尝试清除选择后重新选择；
Q: 如何重置所有设置？
→A: 右键菜单 → "一键重置"，或ComfyUI左下角菜单> 🔥 NodeAlignPro> Z开发人员选项(Developer Options)> ⚠强制重置NodeAlignPro插件；
Q: 插件不显示怎么办？
→A: 直接点击ComfyUI左下角菜单> 🔥 NodeAlignPro> Z开发人员选项(Developer Options)> ⚠强制重置NodeAlignPro插件。
↑若【强制重置】后仍未生效，请使用ComfyUI Manager检查插件是否正确安装，若未安装请搜索"NodeAlign Pro"重新安装，若安装请尝试FIX修复或尝试更新Update。
🔄 更新日志
v2.1.17 (最新版本) -260209更新
📄 历史版本...
v2.1.14 【🔥2.1正式版发布(完美适配Node2.0)】 -260201更新
- 重大更新： 新增自动主题色(自动跟随ComfyUI主题色) #5
- 全量新增基于ComfyUI Node2.0的对齐算法,同时保留并兼容原有的传统Canvas对齐模式
- 新增基于Node2.0的对齐模式(可在右键菜单或ComfyUI菜单更改工作模式为"Node2.0"进行使用) #8
- 重构ComfyUI菜单
- 优化右键菜单逻辑
- 优化i18n多语言适配 🗩7
- 修复若干个可能存在非致命性错误的语法问题
- 修复若干bug
- 修订并完善Readme文档
v2.1.12 (2025-01-25)
- 优化ComfyUI菜单
- 优化i18n多语言适配 🗩7
- 优化基于Node2.0的对齐算法(少量测试性重构)
- 修订并完善Readme文档
- 修复若干bug
v2.1.0 【🔥2.1预览版发布】
v2.0.3_rc (2025-12-30)
v2.0.2_rc (2025-12-22)
- 完善新版(v2.0.3_rc)界面提示
- 修复了一些bug
- 重新编些md教程文档(中英双语)
v2.0.1_rc (2025-12-22)【🔥2.0版发布】
- 新增Shift/Alt/Ctrl组合键模式
- 改进取色器性能和稳定性
- 添加节点预览功能
- 优化UI交互体验
v1.0.4_rc (2025-08-14)
v1.0.3_rc (2025-05-01)
v1.0.2_rc (2025-04-30)
v1.0.1_rc (2025-04-29)【🔥1.0版发布】
- 初始版本发布
- 完整的对齐和颜色功能
- 可拖拽容器系统
- 取色器工具集成
📄 历史更新日志...
v2.0.2_rc 8a12160: 🔥NodeAlignPro版本大更新,优化文件结构(全新UI, 更全的节点上色系统)→详见readme文档
----------------
v2.0.1_rc dd2a09f: 🔥NodeAlignPro版本大更新已发布（全新UI, 更全的节点上色系统）
d90bd02: 🔥Update Preview (A Major Update for the Upcoming Version 😁)→See README for details.🔥重大更新预告(近期版本将会大更新😁)→详见readme文档
----------------
v1.0.4_rc b77a9d7: FIX README, ht历史记录优化
----------------
v1.0.3_rc a62e3a6: Fix the ui scaling adaptation issue, The interlocking control function has been newly added.
d067502: remove res, add hPic, FIX README,FIX README_ZH.md
----------------
v1.0.2_rc b11f325: upload README
cb93ffa-461032d: README修改
4e60dc2: Fixed REEADME, Rename some img, Add README_ZH.md
fac4c81: UPLoad README , Create README_ZH.md
9f1839e: README修改-新增UI缩放适配
ef5735d: 新增UI缩放，修复旧版颜色移除不生效情况
8ac01db: 新增主要功能：对齐分布、节点上色。修改Readme图片显示异常
----------------
v1.0.1_rc 2926b82: README修改
10749c7: ComfyUI_EasyKitHT_NodeAlignPro是一个针对全新开发设计的ComfyUI节点对齐插件、节点上色插件。
全新视觉UI，相对更符合广大设计师朋友们的一贯操作逻辑。皆为大家提供一个相对美观的使用体验。
新增主要功能：对齐分布、节点上色。
----------------
ca28236: Initial commit
----------------
/**
* @Artstich_Example
* @name easykit-node-align (ComfyUI Plugin)
* @description Node2.0-based professional alignment & real-time node color picker - innovative first support: A must-have plugin for managing node layout and color schemes in ComfyUI. Features a real-time color picker, alignment, 7 preset colors, grayscale/custom modes, and one-click reverse alignment.
* @author ArtsticH
* @see https://registry.comfy.org/nodes/easykit-node-align
* @see https://github.com/ArtsticH/ComfyUI_EasyKitHT_NodeAlignPro
* @see https://gitee.com/ArtsticH/ComfyUI_EasyKitHT_NodeAlignPro
* @installCommand comfy node install easykit-node-align
* @installCommand git clone https://github.com/ArtsticH/ComfyUI_EasyKitHT_NodeAlignPro.git
* @installCommand git clone https://gitee.com/ArtsticH/ComfyUI_EasyKitHT_NodeAlignPro.git
* @created 2025-04-29 @date 2025-06-15 @lastUpdated 2026-01-28 @version v2.1.14 @license GPL-3.0
* @copyright ©2012-2026, All rights reserved. Freely open to use, modify, and distribute in accordance with the GPL-3.0 license.
*/
🤝 贡献指南
- 欢迎通过以下方式参与改进：
🥰提交使用反馈、👾New Issue、💬Discussions、📚️WiKi、
以及Fork & PR、完善多语言文档、分享你的创意节点布局、分享你的自定义色卡……
👥 贡献者
- 开发: 👤@ArtsticH
- 致谢: 👤@kakachiex2(👾issues-page)、👤@aimposer(👾issues-page)、👤@Rock-suv(👾issues-page)、👤@JGDMGJAPT 、👤@MAOMAOCHONGNE、👤@BlissiraHQ...
- 感谢上述及所有提供帮助的设计师、开发者、测试者、ComfyUI用户和反馈者
🌐 相关链接
- 🧩NodeAlign Pro 源1: 📥︎ Last Releases | 源2: 📥︎ Comfy registry | 源3: 📥︎ Gitee镜像
👾问题反馈 | ComfyUI社区 | ComfyUI-Manager
📜 许可证
- 本项目采用 GPL-3.0 许可证。详细信息请查看 LICENSE 文件。
💻 设计师业余开发的第一个小项目
⚠️ 可能存在未测试场景的异常，请通过Issues报告
（如果觉得还可以，欢迎帮忙点颗星Star⭐，谢谢）欢迎有兴趣的小伙伴们一起加入！
本文档更新于：2026年02月09日 00:43 @ArtsticH·2026