o-l-l-i/ComfyUI-Olm-ImageAdjust
GitHub: o-l-l-i/ComfyUI-Olm-ImageAdjust
Olm ImageAdjust 是ComfyUI中的交互式图像调整节点,提供实时预览和色彩控制,简化AI图像后期处理。
Stars: 46 | Forks: 3
# Olm 图像调整用于 ComfyUI

ComfyUI 的一个交互式图像调整节点,具有易用的图形界面和实时预览功能。
- **作者:** Olli Sorjonen
- **GitHub:** https://github.com/o-l-l-i
- **X:** https://x.com/Olmirad
- **版本:** 1.0.1.1 (链式处理原始鼠标事件处理器,以在 ComfyUI 前端 1.24.4 及更高版本中保持子图标题按钮功能。)
## ✨ 这是什么?
**Olm Image Adjust** 是一个为 ComfyUI 设计的、小巧、独立且响应迅速的图像调整节点。
它包含一个实时预览功能,允许您在不重新运行整个图的情况下查看更改。
可用于:
- 色彩分级与风格化
- 微调曝光、对比度和伽马值
- 在放大、遮罩或合成前进行快速调整
- 预览微小调整如何影响图像的视觉效果
- 创意用途
## 🎯 为什么使用它?
- 🧩 **独立且专注**
- 不属于臃肿的节点包。
- ⚡ **轻量无冗余**
- 仅使用核心 Python 库:`Pillow`、`NumPy` 和 `Torch`。
- 无额外依赖、隐藏权重、模型、服务器或纠缠不清的依赖关系。
- 🧘 **稳定且简洁的用户体验**
- 设计追求简洁与响应性。
## 🎨 功能
### 🎛️ 实时预览
无需重新运行图——只需调整滑块,即可在 UI 中即时查看变化。
### 🌈 全面的控制
包含 11 个精细调整参数,用于调整图像色调、亮度和色彩平衡:
| 参数 | 描述 |
|----------------|----------------------------------------------------------------------|
| **曝光** | 调整整体光照强度,模拟相机曝光。 |
| **亮度** | 线性地使图像变亮或变暗。 |
| **对比度** | 增强或减弱明暗区域的差异。 |
| **伽马** | 对中间调进行非线性调整;非常适合柔化阴影。 |
| **阴影** | 提亮或加深最暗的区域。 |
| **中间调** | 提升或降低中等亮度范围。 |
| **高光** | 调整最亮的部分而不影响阴影。 |
| **色相** | 沿色轮旋转图像中的所有颜色。 |
| **饱和度** | 控制颜色的强度。 |
| **明度** | 均匀缩放 HSV 的“明度”通道。 |
| **鲜艳度** | 智能饱和度提升——增强不鲜艳的颜色,同时避免过度饱和原本已鲜艳的颜色。 |
### 🖼️ 集成图像预览
节点中的缩略图会显示更新后的图像,让您立即看到正在处理的效果。
### 💡 响应式 UI
- 即时反馈使您无需回溯或猜测即可轻松调出完美效果。
- 预览图像响应式缩放。
- 滑块也会相应缩放,因此您可以放大节点进行更精细的调整。
## 📦 安装
将此仓库克隆到您的 `custom_nodes` 文件夹中。
```
git clone https://github.com/o-l-l-i/ComfyUI-Olm-ImageAdjust.git
```
您的文件夹结构应如下所示:
```
ComfyUI/
└── custom_nodes/
└── ComfyUI-Olm-ImageAdjust/
├── __init__.py
├── olm_imageadjust.py
└── ... (other files)
```
重启 ComfyUI 以加载新节点。
✅ 无需额外依赖。
## 🧪 基本用法
1. 使用 Load Image 节点加载图像。
2. 将其连接到 Olm Image Adjust 节点。
3. 运行图,在节点中生成预览图像。
4. 调整节点界面中的滑块以修改:曝光、亮度、对比度等。
5. 在节点内的实时预览中查看变化。
6. 输出可用作任何接受图像的下游节点的输入。
7. 使用调整后的图像继续您的工作流程(例如,合成、用图像提示、放大等)。
## ⚠️ 已知限制
- 实时预览仅在图最初运行后更新;之后调整是即时的,但预览仅在内部刷新,直到触发另一次执行(例如,如果您更改了图像,请重新运行图)。
- 鲜艳度是我自己的诠释,在边缘情况下可能产生不一致的结果。
- 最适用于未压缩的 RGB 图像(在图像处理中一直如此)。
- 性能可能因 CPU/GPU、图像大小和您的 ComfyUI 安装而异。
## 💬 注意事项
此扩展是实验性的,并在积极开发中。
功能、文件和行为可能在不通知的情况下更改,并且不保证与未来更新的兼容性。使用风险自负,尤其是在工作流程中。
请经常备份您的项目。欢迎反馈、错误报告和建议——但请注意可能会出现中断、怪癖和粗糙之处。
此工具目前满足我的需求;未来的更新可能不规律,取决于可用时间。
## 版本历史
- **1.0.1.1** 链式处理原始鼠标事件处理器,以在 ComfyUI 前端 1.24.4 及更高版本中保持子图标题按钮功能。
- **1.0.1** 预览更新。
- **1.0** 初始发布。
## 许可与使用条款
版权所有 (c) 2025 Olli Sorjonen
此项目是源码可用的,但不是根据标准开源许可证的开源软件,也不是免费软件。
您可以自由地使用和试验它,并且您用它创建的任何结果都可以由您自由使用。
但是:
未经明确书面许可,严禁再分发、转售、重新品牌化或声称对此代码或扩展的作者身份。
使用风险自负。不提供任何保证或担保。
此项目的唯一官方仓库是:👉 https://github.com/o-l-l-i/ComfyUI-Olm-ImageAdjust
## 作者
由 [@o-l-l-i](https://github.com/o-l-l-i) 创建
标签:AI图像生成, ComfyUI, Gamma调整, LangChain, NumPy, Pillow, Python, PyTorch, SEO优化, 中间调调整, 亮度调整, 凭据扫描, 创意工具, 图像处理, 图像调整, 图形界面, 实时预览, 对比度调整, 工作流工具, 技术栈, 数字图像处理, 无后门, 曝光调整, 独立节点, 用户界面设计, 编辑工具, 自定义脚本, 色彩平衡, 节点, 轻量级, 逆向工具, 阴影调整, 颜色分级, 风格化, 高光调整