ComfyUI-Curve

中文 | English

---

中文

ComfyUI专业色彩调整扩展，提供类似Photoshop的曲线、HSL、色阶调整功能，支持70+种预设风格、高级遮罩和Lightroom风格的色彩分级功能。

📅 最新更新 (2025-07-02)

🎯 CurvePreset智能联动功能

• ✅ 智能通道识别：每个预设风格都配置了基于色彩理论的最佳适用通道
• ✅ 自动应用机制：PS Curve节点自动将预设应用到建议通道，无需手动选择
• ✅ 70+风格智能映射：电影蓝橙→蓝色通道，日系清新→绿色通道，港风经典→红色通道
• ✅ 专业工作流程：CurvePresetNode → PS Curve，一步到位获得专业调色效果

📊 PS Curve直方图增强 (2025-06-25)

• ✅ 通道独立直方图：每个通道（RGB/R/G/B）显示对应的直方图背景
• ✅ 双输出支持：PS Curve节点现在输出处理后的图像和曲线分析图表
• ✅ 实时直方图更新：工作流执行后自动使用处理后的图像更新直方图
• ✅ 弹窗支持：节点和弹窗编辑器都支持直方图显示

🌟 主要功能

项目介绍视频：https://www.bilibili.com/video/BV1bxKqzQEw1/?vd_source=443ea67b1e3e510a92de1942e4d60082

🎨 曲线调整 (Photoshop Curve)

• 类似Photoshop的专业曲线调整，支持多种插值方式
• 双击节点进入实时调整界面：在弹出窗口中直接拖动控制点，即刻观察图像变化效果
• 通道独立直方图背景：每个通道显示对应的直方图，便于精确调整
• 支持RGB整体或单独R/G/B通道调整
• 双输出功能：主图像输出 + 曲线/直方图分析图表
• 可调曲线效果强度（0-200%）
• 弹窗内调整立即应用：所有曲线修改无需重新运行工作流即可在弹窗内实时查看效果
• 简化数值输入：点击"🎯 数值输入"显示精确坐标输入工具，不影响曲线编辑器操作
• 内置70+种预设风格：人像、风景、电影、复古等多种风格，可直接从下拉列表选择应用
• 支持自定义预设：可保存、加载、管理和分享您的曲线预设
• 智能预设联动：可接收CurvePresetNode的预设数据，自动应用到最佳颜色通道

🎭 HSL调整 (Photoshop HSL)

- 精准控制8个颜色通道：红、橙、黄、绿、浅绿、蓝、紫、品红 - 每个颜色可独立调整色相、饱和度、明度 - 双击节点打开HSL调整弹窗：在弹出窗口中滑动调节器立即显示颜色变化效果，所见即所得 - 支持遮罩和羽化效果 - 弹窗内实时交互响应：在弹出界面中调整任何HSL参数都能即时反映在预览图像上 - 支持自定义预设：可保存、加载、管理和分享您的HSL调整预设

🎚️ 色阶调整 (Photoshop Levels)

- 双击节点打开Photoshop风格色阶调整界面：专业三点控制（黑场、灰场、白场） - 实时预览调整：拖动滑块即时查看色阶调整效果 - 自动色阶功能：一键自动优化图像对比度和色阶分布 - 自动对比度功能：智能增强图像对比度 - 精确数值控制：输入/输出黑白场点、伽马值精确调整 - 直方图背景显示：在色阶界面中显示实时直方图，便于精确调整

🎨 色彩分级 (Color Grading)

- 双击节点打开Lightroom风格的色彩分级界面：专业三色轮设计（阴影、中间调、高光） - 实时交互式色轮操作：直接在色轮上拖拽调整色相和饱和度，实时预览效果 - 专业的色彩处理：精确的色彩控制，确保调色准确性 - 多种混合模式：normal、multiply、screen、overlay、soft_light等专业混合选项 - 分区域调色：独立控制阴影、中间调、高光区域的色彩 - 强度控制：可调整整体效果强度（0-200%） - 支持自定义预设：可保存、加载、管理和分享您的色彩分级预设

🔀 高斯模糊 (Gaussian Blur with Mask)

- 选择性模糊处理：通过遮罩精确控制模糊区域 - 可调模糊半径：支持0-100像素的模糊强度调整 - 遮罩羽化：0-20像素的边缘羽化，实现自然过渡 - 遮罩反转：快速反转模糊区域 - 应用场景：背景虚化、焦点突出、隐私保护、艺术效果

