ComfyUI-EasyColorCorrector 是由开发者 regiellis 打造的一款 专业级、AI驱动的颜色校正插件,专为 ComfyUI 用户打造。
该插件集成了先进的计算机视觉与颜色科学算法,帮助创作者在不依赖传统专业软件(如 Adobe 或 DaVinci)的情况下,实现高质量的图像与视频调色。

📎 安装方式(简略)
目前此节点尚未上架ComfyUI Manager,你需要手动安装才可以使用此节点:
cd ComfyUI/custom_nodes
git clone https://github.com/regiellis/ComfyUI-EasyColorCorrector.git
pip install -r requirements.txt
注意:部分依赖项(如 OpenCV、scikit-learn)可能需要额外安装或编译。
🔧 主要功能更新(v1.2.1)
重大重构与命名变更
- 插件从之前的名称正式更名为 ComfyUI-EasyColorCorrector
- 引入了全新的节点架构和更专业的功能
- 建议先卸载旧版本再安装新版
核心改进
| 功能 | 改进说明 |
|---|---|
| 手动模式 | 实现真正的温度+色调分离(LAB颜色空间),不再仅是色相滑块 |
| 预设模式 | 滑块实时更新,精确显示每个预设的作用 |
| 滑块范围优化 | 对比度/亮度等参数调整至合理范围,避免极端值 |
| 白平衡控制 | -1.0(冷/蓝)到 +1.0(暖/橙),符合专业调色标准 |
| 肤色处理 | 浅色皮肤不再出现绿色偏移,肖像更自然 |
| 智能 UI 设计 | 手动模式下 AI 分析自动禁用,提供纯粹手动控制体验 |
| 三路校正器 | 提升/伽马/增益现已正常工作 |
新增实验性节点(Beta)
| 节点 | 功能描述 |
|---|---|
| 批量颜色校正器 | 可对整个视频序列应用相同的 AI 驱动校正 |
| RAW 图像处理器 | 支持直接处理 RAW 文件,采用专业色彩科学流程 |
| 颜色校正查看器 | 视频工作流中的实时预览与分析节点 |
🚀 插件定位
ComfyUI-EasyColorCorrector 的目标是:
弥合“AI 自动增强”与“专业调色师手动微调”之间的鸿沟
它不仅是一个简单的颜色调整节点,而是一个完整的 AI 驱动颜色分级套件,适用于:
- 快速增强艺术内容(动漫、概念艺术、插图)
- 电影级调色(青橙风格、复古胶片、漂白效果)
- 专业摄影后处理(人像、风景、低光场景)
- 视频调色(支持帧级一致性处理)
🤖 AI 驱动智能功能
- 面部检测:使用 OpenCV 进行高级肤色分割,保护人物肤色自然
- 场景识别:自动识别图像类型(动漫 / 概念艺术 / 肖像 / 真实照片)
- 光照检测:区分低光、明亮、平淡、最优光照条件
- 内容感知增强:针对不同类型内容应用专用增强策略
- 边缘感知处理:多尺度边缘检测,保留细节清晰度
- 高级分割技术:基于 SLIC 的超像素分割,提升肤色区域精度
🎨 专业颜色科学特性
- LAB 颜色空间:布拉德福德适应机制,确保白平衡感知均匀
- K均值聚类:提取 RGB 和 LAB 空间中的主要颜色
- 三路颜色校正器:提升(Lift)、伽马(Gamma)、增益(Gain)独立控制
- 感知曲线:基于 Gamma 的亮度与对比度调节,保留边缘信息
- 直方图匹配:稳健匹配参考图像颜色,防止伪影产生
- 调色板提取:亮度排序的主要颜色样本生成,便于后续使用
⚙️ 三种核心模式
1. 🤖 自动模式:AI魔法
适用于快速增强和批量处理,AI 将根据图像内容自动执行以下操作:
- 应用场景特定增强配置文件(6种类型)
- 智能白平衡(LAB空间)
- 面部肤色保护
- 自适应对比度与饱和度(最高提升50%)
- 光照条件自适应亮度调整
- 增强光晕效果(适合概念艺术)
适用场景:快速出图、概念艺术、动漫、肖像、批量处理
2. 🎨 预设模式:精选风格
提供 30个专业预设,覆盖多种风格类型:
类型分类:
- 肖像预设(5):自然、温暖、冷色、高调、戏剧性
- 概念艺术与插图(6):史诗奇幻、科幻镀铬、黑暗奇幻、鲜艳概念、哑光绘画、数字艺术
- 艺术与风格化(6):动漫明亮、动漫深沉、赛博朋克、柔和梦境、霓虹夜色、漫画书
- 电影化风格(5):电影化、青橙、黑色电影、复古胶片、漂白效果
- 自然风光(4):黄金时段、蓝色时段、晴天、阴天
- 经典风格(4):褐色、黑白、褪色、深沉
特点:
- 实时滑块更新,透明显示预设作用
- 内容感知适配,自动优化参数
- 智能随机化,保持原始艺术意图
适用场景:风格统一、客户项目、概念艺术工作流
3. 🎛️ 手动模式:专业控制
为专业用户设计的手动调色工具,提供完全控制权:
- 温度与色调分离控制(LAB空间)
- 三路校正器:Lift/Gamma/Gain 精确控制
- 白平衡:-1.0(冷/蓝)到 +1.0(暖/橙)
- 颗粒模拟:类似胶片质感,保留亮度信息
- 精细步长调节:增强滑块可进行亚像素级微调
适用场景:精准调色、电影后期、学习、复杂修复
📊 输出与分析功能
四种输出类型:
| 输出类型 | 说明 |
|---|---|
| 📸 处理后的图像 | 经过增强或校正后的最终图像 |
| 🎨 调色板数据 | 逗号分隔的十六进制颜色字符串,供其他节点使用 |
| 📊 直方图图像 | RGB 直方图可视化(512×768px) |
| 🎨 调色板图像 | 清晰的颜色样本图像(600×120px) |
直方图可视化特点:
- 多通道叠加显示红、绿、蓝分布
- 深色背景 + 微弱网格线,增强可读性
- 可连接 Preview Image 节点即时查看
颜色调色板提取:
- 使用 K 均值聚类提取 6 种主色
- 基于 LAB 空间的感知分析,优化颜色表现
- 亮度排序排列,呈现自然调色板过渡
- 干净样本设计,无多余边框或文字干扰
📦 使用方法
基本工作流步骤:
- 在 ComfyUI 工作流中添加
Easy Color Correction节点 - 连接图像输入
- 选择模式:
- 自动模式:启用 AI 分析并自动增强
- 预设模式:选择风格化预设,可选 AI 适配
- 手动模式:完全手动控制调色参数
- 连接输出:
- 主图像输出 → 保存图像或进一步处理
- 直方图输出 → 连接到 Preview Image 查看 RGB 分布
- 调色板输出 → 查看颜色样本
- 调色板数据 → 用于文本节点或其他颜色感知节点
启用视觉分析:
- 开启
Extract Palette以生成:- ✅ RGB 直方图
- ✅ 颜色调色板
- ✅ 控制台颜色分析
- ✅ K 均值聚类结果
注意:关闭此选项将使直方图和调色板输出为纯黑图像。
💡 专业提示
| 技巧 | 说明 |
|---|---|
| 启用实时预览 | 使用“Selective Execution”获得即时反馈 |
| 手动模式禁用 AI | 默认禁用 AI 分析,可根据需要重新启用 |
| 预设滑块同步更新 | 显示具体参数变化,便于理解 |
| 白平衡范围 | -1.0 = 冷/蓝,+1.0 = 暖/橙(符合行业标准) |
| 温度与色调分离 | 更适合专业调色师使用 |
| 面部检测最佳条件 | 清晰、明亮的人像效果最佳 |
| 先尝试预设,再手动微调 | 可节省大量时间 |
| 启用 Extract Palette | 获取直方图与调色板数据 |
| 使用参考图像匹配颜色 | 可构建情绪板或统一风格 |
| 连接 Preview Image | 即时查看直方图与调色板输出 |
📈 示例控制台输出
🤖 AI分析:概念艺术场景,良好光照,检测到0张面部
🎨 AI增强预设:史诗奇幻,适应概念艺术/良好光照
🎛️ 手动模式:自动禁用AI分析,纯粹手动控制
🌡️ 应用专业颜色调整:温度:0.3(较暖),色调:-0.1(绿)
🎨 提取的颜色调色板:#2A1810,#8B4513,#D2691E,#F4A460,#DEB887,#F5DEB3
🖼️ 直方图和调色板图像作为独立节点输出可用
⚙️ 高级配置参数
| 参数 | 默认值 | 说明 |
|---|---|---|
ai_analysis | True | 启用 AI 驱动功能 |
adjust_for_skin_tone | True | 面部检测+肤色保护 |
white_balance_strength | 0.0 | 温度强度(-1.0 到 +1.0) |
enhancement_strength | 0.2 | 整体增强力度(默认平衡) |
extract_palette | False | 生成直方图与调色板图像 |
realtime_preview | False | 启用选择性执行,加速反馈速度 |
🧠 技术原理简述
计算机视觉流水线
- OpenCV 面部检测:Haar 级联分类器 + SLIC 分割
- K均值颜色分析:RGB 与 LAB 空间提取主要颜色簇
- 边缘密度分析:多尺度边缘检测,区分动漫与真实照片
- 直方图分析:光照检测与 RGB 分布分析
- SLIC 分割:超像素分割,提升肤色区域精度
颜色科学基础
- LAB 颜色空间:基于布拉德福德变换的感知白平衡
- 感知曲线:Gamma 感知的亮度/对比度调节
- 选择性饱和度:使用蒙版保护肤色,增强鲜艳度
- 三路校正:Lift/Gamma/Gain 结合内容感知调整
- 颜色匹配:基于直方图 + LAB 空间的参考图像匹配
- 调色板提取:感知间距的亮度排序主要颜色
📬 推荐使用场景
- 快速增强:AI 自动优化图像色彩,适合概念艺术、动漫、肖像
- 风格统一:使用预设风格快速统一画面氛围
- 专业调色:手动模式媲美 Lightroom/DaVinci
- 视频调色:批量处理视频帧,保持帧间一致性
- 颜色分析:获取图像直方图与调色板,辅助设计决策
📌 总结
ComfyUI-EasyColorCorrector 是一款融合 AI 与专业调色理念的强大插件,具备:
✅ AI 自动增强
✅ 丰富专业预设
✅ 精准手动控制
✅ 直方图与调色板分析
✅ 视频批处理能力
无论是艺术创作、影视后期还是商业摄影,这款插件都能显著提升你的调色效率与质量。















