%20(1).png)
ComfyUI-EasyColorCorrector 插件保姆级教程
1. 插件简介
插件地址： https://github.com/regiellis/ComfyUI-EasyColorCorrector
ComfyUI-EasyColorCorrector 是一个专业级的颜色修正工具包，就像给你的图片配了一个专业的摄影师助手。这个插件能够智能地分析你的图片，然后帮你调整颜色、亮度、对比度等等，让图片看起来更美观更专业。
主要功能：
- 就像手机里的美图秀秀，但是更专业更智能
- 能够自动识别你的图片类型（比如动漫、人像、概念图等）
- 提供30多种现成的滤镜风格，比如电影风格、赛博朋克风格等
- 能够自动识别人脸并保护肌肤色调
- 修复ComfyUI工作流中常见的颜色偏移问题
2. 如何安装
方法一：Git安装（推荐）
- 打开命令行，进入你的ComfyUI安装目录
- 输入以下命令：
cd ComfyUI/custom_nodes
git clone https://github.com/regiellis/ComfyUI-EasyColorCorrector.git
cd ComfyUI-EasyColorCorrector
pip install -r requirements.txt
方法二：手动安装
- 从GitHub下载插件压缩包
- 解压到
ComfyUI/custom_nodes/ComfyUI-EasyColorCorrector - 安装依赖库（在命令行中输入）：
pip install torch>=1.12.0 numpy>=1.21.0 opencv-python>=4.8.0 scikit-learn>=1.3.0 scikit-image>=0.21.0 colour-science>=0.4.3 scipy>=1.11.0 rawpy>=0.18.0 imageio>=2.28.0 OpenEXR>=1.3.9 Pillow>=9.0.0 torchvision>=0.13.0 huggingface_hub>=0.15.0 timm>=0.9.2
- 重启ComfyUI
注意： 即使不安装那些高级库，插件也能工作，只是会缺少一些AI智能功能。
3. 节点逐一解析
3.1 Easy Color Corrector（主要颜色修正节点）
这是插件的核心节点，就像一个全能的图片美化师。它有三种工作模式：
Auto模式： 让AI自动帮你调整，适合懒人使用
Preset模式： 选择现成的风格滤镜，像Instagram滤镜一样
Manual模式： 完全手动控制，适合专业用户
3.2 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| AI分析开关 | ai_analysis | 布尔值 | True | 是否让AI帮你分析图片类型 | 启用AI场景检测和内容感知增强 | 开启后AI会自动识别是动漫、人像还是其他类型 |
| 肌肤色调调整 | adjust_for_skin_tone | 布尔值 | True | 是否保护人脸肌肤的自然色调 | 基于OpenCV人脸检测的肌肤色调保护 | 拍人像照片时开启，避免把脸调成绿色 |
| 白平衡强度 | white_balance_strength | 浮点数 (-1.0到1.0) | 0.0 | 调整图片的冷暖色调 | LAB色彩空间中的色温调整 | -1.0让图片偏蓝偏冷，1.0让图片偏橙偏暖 |
| 增强强度 | enhancement_strength | 浮点数 (0.0到1.0) | 0.2 | AI增强的力度大小 | AI驱动的整体增强强度控制 | 0.2是平衡值，数值越大效果越明显 |
| 提取调色板 | extract_palette | 布尔值 | False | 是否生成颜色直方图和调色板图片 | 生成RGB直方图和K-means聚类调色板 | 开启后会输出图片的颜色分析结果 |
| 锁定输入图片 | lock_input_image | 布尔值 | False | 锁定输入防止重复处理 | 缓存输入图像避免上游节点重复执行 | 调参数时开启，加快处理速度 |
| 工作模式 | mode | 字符串 | "auto" | 选择工作模式 | 三种处理模式的切换 | auto自动/preset预设/manual手动 |
| 预设风格 | preset | 字符串 | "natural" | 选择预设的滤镜风格 | 30种专业预设风格选择 | 选择电影风格、动漫风格等 |
| 对比度 | contrast | 浮点数 (-1.0到1.0) | 0.0 | 图片的明暗对比强度 | 感知伽马校正的对比度调整 | 正值让图片更有层次，负值让图片更平 |
| 亮度 | brightness | 浮点数 (-1.0到1.0) | 0.0 | 图片的整体明暗程度 | 感知曲线的亮度调整 | 正值让图片更亮，负值让图片更暗 |
| 饱和度 | saturation | 浮点数 (-1.0到1.0) | 0.0 | 颜色的鲜艳程度 | 选择性饱和度增强 | 正值让颜色更鲜艳，负值让颜色更淡 |
| 色温 | temperature | 浮点数 (-1.0到1.0) | 0.0 | 图片的冷暖色调（手动模式） | LAB色彩空间的蓝橙轴调整 | 手动模式下的专业色温控制 |
| 色调 | tint | 浮点数 (-1.0到1.0) | 0.0 | 图片的绿紫色调（手动模式） | LAB色彩空间的绿品轴调整 | 手动模式下的专业色调控制 |
| 阴影 | lift | 浮点数 (-1.0到1.0) | 0.0 | 调整图片暗部区域 | 三分法颜色校正的阴影调整 | 正值提亮暗部，负值压暗暗部 |
| 中间调 | gamma | 浮点数 (-1.0到1.0) | 0.0 | 调整图片中间亮度区域 | 三分法颜色校正的中间调调整 | 调整图片中等亮度区域的色彩 |
| 高光 | gain | 浮点数 (-1.0到1.0) | 0.0 | 调整图片亮部区域 | 三分法颜色校正的高光调整 | 正值提亮高光，负值压暗高光 |
| 参考图片 | reference_image | 图片 | 无 | 用于颜色匹配的参考图片 | 基于直方图和LAB空间的颜色匹配 | 想让图片的颜色像某张图片就导入参考图 |
3.3 VAE Color Corrector（VAE颜色修正节点）
这个节点专门解决一个特殊问题：当你的图片经过ComfyUI的VAE编码解码后，颜色会发生偏移。就像照片过了一遍复印机，颜色变了。
3.4 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 原始图片 | original_image | 图片 | 必需 | VAE处理前的原始图片 | VAE编码前的参考图像 | 连接你最开始的图片 |
| 处理后图片 | processed_image | 图片 | 必需 | VAE处理后的图片 | VAE解码后的待校正图像 | 连接经过VAE处理的图片 |
| 修正方法 | correction_method | 字符串 | "luminance_zones" | 选择颜色修正的算法 | 四种专业颜色校正算法 | 推荐用luminance_zones，效果最好 |
| 修正强度 | correction_strength | 浮点数 (0.0到1.0) | 0.8 | 颜色修正的强度大小 | 校正算法的应用强度 | 0.8通常效果最好，太高可能过度校正 |
| 蒙版 | mask | 蒙版 | 可选 | 指定哪些区域需要修正 | 自定义校正区域蒙版 | 白色区域保持不变，黑色区域被修正 |
| 自动保护 | auto_preserve | 布尔值 | False | 自动识别并保护修复的区域 | 自动检测修复区域并保护 | 用于修复画面时开启 |
| 边缘羽化 | edge_feather | 浮点数 (0.0到1.0) | 0.1 | 修正边缘的平滑程度 | 校正边界的羽化强度 | 让修正边缘更自然过渡 |
| 锁定输入图片 | lock_input_image | 布尔值 | False | 锁定输入防止重复处理 | 缓存输入避免重复计算 | 调参数时开启，提高速度 |
3.5 Batch Color Corrector（批量颜色修正节点）
这个节点用于处理一批图片，比如你有一个视频拆分成的连续帧，想要统一颜色风格。
3.6 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 图片批次 | image_batch | 图片批次 | 必需 | 一批要处理的图片 | 批量图像张量输入 | 连接多张图片或视频帧 |
| 处理模式 | processing_mode | 字符串 | "consistent" | 批处理的方式 | 批量处理的一致性模式 | consistent保持风格一致 |
| 参考帧 | reference_frame | 整数 | 0 | 用作参考的帧编号 | 作为颜色参考的帧索引 | 通常用第一帧（0）作为参考 |
| 时间一致性 | temporal_consistency | 浮点数 (0.0到1.0) | 0.5 | 帧间颜色的平滑程度 | 时序一致性强度控制 | 防止视频帧间颜色跳变 |
| AI分析 | ai_analysis | 布尔值 | True | 是否对每帧进行AI分析 | 启用批量AI场景分析 | 让AI分析每一帧的内容特征 |
3.7 RAW Image Processor（RAW图片处理节点）
这个节点专门处理相机拍摄的RAW格式图片，就像Lightroom一样。
3.8 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| RAW文件路径 | raw_file_path | 字符串 | 必需 | RAW文件的存放位置 | RAW图像文件路径 | 输入.cr2、.nef等RAW文件路径 |
| 曝光补偿 | exposure_compensation | 浮点数 (-3.0到3.0) | 0.0 | 调整图片的曝光明暗 | 线性曝光值调整 | 正值让图片更亮，负值让图片更暗 |
| 白平衡模式 | white_balance_mode | 字符串 | "auto" | 白平衡的计算方式 | 白平衡算法选择 | auto自动、daylight日光等 |
| 色彩空间 | color_space | 字符串 | "sRGB" | 输出图片的色彩标准 | 目标色彩空间定义 | sRGB适合网络，AdobeRGB适合印刷 |
| 降噪强度 | noise_reduction | 浮点数 (0.0到1.0) | 0.3 | 去除图片噪点的强度 | 降噪算法强度控制 | 高ISO照片需要更高的降噪 |
3.9 Color Corrector Viewer（颜色修正预览节点）
这个节点提供实时预览功能，让你能看到调整的效果。
3.10 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | input_image | 图片 | 必需 | 要预览的图片 | 待预览的图像输入 | 连接你要查看效果的图片 |
| 显示模式 | display_mode | 字符串 | "split" | 预览的显示方式 | 预览显示模式选择 | split分屏对比、before原图、after效果图 |
| 显示直方图 | show_histogram | 布尔值 | True | 是否显示颜色直方图 | 是否叠加RGB直方图显示 | 开启后可以看到颜色分布情况 |
| 显示信息 | show_info | 布尔值 | True | 是否显示图片信息 | 是否显示图像元数据信息 | 显示图片尺寸、色彩空间等信息 |
3.11 Color Palette Extractor（调色板提取节点）
这个节点专门提取图片中的主要颜色，生成调色板。
3.12 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | input_image | 图片 | 必需 | 要提取颜色的图片 | 源图像输入 | 连接你想分析颜色的图片 |
| 颜色数量 | num_colors | 整数 (3到20) | 6 | 提取多少种主要颜色 | K-means聚类的颜色数量 | 6种颜色通常足够表现图片色调 |
| 分析方法 | analysis_method | 字符串 | "kmeans" | 颜色分析的算法 | 颜色聚类算法选择 | kmeans效果最好，median中位数法更快 |
| 亮度排序 | brightness_sort | 布尔值 | True | 是否按亮度排列颜色 | 按感知亮度排序调色板 | 让调色板从暗到亮排列更直观 |
| 输出格式 | output_format | 字符串 | "hex" | 颜色值的输出格式 | 颜色数据的编码格式 | hex十六进制、rgb数值、hsl色相饱和度 |
4. 使用技巧和建议
4.1 新手使用建议
- 从Auto模式开始：刚接触时直接用AI自动模式，让AI帮你调整
- 尝试预设风格：在Preset模式下试试不同的滤镜效果
- 开启调色板提取：能帮你了解图片的颜色构成
- 先用默认参数：不要一开始就大幅调整参数
4.2 进阶使用技巧
- 使用参考图片：想要特定颜色风格时，导入一张参考图片
- 组合使用节点：主节点调整整体，VAE节点修正偏移
- 批量处理视频：用批量节点处理视频帧，保持一致性
- 手动微调：在Auto基础上切换到Manual模式进行精细调整
4.3 参数调整原则
- 小步快跑：每次只调整一点点，观察效果
- 保存备份：调出满意效果后保存工作流
- 注意肌肤：处理人像时一定要开启肌肤保护
- 对比查看：用Viewer节点实时对比前后效果
5. 常见问题解答
Q1：为什么安装后找不到节点？
A： 重启ComfyUI，检查是否正确安装依赖库。如果还是不行，查看ComfyUI启动日志是否有错误信息。
Q2：AI功能不工作怎么办？
A： 需要安装完整的依赖库，特别是opencv-python、scikit-learn等。没有这些库，节点只能做基础调色。
Q3：处理速度很慢怎么办？
A：
- 关闭不需要的AI分析功能
- 开启"锁定输入图片"选项
- 降低图片分辨率
- 使用更少的颜色提取数量
Q4：颜色调整后不自然怎么办？
A：
- 降低各种强度参数
- 开启肌肤色调保护
- 使用更保守的预设风格
- 检查是否使用了合适的参考图片
Q5：VAE颜色修正没效果？
A：
- 确保连接了正确的原始图片和处理后图片
- 尝试不同的修正方法
- 调整修正强度到0.8左右
- 检查是否需要提供蒙版
Q6：批量处理视频帧出现颜色跳变？
A：
- 提高时间一致性参数
- 选择合适的参考帧
- 确保所有帧的拍摄条件相似
- 使用consistent处理模式
6. 输出接口说明
每个节点都有多个输出接口：
主要输出
- 处理后图片：调色后的最终图片
- 调色板数据：逗号分隔的颜色代码字符串
- 直方图图片：RGB颜色分布图（512×768像素）
- 调色板图片：颜色色块展示图（600×120像素）
使用建议
- 主图片输出连接到保存节点或下一步处理
- 直方图和调色板输出连接到预览节点查看分析结果
- 调色板数据可以传递给其他需要颜色信息的节点
7. 工作流集成建议
基础工作流
加载图片 → Easy Color Corrector → 保存图片
完整工作流
加载图片 → Easy Color Corrector → VAE编码 → [其他处理] → VAE解码 → VAE Color Corrector → 保存图片
分析工作流
加载图片 → Color Palette Extractor → 预览调色板
↓
Easy Color Corrector → Color Corrector Viewer → 预览效果
这个插件功能强大但易于使用，无论你是新手还是专业用户，都能找到适合自己的使用方式。记住多实验，多对比，找到最适合你图片风格的设置！