🔍 直方图分析 (Histogram Analysis)

- 专业的图像直方图分析节点 - 详细的统计信息：平均值、中位数、标准差等图像统计数据 - 像素分布可视化：清晰显示图像的亮度和颜色分布情况 - 多通道支持：支持RGB整体或单独R/G/B通道分析 - 为其他调整节点提供数据参考

🎯 Camera Raw增强 (Camera Raw Enhance)

去薄雾效果对比：

• 集成Adobe Camera Raw的三个核心增强功能
• 纹理 (Texture)：增强中等大小细节的对比度，范围-100到100
• 清晰度 (Clarity)：增强中间调对比度，让图像更锐利，范围-100到100
• 去薄雾 (Dehaze)：减少或增加大气雾霾效果，范围-100到100
• 前后端算法完全一致：实时预览效果与最终输出完全匹配
• 智能算法选择：根据图像特征自动选择最优去薄雾算法
• 支持混合控制和整体强度调节
• 包含完整的前端JavaScript界面，支持实时预览
• 支持自定义预设：可保存、加载、管理和分享您的增强预设

📐 曲线预设 (Curve Presets)

- 70+专业预设风格：覆盖人像、风景、电影、日系、港风、时尚等多种调色风格 - 智能通道建议：每个预设都配置了基于色彩理论的最佳适用通道 - 一键专业调色：选择风格后自动输出曲线数据和建议通道信息 - 与PS Curve完美联动：连接PS Curve节点实现预设的智能应用 - 分类明确：基础风格、电影级调色、胶片风格、日系风格、港风系列等 - 专业通道映射： - 冷色调风格 → 蓝色通道：电影蓝橙、赛博朋克、科技感 - 自然色调风格 → 绿色通道：日系清新、风景增强、自然风光
- 暖色调风格 → 红色通道：港风经典、复古暖调、人像美颜 - 全局调整风格 → RGB通道：人像专用、高对比度、商业摄影

🎯 高级遮罩支持

• 选择性调整特定区域
• 遮罩边缘羽化，自然过渡
• 支持遮罩反转

💡 交互式编辑

• 双击节点打开专业调整弹窗，在弹出界面中实时预览调整效果
• 弹窗内所有调整参数实时同步，无需重新运行工作流
• 零延迟反馈：在弹出窗口中调整参数时图像实时更新，像使用专业图像编辑软件一样流畅
• 支持曲线、HSL、色阶和色彩分级节点的交互式编辑
• 类似Photoshop的专业编辑体验

🚀 未来计划

🎨 高级图层功能

• ✨ 自动混合图层功能：智能混合多个调整效果，自动优化图层顺序和混合模式
• 📏 图层蒙版管理：支持矢量蒙版、智能蒙版和渐变蒙版
• 🔄 非破坏性编辑：保存完整的调整历史，随时回到任何编辑状态

🎯 算法精度提升

• 🔧 PS Curve效果完全对齐：将曲线调整效果与Adobe Photoshop完全对齐，确保1:1还原专业调色效果
• 🌈 色彩空间扩展：支持更多专业色彩空间（ProPhoto RGB、Adobe RGB等）
• ⚡ 性能优化：GPU加速处理，大幅提升处理速度

🎬 专业工作流增强

• 📸 RAW文件直接支持：直接处理相机RAW格式文件
• 🎥 视频调色支持：扩展到视频序列的专业调色
• 🎨 LUT导入导出：支持业界标准LUT文件格式

📥 安装方法

Git克隆（推荐）

cd ComfyUI/custom_nodes
git clone https://github.com/aiaiaikkk/ComfyUI-Curve.git

手动下载

1. 下载ZIP文件
2. 解压到 ComfyUI/custom_nodes/ComfyUI-Curve
3. 重启ComfyUI

依赖要求

• torch>=1.9.0
• numpy>=1.21.0
• scipy>=1.7.0

📝 使用技巧

如何使用CurvePreset智能联动功能

1. 智能预设应用流程：
2. 在工作流中添加CurvePresetNode（📐 Curve Presets）
3. 在工作流中添加PhotoshopCurveNode（🎨 PS Curves）
4. 将CurvePresetNode的curve_points输出连接到PS Curve的preset_curve_points输入
5. 将CurvePresetNode的suggested_channel输出连接到PS Curve的preset_suggested_channel输入
6. 在CurvePresetNode中选择您想要的风格（如"电影蓝橙"）
7. 自动完成：PS Curve会自动将曲线应用到蓝色通道（建议通道）

