%20(1).png)
Basix Image Filters 插件完整使用教程
1. 插件简介
插件原地址： https://github.com/maludwig/basix_image_filters
这个插件就像是给ComfyUI装了一个专业的图片调色工具箱，里面有各种各样的"滤镜"。想象一下，你有一张照片，但是颜色不太对劲——要么太暗了，要么太亮了，要么颜色不够鲜艳，这个插件就能帮你调整。
它能带来什么效果？
- 让图片变暗或变亮（就像调节手机屏幕亮度一样）
- 让颜色更鲜艳或更暗淡（就像Instagram的滤镜效果）
- 改变图片的整体色调（比如把红色变成蓝色）
- 精确控制图片的明暗对比度（就像调节电视机的对比度）
最棒的是，每个节点都支持蒙版功能，这意味着你可以只修改图片的某个部分，而不影响其他地方。
2. 如何安装
方法一：通过ComfyUI Manager安装（推荐）
- 打开ComfyUI Manager
- 点击"Install Custom Nodes"
- 搜索"basix_image_filters"
- 点击Install按钮
- 重启ComfyUI
方法二：手动安装
- 找到你的ComfyUI安装目录
- 进入custom_nodes文件夹
- 打开命令行/终端
- 输入：
git clone https://github.com/maludwig/basix_image_filters.git - 重启ComfyUI
3. 节点逐一解析
3.1 HSL Darken 节点 - 让图片变暗
这个节点就像是给图片戴上了一副墨镜，让整张图片变得更暗。它会保持原来的色彩，只是把明度降低。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image | image | 图片输入 | - | 就是你要处理的那张图片 | 输入的图像数据 | 把任何图片连接到这里 |
| mask | mask | 蒙版（可选） | - | 就像用模板纸遮住某些部分，只处理没遮住的地方 | 控制处理区域的遮罩 | 如果只想让天空变暗，就画个天空的蒙版 |
| factor | factor | 0.0-1.0 | 0.3-0.7 | 这个数字越大，图片变得越暗 | 控制变暗程度的系数 | 0.5的话，白色会变成50%的灰色 |
| masked_area | masked_area | modify_masked/modify_unmasked | modify_masked | 决定是处理蒙版里面还是外面的部分 | 控制蒙版作用方式 | 如果选modify_masked，只处理蒙版圈出的地方 |
3.2 HSL Lighten 节点 - 让图片变亮
这个节点就像是给房间开了一盏灯，让整张图片变得更亮。和变暗节点正好相反。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image | image | 图片输入 | - | 就是你要处理的那张图片 | 输入的图像数据 | 把任何图片连接到这里 |
| mask | mask | 蒙版（可选） | - | 就像用模板纸遮住某些部分，只处理没遮住的地方 | 控制处理区域的遮罩 | 如果只想让阴影部分变亮，就画个阴影的蒙版 |
| factor | factor | 0.0-1.0 | 0.3-0.7 | 这个数字越大，图片变得越亮 | 控制变亮程度的系数 | 0.5的话，黑色会变成50%的灰色 |
| masked_area | masked_area | modify_masked/modify_unmasked | modify_masked | 决定是处理蒙版里面还是外面的部分 | 控制蒙版作用方式 | 如果选modify_unmasked，只处理蒙版外面的地方 |
3.3 HSL Saturate 节点 - 让颜色更鲜艳
这个节点就像是给图片涂上了更浓的彩色笔，让所有颜色都更加鲜艳夺目。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image | image | 图片输入 | - | 就是你要处理的那张图片 | 输入的图像数据 | 把任何图片连接到这里 |
| mask | mask | 蒙版（可选） | - | 就像用模板纸遮住某些部分，只处理没遮住的地方 | 控制处理区域的遮罩 | 如果只想让花朵颜色更鲜艳，就画个花朵的蒙版 |
| factor | factor | 0.0-2.0 | 0.2-0.8 | 数字越大，颜色越鲜艳；负数会让颜色变淡 | 控制饱和度的系数 | 1.0会让颜色完全饱和，0.0不变，负数会去色 |
| masked_area | masked_area | modify_masked/modify_unmasked | modify_masked | 决定是处理蒙版里面还是外面的部分 | 控制蒙版作用方式 | 可以只让背景颜色更鲜艳，不影响人物 |
3.4 HSL Desaturate 节点 - 让颜色变淡
这个节点就像是给图片洒了一层灰尘，让所有颜色都变得暗淡，最终可以变成黑白照片。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image | image | 图片输入 | - | 就是你要处理的那张图片 | 输入的图像数据 | 把任何图片连接到这里 |
| mask | mask | 蒙版（可选） | - | 就像用模板纸遮住某些部分，只处理没遮住的地方 | 控制处理区域的遮罩 | 如果想让背景变成黑白，只画背景的蒙版 |
| factor | factor | 0.0-1.0 | 0.3-0.7 | 数字越大，颜色越淡；1.0会变成完全的黑白 | 控制去饱和度的系数 | 0.5会让颜色变成一半的鲜艳度 |
| masked_area | masked_area | modify_masked/modify_unmasked | modify_masked | 决定是处理蒙版里面还是外面的部分 | 控制蒙版作用方式 | 可以让人物保持彩色，背景变成黑白 |
3.5 HSL Rotate Hue 节点 - 改变颜色
这个节点就像是给图片换了一个彩色滤镜，可以把红色变成蓝色，绿色变成紫色等等。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image | image | 图片输入 | - | 就是你要处理的那张图片 | 输入的图像数据 | 把任何图片连接到这里 |
| mask | mask | 蒙版（可选） | - | 就像用模板纸遮住某些部分，只处理没遮住的地方 | 控制处理区域的遮罩 | 如果只想改变衣服颜色，就画个衣服的蒙版 |
| degrees | degrees | -180到180 | 30, 60, 120 | 就像转动彩色转盘，180度会变成完全相反的颜色 | 色相旋转的角度 | 120度可以把红色变成绿色，240度把红色变成蓝色 |
| masked_area | masked_area | modify_masked/modify_unmasked | modify_masked | 决定是处理蒙版里面还是外面的部分 | 控制蒙版作用方式 | 可以只改变衣服颜色，不影响肤色 |
3.6 HSL Levels 节点 - 精确控制明暗对比
这个节点就像是一个高级的明暗调节器，可以分别控制最暗的地方、中间的地方和最亮的地方。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image | image | 图片输入 | - | 就是你要处理的那张图片 | 输入的图像数据 | 把任何图片连接到这里 |
| mask | mask | 蒙版（可选） | - | 就像用模板纸遮住某些部分，只处理没遮住的地方 | 控制处理区域的遮罩 | 可以只调整天空的对比度 |
| shadows | shadows | 0.0-1.0 | 0.1-0.3 | 控制最暗的地方，数值越高，暗的地方越少 | 阴影裁剪点 | 0.2的话，比20%暗的地方都会变成纯黑 |
| midtones | midtones | 0.0-100.0 | 0.5-2.0 | 控制中间亮度，大于1变暗，小于1变亮 | 中间调伽马校正 | 2.0会让图片整体变暗，0.5会让图片整体变亮 |
| highlights | highlights | 0.0-1.0 | 0.7-0.9 | 控制最亮的地方，数值越低，亮的地方越少 | 高光裁剪点 | 0.8的话，比80%亮的地方都会变成纯白 |
| masked_area | masked_area | modify_masked/modify_unmasked | modify_masked | 决定是处理蒙版里面还是外面的部分 | 控制蒙版作用方式 | 可以只调整人物的对比度，不影响背景 |
3.7 HSL Color Levels 节点 - 分颜色调节
这个节点就像是有三个独立的调色器，可以分别调节红色、绿色、蓝色的强度。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image | image | 图片输入 | - | 就是你要处理的那张图片 | 输入的图像数据 | 把任何图片连接到这里 |
| mask | mask | 蒙版（可选） | - | 就像用模板纸遮住某些部分，只处理没遮住的地方 | 控制处理区域的遮罩 | 可以只调整某个区域的颜色平衡 |
| channel | channel | red/green/blue/all | all | 选择要调节哪个颜色通道 | 颜色通道选择 | 选red只调红色，选all调所有颜色 |
| shadows | shadows | 0.0-1.0 | 0.1-0.3 | 控制选中颜色的暗部 | 该颜色通道的阴影裁剪点 | 在红色通道设0.2，红色暗部会被裁剪 |
| midtones | midtones | 0.0-100.0 | 0.5-2.0 | 控制选中颜色的中间调 | 该颜色通道的中间调伽马 | 在绿色通道设0.5，绿色会变得更亮 |
| highlights | highlights | 0.0-1.0 | 0.7-0.9 | 控制选中颜色的亮部 | 该颜色通道的高光裁剪点 | 在蓝色通道设0.8，蓝色亮部会被裁剪 |
| masked_area | masked_area | modify_masked/modify_unmasked | modify_masked | 决定是处理蒙版里面还是外面的部分 | 控制蒙版作用方式 | 可以只调整天空的蓝色，不影响其他地方 |
3.8 HSV Darken 节点 - HSV方式变暗
这个节点和HSL Darken类似，但是它在变暗的时候会更好地保持颜色的鲜艳度。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image | image | 图片输入 | - | 就是你要处理的那张图片 | 输入的图像数据 | 把任何图片连接到这里 |
| mask | mask | 蒙版（可选） | - | 就像用模板纸遮住某些部分，只处理没遮住的地方 | 控制处理区域的遮罩 | 如果只想让某个物体变暗但保持颜色鲜艳 |
| factor | factor | 0.0-1.0 | 0.3-0.7 | 这个数字越大，图片变得越暗，但颜色保持鲜艳 | 控制HSV明度降低的系数 | 0.5会让图片变暗50%，但颜色依然鲜艳 |
| masked_area | masked_area | modify_masked/modify_unmasked | modify_masked | 决定是处理蒙版里面还是外面的部分 | 控制蒙版作用方式 | 可以让背景变暗但保持颜色鲜艳 |
3.9 HSV Brighten 节点 - HSV方式变亮
这个节点让图片变亮，但是会让颜色变得更加鲜艳明亮，而不是发白。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image | image | 图片输入 | - | 就是你要处理的那张图片 | 输入的图像数据 | 把任何图片连接到这里 |
| mask | mask | 蒙版（可选） | - | 就像用模板纸遮住某些部分，只处理没遮住的地方 | 控制处理区域的遮罩 | 如果只想让某个区域变亮但保持颜色鲜艳 |
| factor | factor | 0.0-1.0 | 0.3-0.7 | 这个数字越大，图片变得越亮，颜色越鲜艳 | 控制HSV明度提高的系数 | 0.5会让图片变亮50%，颜色更鲜艳 |
| masked_area | masked_area | modify_masked/modify_unmasked | modify_masked | 决定是处理蒙版里面还是外面的部分 | 控制蒙版作用方式 | 可以让人物变亮但颜色更鲜艳 |
3.10 HSV Saturate 节点 - HSV方式增加饱和度
这个节点让颜色更加鲜艳，效果和HSL Saturate基本相同。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image | image | 图片输入 | - | 就是你要处理的那张图片 | 输入的图像数据 | 把任何图片连接到这里 |
| mask | mask | 蒙版（可选） | - | 就像用模板纸遮住某些部分，只处理没遮住的地方 | 控制处理区域的遮罩 | 如果只想让花朵颜色更鲜艳 |
| factor | factor | 0.0-2.0 | 0.2-0.8 | 数字越大，颜色越鲜艳；负数会让颜色变淡 | 控制HSV饱和度的系数 | 1.0会让颜色完全饱和，效果很强烈 |
| masked_area | masked_area | modify_masked/modify_unmasked | modify_masked | 决定是处理蒙版里面还是外面的部分 | 控制蒙版作用方式 | 可以只让背景颜色更鲜艳 |
3.11 HSV Desaturate 节点 - HSV方式降低饱和度
这个节点让颜色变淡，效果和HSL Desaturate基本相同。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image | image | 图片输入 | - | 就是你要处理的那张图片 | 输入的图像数据 | 把任何图片连接到这里 |
| mask | mask | 蒙版（可选） | - | 就像用模板纸遮住某些部分，只处理没遮住的地方 | 控制处理区域的遮罩 | 如果想让背景变成黑白效果 |
| factor | factor | 0.0-1.0 | 0.3-0.7 | 数字越大，颜色越淡；1.0会变成完全的黑白 | 控制HSV去饱和度的系数 | 0.5会让颜色变成一半的鲜艳度 |
| masked_area | masked_area | modify_masked/modify_unmasked | modify_masked | 决定是处理蒙版里面还是外面的部分 | 控制蒙版作用方式 | 可以让人物保持彩色，背景变黑白 |
3.12 HSV Rotate Hue 节点 - HSV方式旋转色相
这个节点改变颜色，效果和HSL Rotate Hue基本相同。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image | image | 图片输入 | - | 就是你要处理的那张图片 | 输入的图像数据 | 把任何图片连接到这里 |
| mask | mask | 蒙版（可选） | - | 就像用模板纸遮住某些部分，只处理没遮住的地方 | 控制处理区域的遮罩 | 如果只想改变某个物体的颜色 |
| degrees | degrees | -180到180 | 30, 60, 120 | 就像转动彩色转盘，180度会变成完全相反的颜色 | HSV色相旋转的角度 | 120度可以把红色变成绿色 |
| masked_area | masked_area | modify_masked/modify_unmasked | modify_masked | 决定是处理蒙版里面还是外面的部分 | 控制蒙版作用方式 | 可以只改变衣服颜色，不影响肤色 |
3.13 HSV Levels 节点 - HSV方式调节层次
这个节点用HSV方式精确控制明暗对比，在保持颜色鲜艳度方面更好。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image | image | 图片输入 | - | 就是你要处理的那张图片 | 输入的图像数据 | 把任何图片连接到这里 |
| mask | mask | 蒙版（可选） | - | 就像用模板纸遮住某些部分，只处理没遮住的地方 | 控制处理区域的遮罩 | 可以只调整某个区域的对比度 |
| shadows | shadows | 0.0-1.0 | 0.1-0.3 | 控制最暗的地方，数值越高，暗的地方越少 | HSV阴影裁剪点 | 0.2的话，比20%暗的地方都会变成纯黑 |
| midtones | midtones | 0.0-100.0 | 0.5-2.0 | 控制中间亮度，大于1变暗，小于1变亮 | HSV中间调伽马校正 | 2.0会让图片整体变暗但保持颜色鲜艳 |
| highlights | highlights | 0.0-1.0 | 0.7-0.9 | 控制最亮的地方，数值越低，亮的地方越少 | HSV高光裁剪点 | 0.8的话，比80%亮的地方都会变成纯白 |
| masked_area | masked_area | modify_masked/modify_unmasked | modify_masked | 决定是处理蒙版里面还是外面的部分 | 控制蒙版作用方式 | 可以只调整天空的对比度，保持颜色鲜艳 |
4. 使用技巧和建议
4.1 HSL vs HSV 怎么选择？
- HSL系列节点：适合做"自然"的调色，变亮的时候会趋向白色，变暗的时候会趋向黑色
- HSV系列节点：适合做"鲜艳"的调色，变亮的时候颜色会更加鲜艳，变暗的时候颜色依然保持鲜艳
4.2 参数调节小窍门
- factor参数：建议从小的数值开始调（比如0.1-0.3），看效果后再逐渐增加
- degrees参数：常用的角度有30°（微调），60°（明显变化），120°（色相互补），180°（完全相反）
- levels参数：shadows建议0.1-0.3，highlights建议0.7-0.9，midtones建议0.5-2.0
4.3 蒙版使用技巧
-
制作蒙版的步骤：
- 右键点击预览图像节点 → Copy (Clipspace)
- 创建Load Image节点 → 右键 → Paste (Clipspace)
- 右键点击 → "Open in MaskEditor"
-
蒙版编辑快捷键：
- Windows：Shift+拖拽 = 缩放，Ctrl+拖拽 = 移动
- 白色区域 = 要处理的地方，黑色区域 = 不处理的地方
4.4 实用组合推荐
- 打造电影感：HSL Darken (0.3) + HSL Desaturate (0.2) + HSL Levels
- 增强色彩：HSV Saturate (0.5) + HSV Brighten (0.2)
- 复古色调：HSL Rotate Hue (30°) + HSL Lighten (0.1) + HSL Desaturate (0.1)