8. 运行工作流即可获得专业的电影级蓝橙色调效果

9. 智能通道映射示例：

10. 选择"日系清新" → 自动应用到绿色通道，增强自然色彩
11. 选择"港风经典" → 自动应用到红色通道，营造经典港片暖调
12. 选择"赛博朋克" → 自动应用到蓝色通道，突出科幻冷调
13. 选择"人像专用" → 自动应用到RGB通道，整体提升人像效果

如何使用弹窗实时预览功能

1. 曲线调整实时预览：
2. 在工作流中添加Photoshop Curve节点
3. 连接输入图像和遮罩（可选）
4. 双击节点打开调整弹窗
5. 此时您可以看到弹出窗口中的图像预览区域和曲线编辑区域
6. 在弹窗内曲线上添加控制点：点击曲线添加新控制点
7. 在弹窗内拖动控制点：左键按住并拖动控制点，观察图像实时变化
8. 在弹窗内删除控制点：右键点击控制点
9. 在弹窗内切换通道：点击RGB、R、G、B按钮切换不同通道曲线
10. 在弹窗内调整强度：移动强度滑块即时查看不同强度效果
11. 数值输入控制点：点击帮助栏中的"🎯 数值输入"显示坐标输入工具，输入X,Y值后点击"添加"
12. 批量输入控制点：在数值输入工具中点击"批量"按钮，输入格式：0,0;64,80;128,128;192,200;255,255

13. 完成后点击弹窗中的应用按钮，参数将自动同步到节点

14. HSL调整实时预览：

15. 在工作流中添加Photoshop HSL节点
16. 连接输入图像和遮罩（可选）
17. 双击节点打开HSL调整弹窗
18. 在弹出窗口中选择您想调整的颜色通道（红、橙、黄等）
19. 在弹窗内移动色相滑块：左右拖动调整该颜色的色相值
20. 在弹窗内移动饱和度滑块：左右拖动调整该颜色的饱和度
21. 在弹窗内移动明度滑块：左右拖动调整该颜色的明度
22. 弹窗内每个滑块调整都会实时更新预览图像

23. 完成后点击弹窗中的应用按钮，参数将自动同步到节点

24. Color Grading调整实时预览：

25. 在工作流中添加Color Grading节点
26. 连接输入图像和遮罩（可选）
27. 双击节点打开色彩分级调整弹窗
28. 在弹出窗口中您将看到三个色轮：阴影、中间调和高光
29. 色轮操作：直接在色轮上拖拽调整各区域的色彩
30. 饱和度控制：通过滑块调整颜色的鲜艳程度
31. 使用亮度滑块调整各区域明暗程度
32. 选择混合模式控制颜色应用方式
33. 调整整体强度控制效果程度
34. 预览窗口实时更新，所见即所得

35. 完成后点击弹窗中的应用按钮，参数将自动同步到节点

36. 色阶调整实时预览：

37. 在工作流中添加Photoshop Levels节点
38. 连接输入图像和遮罩（可选）
39. 双击节点打开色阶调整弹窗
40. 在弹出窗口中您将看到带直方图背景的色阶调整界面
41. 三点控制调整：
    • 左侧滑块：调整黑场点（输入暗部范围）
    • 中间滑块：调整伽马值（中间调亮度）
    • 右侧滑块：调整白场点（输入亮部范围）
42. 输出色阶调整：设置输出的黑白场范围
43. 自动功能：
    • 点击"自动色阶"按钮自动优化图像对比度
    • 点击"自动对比度"按钮智能增强对比度
44. 所有调整都会在预览窗口中实时显示效果

45. 完成后点击弹窗中的应用按钮，参数将自动同步到节点

46. 弹窗预览界面通用操作：

47. 放大/缩小预览：在弹窗内使用鼠标滚轮或+/-按钮
48. 平移预览：在弹窗内按住中键并拖动
49. 对比原图：在弹窗内按住空格键查看原始图像，释放返回调整后效果
50. 重置参数：点击弹窗内的重置按钮恢复默认设置
51. 取消编辑：点击弹窗内的取消按钮放弃当前更改
52. 应用编辑：点击弹窗内的应用按钮确认更改并同步到节点

曲线调整技巧

• S形曲线：增加对比度
• 反S形：减少对比度
• 上移曲线：提亮图像
• 下移曲线：压暗图像
• 实时预览技巧：在弹窗中使用多个控制点微调局部区域，观察实时效果找到最佳调整

HSL调整技巧

• 肤色调整：微调红橙色相和饱和度
• 天空增强：调整蓝色和浅绿通道
• 叶绿增强：调整绿色和黄色通道
• 日落效果：增强橙色和品红通道
• 实时预览技巧：在弹窗中逐个通道调整并观察实时效果，找到理想的颜色平衡点

直方图分析技巧

• 亮度分布判断：
• 左侧堆积：图像偏暗，考虑提亮处理
• 右侧堆积：图像偏亮，考虑压暗处理
• 中间集中：对比度较低，需要增强对比
• 双峰分布：图像层次丰富，对比度良好
• 颜色通道分析：
• R/G/B通道偏移：判断色偏问题
• 某通道过度集中：该颜色饱和度可能过高或过低
• 统计数据应用：
• 平均值：判断整体亮度水平
• 标准差：评估图像对比度和层次
• 中位数：了解像素分布的平衡点

色阶调整技巧

• 三点控制策略：
• 黑场点：设置图像中最暗部分的位置，影响阴影细节
• 白场点：设置图像中最亮部分的位置，影响高光细节
• 伽马值：调整中间调亮度，<1变亮，>1变暗
• 自动功能使用：
• 自动色阶：适合欠曝或过曝图像的快速修正
• 自动对比度：适合对比度不足的平淡图像
• 输出色阶控制：
• 压缩动态范围：适合打印输出或特殊效果
• 扩展输出范围：增强图像对比度
• 结合直方图调整：观察直方图变化，避免过度调整导致的色阶断层

Color Grading技巧

• 三区域独立调色：分别调整阴影、中间调、高光的色彩
• 饱和度控制：调整各区域颜色的鲜艳程度
• 风格化调色：
• 电影风格：阴影区域添加蓝色，高光添加暖色
• 复古效果：阴影添加青色，高光添加橙黄色
• 日落效果：阴影添加紫色，高光添加橙色
• 冷调风格：所有区域朝向蓝青色调整
• 暖调风格：所有区域朝向橙黄色调整
• 混合模式应用：
• soft_light：自然的颜色增强，适合微调
• overlay：强烈的对比增强，适合戏剧效果
• multiply：压暗效果，适合营造神秘氛围
• screen：提亮效果，适合梦幻风格

Camera Raw增强技巧

• 纹理调整：
• 正值（1-100）：增强细节，让图像更有质感
• 负值（-1到-100）：柔化细节，适合人像皮肤处理
• 清晰度调整：
• 正值：增强中间调对比度，让图像更锐利
• 负值：减少中间调对比度，产生柔焦效果
• 去薄雾调整：
• 正值：减少雾霾，增强清晰度和色彩饱和度
• 负值：增加雾霾效果，营造朦胧氛围
• 组合使用建议：
• 风景照片：纹理+10，清晰度+20，去薄雾+15
• 人像照片：纹理-10，清晰度+5，去薄雾+5
• 建筑摄影：纹理+20，清晰度+25，去薄雾+10

遮罩应用技巧

• 人像皮肤：建议2-4像素羽化
• 天空背景：建议5-10像素羽化
• 物体边缘：建议1-3像素羽化
• 大面积区域：建议8-15像素羽化

🆕 历史更新

2025-06-26 - 系统优化与算法对齐

• 前后端算法同步：修复Camera Raw去薄雾算法不一致问题
• 错误修复：修复GaussianBlurNode参数传递错误
• 项目清理：删除临时测试文件，保持结构整洁
• CurvePreset智能联动：实现预设与PS Curve的智能通道映射

2025-06-25 - PS Curve直方图增强

• 通道独立直方图：每个曲线通道显示对应的直方图
• 双输出支持：新增curve_chart输出，显示曲线和直方图分析
• 实时更新：工作流执行后自动更新直方图
• 问题修复：修复Histogram Analysis批处理输出和弹窗直方图显示问题

2025-06-24 - 预设系统增强

• PS Curve预设：完整的预设管理功能，支持保存/加载/导出
• HSL预设：为HSL调整添加预设支持
• 遮罩改进：扩大羽化范围至0-50像素
• 问题修复：修复默认预设加载问题

2025-06-22 - 完整模块化重构

• 架构升级：重构为清晰的模块化架构（18个Python模块）
• 更好的组织：节点按功能类型分类
• 代码复用：BaseImageNode消除重复代码
• 易于维护：每个节点独立文件

📄 许可证

MIT许可证 - 查看 LICENSE 文件。

---

English

Professional color adjustment extension for ComfyUI with Photoshop-like Curve, HSL, and Levels adjustment functionality, 70+ preset styles, advanced mask support, and Lightroom-style Color Grading. The standout feature is the ability to double-click nodes to open popup windows with real-time preview that allows you to color grade with the precision of professional image editing software.

📅 Latest Updates (2025-06-26)

🔧 System Optimization & Algorithm Alignment

• ✅ Frontend-Backend Algorithm Sync: Fixed Camera Raw dehaze algorithm inconsistency between frontend and backend, preview effects now match actual processing results more closely
• ✅ Bug Fix: Fixed GaussianBlurNode parameter passing error, improved system stability
• ⚠️ Dehaze Algorithm Ongoing Optimization: Currently achieved basic algorithm alignment, but still has gaps with PS Camera Raw effects, continue debugging
• 🧹 Project Cleanup: Removed temporary test files, maintaining clean project structure

🎯 CurvePreset Smart Linking Feature

• ✅ Intelligent channel recognition: Each preset style is configured with optimal color channel based on color theory
• ✅ Automatic application: PS Curve node automatically applies presets to suggested channels without manual selection
• ✅ 70+ smart style mapping: Cinematic Blue-Orange→Blue channel, Japanese Fresh→Green channel, Hong Kong Classic→Red channel
• ✅ Professional workflow: CurvePresetNode → PS Curve, one-step professional color grading

📊 PS Curve Histogram Enhancement (2025-06-25)

• ✅ Channel-specific histograms: Each channel (RGB/R/G/B) now shows its corresponding histogram in the curve editor background
• ✅ Dual output support: PS Curve node now outputs both processed image and curve analysis chart
• ✅ Live histogram updates: Histograms update automatically after workflow execution using the processed image
• ✅ Modal support: Histogram display works in both node and popup modal editors

🌟 Key Features

🎨 Curve Adjustment (Photoshop Curve)

• Professional Photoshop-style curve adjustment with multiple interpolation methods
• Double-click node for real-time adjustment interface: Directly drag control points in the popup window and instantly see image changes
• Channel-specific histogram backgrounds: Each channel displays its corresponding histogram for precise adjustments
• Support for RGB overall or individual R/G/B channel adjustment
• Dual outputs: Main image output + curve/histogram analysis chart
• Adjustable curve effect intensity (0-200%)
• Popup window adjustments apply immediately: All curve modifications can be viewed in real-time within the popup without re-running the workflow
• Simplified numerical input: Click "🎯 数值输入" to show precise coordinate input tools without affecting curve editor operation
• Built-in 70+ preset styles: Portrait, landscape, cinematic, vintage and more, directly selectable from dropdown
• Custom preset support: Save, load, manage and share your curve presets
• Smart preset linking: Accepts preset data from CurvePresetNode and automatically applies to optimal color channels

🎭 HSL Adjustment (Photoshop HSL)

- Precise control over 8 color channels: Red, Orange, Yellow, Green, Cyan, Blue, Purple, Magenta - Independent adjustment of Hue, Saturation, and Lightness for each color - Double-click node to open HSL adjustment popup: Slide controllers in the popup window to immediately see color change effects, WYSIWYG - Support for masks and feathering effects - Real-time interactive response in popup: Any HSL parameter adjustment in the popup interface instantly reflects in the preview image - Custom preset support: Save, load, manage and share your HSL adjustment presets

🎚️ Levels Adjustment (Photoshop Levels)

- Double-click node for Photoshop-style levels adjustment interface: Professional three-point control (black point, gray point, white point) - Real-time preview adjustment: Drag sliders to instantly see levels adjustment effects - Auto levels function: One-click automatic optimization of image contrast and level distribution - Auto contrast function: Intelligent image contrast enhancement - Precise numerical control: Accurate adjustment of input/output black/white points and gamma values - Histogram background display: Shows real-time histogram in levels interface for precise adjustments

🎨 Color Grading

- Double-click for Lightroom-style color grading interface: Professional three-wheel design (shadows, midtones, highlights) - Real-time interactive color wheel operation: Directly drag on wheels to adjust hue and saturation with instant preview - Professional color processing: Precise color control ensures grading accuracy - Multiple blend modes: normal, multiply, screen, overlay, soft_light and other profess