ComfyUI-Light-Tool 插件超详细保姆级图文教程
1. 插件简介
ComfyUI-Light-Tool 是一个超级实用的图片处理工具包插件(GitHub地址:https://github.com/ihmily/ComfyUI-Light-Tool),就像是给你的 ComfyUI 装了一个万能工具箱。这个插件包含了大量轻量实用的节点,能让你的图片处理工作变得更简单、更高效。
这个插件能给我们带来什么效果?
- 像打开相册一样轻松加载各种图片(包括透明图片)
- 像拼积木一样把多张图片合并在一起
- 像魔法一样给图片换背景、调尺寸
- 像变戏法一样处理视频文件
- 像发朋友圈一样把图片上传到云端存储
总的来说,这就是一个让图片处理变得超级简单的"万能助手"!
2. 如何安装
方法一:通过 ComfyUI Manager 安装(推荐)
- 打开 ComfyUI 界面
- 点击右侧的 Manager 按钮
- 在 Custom Nodes 标签下搜索 "ComfyUI-Light-Tool"
- 点击 Install 按钮
- 重启 ComfyUI
方法二:手动安装
- 进入 ComfyUI 的 custom_nodes 文件夹
- 打开命令行(就像打开聊天框一样)
- 输入:
git clone https://github.com/ihmily/ComfyUI-Light-Tool.git - 重启 ComfyUI
3. 节点逐一解析
3.1 Load Image 节点 - 加载本地图片的万能工具
这个节点就像是一个"图片开门器",能够打开你电脑里的图片文件,特别厉害的是它还能保留透明背景(RGBA通道)。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 图片路径 | image_path | 文件路径字符串 | 选择你要的图片 | 就像告诉电脑"去哪里找图片" | 指定要加载的图像文件的完整路径 | 点击浏览按钮,选择桌面上的照片.png |
| 保持透明度 | keep_alpha | True/False | True | 决定要不要保留图片的透明背景 | 是否保留RGBA通道信息 | 如果你的PNG图片有透明背景,选True就能保留 |
3.2 Load Image From URL 节点 - 网络图片下载器
这个节点就像是一个"网络图片搬运工",能直接从网址下载图片到你的工作流里。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 图片网址 | image_url | URL字符串 | 完整的图片链接 | 就像告诉电脑"去这个网址抓图片" | 指定要下载的图像文件URL地址 | 复制图片链接,比如 https://example.com/photo.jpg |
| 超时时间 | timeout | 数字(秒) | 30 | 等待下载的最长时间,像设置耐心值 | 网络请求的超时限制 | 网速慢时可以设大一点,比如60秒 |
3.3 Load Image List 节点 - 批量图片加载器
这个节点就像是一个"图片收集器",能一次性把一个文件夹里的所有图片都加载进来。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 文件夹路径 | folder_path | 文件夹路径 | 包含图片的文件夹 | 告诉电脑去哪个文件夹找图片 | 指定包含图像文件的目录路径 | 选择桌面上的"我的照片"文件夹 |
| 文件类型 | file_extensions | 列表 | ['.jpg', '.png', '.jpeg'] | 要收集哪些类型的图片文件 | 支持的图像文件扩展名列表 | 默认就好,会找常见的图片格式 |
| 排序方式 | sort_method | 字符串 | "name" | 按什么顺序排列图片 | 文件排序的方法 | "name"按名字,"date"按时间 |
3.4 Image Overlay 节点 - 精确图片合并器
这个节点就像是一个"图片三明治制作器",能把两张图片精确地叠加在一起。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 底层图片 | base_image | IMAGE | 从上个节点来 | 作为背景的图片,像三明治的底层面包 | 作为背景的基础图像 | 连接一个风景照片作为背景 |
| 覆盖图片 | overlay_image | IMAGE | 从上个节点来 | 要叠加上去的图片,像三明治的菜 | 要叠加的前景图像 | 连接一个人物图片放在风景上 |
| 蒙版 | mask | MASK | 从上个节点来 | 决定哪些地方要合并,像模板 | 控制图像合成区域的遮罩 | 用一个人物形状的蒙版来精确合成 |
3.5 Simple Image Overlay 节点 - 自由图片叠加器
这个节点就像是一个"图片贴纸工具",能把一张图片随意贴到另一张图片的任何位置。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 底层图片 | base_image | IMAGE | 从上个节点来 | 作为背景的图片 | 作为背景的基础图像 | 连接一张海报图片 |
| 覆盖图片 | overlay_image | IMAGE | 从上个节点来 | 要贴上去的图片 | 要叠加的前景图像 | 连接一个Logo图片 |
| X坐标 | x_position | 整数 | 0 | 贴纸在水平方向的位置,像左右移动 | 水平方向的像素偏移量 | 100表示向右移动100个像素 |
| Y坐标 | y_position | 整数 | 0 | 贴纸在垂直方向的位置,像上下移动 | 垂直方向的像素偏移量 | 50表示向下移动50个像素 |
| 透明度 | opacity | 0.0-1.0 | 1.0 | 贴纸的透明程度,1是完全不透明 | 图像的不透明度值 | 0.5表示半透明效果 |
3.6 Image Concat 节点 - 图片拼接器
这个节点就像是一个"图片拼图工具",能把多张图片水平或垂直地拼接成一张大图。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 图片列表 | images | IMAGE | 从上个节点来 | 要拼接的所有图片 | 输入的图像序列 | 连接多张风景照片 |
| 拼接方向 | direction | "horizontal"/"vertical" | "horizontal" | 是左右拼还是上下拼 | 图像拼接的方向 | "horizontal"横着拼,"vertical"竖着拼 |
| 对齐方式 | alignment | "center"/"start"/"end" | "center" | 图片怎么对齐,像文字的左对齐右对齐 | 图像在非拼接方向上的对齐方式 | "center"居中,"start"靠上/左,"end"靠下/右 |
3.7 Resize Image 节点 - 图片尺寸调整器
这个节点就像是一个"图片大小调节器",能把图片变大变小,还能保持比例不变形。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | image | IMAGE | 从上个节点来 | 要调整大小的图片 | 输入的图像数据 | 连接一张照片 |
| 目标宽度 | width | 整数 | 512 | 调整后的图片宽度,像屏幕宽度 | 目标图像的像素宽度 | 1024表示调整到1024像素宽 |
| 目标高度 | height | 整数 | 512 | 调整后的图片高度,像屏幕高度 | 目标图像的像素高度 | 1024表示调整到1024像素高 |
| 缩放方法 | method | "lanczos"/"nearest"等 | "lanczos" | 调整大小时用什么算法,影响清晰度 | 图像重采样的算法 | "lanczos"质量最好但速度慢 |
3.8 Resize Image V2 节点 - 高级图片尺寸调整器
这个节点是上一个的升级版,就像是"智能图片缩放器",提供更多精细控制选项。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | image | IMAGE | 从上个节点来 | 要调整大小的图片 | 输入的图像数据 | 连接一张照片 |
| 缩放模式 | resize_mode | "stretch"/"crop"/"pad" | "stretch" | 怎么处理长宽比不匹配的情况 | 图像缩放的模式 | "stretch"拉伸,"crop"裁剪,"pad"填充 |
| 保持比例 | keep_proportion | True/False | True | 要不要保持图片的长宽比例 | 是否维持原始图像的宽高比 | True避免图片变形 |
| 目标宽度 | target_width | 整数 | 512 | 想要的最终宽度 | 目标图像的像素宽度 | 设为1024得到1024像素宽的图 |
| 目标高度 | target_height | 整数 | 512 | 想要的最终高度 | 目标图像的像素高度 | 设为1024得到1024像素高的图 |
3.9 Resize by Ratio/Max Size 节点 - 按比例/最大尺寸调整器
这个节点就像是一个"智能缩放助手",能按百分比缩放或限制最大尺寸。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | image | IMAGE | 从上个节点来 | 要调整的图片 | 输入的图像数据 | 连接一张照片 |
| 缩放比例 | scale_ratio | 浮点数 | 1.0 | 放大或缩小的倍数,像音量调节 | 图像缩放的倍率 | 2.0表示放大2倍,0.5表示缩小一半 |
| 最大宽度 | max_width | 整数 | 1024 | 图片宽度的上限,像限速标志 | 允许的最大像素宽度 | 1920表示最宽不超过1920像素 |
| 最大高度 | max_height | 整数 | 1024 | 图片高度的上限 | 允许的最大像素高度 | 1080表示最高不超过1080像素 |
3.10 Scale Image 节点 - 图片缩放器
这个节点就像是一个"图片放大镜/缩小镜",专门用算法来改变图片大小。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | image | IMAGE | 从上个节点来 | 要缩放的图片 | 输入的图像数据 | 连接一张照片 |
| 缩放算法 | upscale_method | "nearest"/"linear"等 | "linear" | 用什么方法来缩放,影响效果 | 图像缩放使用的插值算法 | "linear"平滑,"nearest"像素化 |
| 缩放倍数 | scale_by | 浮点数 | 2.0 | 放大或缩小多少倍 | 图像缩放的倍率系数 | 2.0放大两倍,0.5缩小一半 |
3.11 Upscale Image 节点 - 图片超分辨率放大器
这个节点就像是一个"图片高清化神器",能用AI算法把小图变成高清大图。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | image | IMAGE | 从上个节点来 | 要放大的图片 | 输入的图像数据 | 连接一张小尺寸照片 |
| 放大模型 | upscale_model | MODEL | 从模型加载节点来 | 用哪个AI模型来放大图片 | 超分辨率重建模型 | 选择Real-ESRGAN等放大模型 |
| 放大倍数 | scale_factor | 整数 | 4 | 要放大几倍 | 图像放大的倍率 | 4表示放大4倍,2x2变8x8 |
3.12 Add Solid Color Background 节点 - 纯色背景添加器
这个节点就像是一个"背景换色器",能给透明图片添加任何颜色的背景。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | image | IMAGE | 从上个节点来 | 有透明背景的图片 | 输入的图像数据 | 连接一个PNG透明图片 |
| 背景颜色 | color | RGB颜色值 | (255,255,255) | 要添加的背景颜色 | RGB格式的颜色值 | (255,0,0)红色,(0,255,0)绿色 |
| 背景透明度 | alpha | 0.0-1.0 | 1.0 | 背景的透明程度 | 背景的不透明度值 | 1.0完全不透明,0.5半透明 |
3.13 Image to Mask 节点 - 图片转蒙版工具
这个节点就像是一个"图片变模板器",能把图片转换成黑白蒙版。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | image | IMAGE | 从上个节点来 | 要转换成蒙版的图片 | 输入的图像数据 | 连接一张图片 |
| 通道选择 | channel | "red"/"green"/"blue"/"alpha" | "alpha" | 用图片的哪个颜色通道来做蒙版 | 选择用于生成蒙版的颜色通道 | "alpha"用透明通道,"red"用红色通道 |
3.14 Mask to Image 节点 - 蒙版转图片工具
这个节点就像是一个"模板变图片器",能把黑白蒙版转换成可见的图片。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入蒙版 | mask | MASK | 从上个节点来 | 要转换的蒙版 | 输入的蒙版数据 | 连接一个蒙版 |
| 输出格式 | format | "RGB"/"RGBA" | "RGB" | 转换成什么格式的图片 | 输出图像的颜色格式 | "RGB"普通图片,"RGBA"带透明通道 |
3.15 Invert Mask 节点 - 蒙版反转器
这个节点就像是一个"黑白颠倒器",能把蒙版的黑白区域完全颠倒。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入蒙版 | mask | MASK | 从上个节点来 | 要反转的蒙版 | 输入的蒙版数据 | 连接一个蒙版 |
3.16 Bounding Box Cropping 节点 - 边界框裁剪器
这个节点就像是一个"精确裁纸刀",能根据指定的坐标精确裁剪图片。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | image | IMAGE | 从上个节点来 | 要裁剪的图片 | 输入的图像数据 | 连接一张照片 |
| 左上角X | x | 整数 | 0 | 裁剪区域左上角的水平位置 | 裁剪区域的左边界坐标 | 100表示从左边第100个像素开始 |
| 左上角Y | y | 整数 | 0 | 裁剪区域左上角的垂直位置 | 裁剪区域的上边界坐标 | 50表示从上边第50个像素开始 |
| 宽度 | width | 整数 | 512 | 裁剪区域的宽度 | 裁剪区域的像素宽度 | 512表示裁剪512像素宽的区域 |
| 高度 | height | 整数 | 512 | 裁剪区域的高度 | 裁剪区域的像素高度 | 512表示裁剪512像素高的区域 |
3.17 RGB to RGBA 节点 - 颜色通道转换器(RGB转RGBA)
这个节点就像是一个"图片透明度添加器",能给普通图片添加透明通道。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | image | IMAGE | 从上个节点来 | 要添加透明通道的RGB图片 | 输入的RGB格式图像 | 连接一张JPG图片 |
| 透明度值 | alpha_value | 0.0-1.0 | 1.0 | 添加的透明度大小 | 新增透明通道的不透明度值 | 1.0完全不透明,0.5半透明 |
3.18 RGBA to RGB 节点 - 颜色通道转换器(RGBA转RGB)
这个节点就像是一个"透明度移除器",能把带透明通道的图片转换成普通图片。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | image | IMAGE | 从上个节点来 | 要移除透明通道的RGBA图片 | 输入的RGBA格式图像 | 连接一张PNG透明图片 |
| 背景颜色 | background_color | RGB颜色值 | (255,255,255) | 透明部分用什么颜色填充 | 用于填充透明区域的背景色 | (255,255,255)白色背景 |
3.19 Morphological Transform 节点 - 形态学变换器
这个节点就像是一个"蒙版美容师",能对蒙版进行腐蚀、膨胀等处理来改善效果。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入蒙版 | mask | MASK | 从上个节点来 | 要处理的蒙版 | 输入的蒙版数据 | 连接一个蒙版 |
| 操作类型 | operation | "erode"/"dilate"/"open"/"close" | "dilate" | 要进行什么操作 | 形态学变换的操作类型 | "erode"腐蚀缩小,"dilate"膨胀扩大 |
| 内核大小 | kernel_size | 整数 | 3 | 处理的强度大小,像画笔粗细 | 形态学操作核的大小 | 3表示轻微处理,7表示强烈处理 |
| 迭代次数 | iterations | 整数 | 1 | 重复处理多少次 | 形态学操作的重复次数 | 1次轻微,3次明显 |
3.20 Extract Transparent Image 节点 - 透明前景提取器
这个节点就像是一个"抠图神器",能用蒙版从原图中提取前景并保持透明背景。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 原图 | image | IMAGE | 从上个节点来 | 要抠图的原始图片 | 输入的原始图像数据 | 连接一张人物照片 |
| 蒙版 | mask | MASK | 从上个节点来 | 用来抠图的蒙版 | 用于提取前景的蒙版 | 连接一个人物形状的蒙版 |
3.21 Mask Background to Transparent 节点 - 背景透明化工具
这个节点就像是一个"背景擦除器",能把蒙版指定的背景部分变成透明。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | image | IMAGE | 从上个节点来 | 要处理的图片 | 输入的图像数据 | 连接一张图片 |
| 蒙版 | mask | MASK | 从上个节点来 | 指定哪些区域要变透明 | 用于指定透明区域的蒙版 | 连接一个背景蒙版 |
3.22 Input Text 节点 - 文本输入器
这个节点就像是一个"文字输入框",让你可以输入文字内容到工作流中。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 文本内容 | text | 字符串 | 空 | 你想输入的文字 | 输入的文本字符串 | 输入"美丽的风景"作为提示词 |
3.23 Input Text List 节点 - 文本列表输入器
这个节点就像是一个"文字清单制作器",能输入多行文字形成列表。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 文本列表 | text_list | 多行字符串 | 空 | 多行文字,每行一个内容 | 输入的文本列表 | 每行写一个提示词,比如"猫"、"狗"、"鸟" |
| 分隔符 | separator | 字符串 | "\n" | 用什么符号分隔不同的文字 | 列表项之间的分隔符 | "\n"按行分隔,","按逗号分隔 |
3.24 Connect Text Strings 节点 - 文本连接器
这个节点就像是一个"文字粘合剂",能把多个文字片段连接成一个完整的句子。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 文本1 | text1 | STRING | 从上个节点来 | 第一段文字 | 第一个输入文本 | "美丽的" |
| 文本2 | text2 | STRING | 从上个节点来 | 第二段文字 | 第二个输入文本 | "风景画" |
| 连接符 | connector | 字符串 | " " | 两段文字之间插入什么 | 文本之间的连接字符 | " "空格,","逗号,""无连接符 |
3.25 Simple Connect Text Strings 节点 - 简单文本连接器
这个节点是上一个的简化版,就像是一个"快速文字合并器"。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 文本列表 | texts | STRING列表 | 从上个节点来 | 要合并的多个文字片段 | 输入的文本字符串列表 | 连接多个提示词节点 |
| 分隔符 | separator | 字符串 | ", " | 文字之间用什么分隔 | 文本之间的分隔符 | ", "逗号空格," "空格 |
3.26 Show Text 节点 - 文本显示器
这个节点就像是一个"文字显示屏",能在界面上显示文字内容。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入文本 | text | STRING | 从上个节点来 | 要显示的文字内容 | 输入的文本数据 | 连接一个文本节点来显示内容 |
3.27 Load Video 节点 - 视频加载器
这个节点就像是一个"视频播放器",能从网址或本地路径加载视频文件。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 视频路径 | video_path | 字符串 | 空 | 视频文件的位置或网址 | 视频文件的路径或URL | 可以是本地路径或http链接 |
| 开始帧 | start_frame | 整数 | 0 | 从第几帧开始加载 | 视频开始读取的帧数 | 0从头开始,30从第30帧开始 |
| 帧数限制 | frame_limit | 整数 | -1 | 最多加载多少帧,-1表示全部 | 加载的最大帧数 | 100表示只加载100帧 |
3.28 Preview Video 节点 - 视频预览器
这个节点就像是一个"视频预览窗口",能在ComfyUI界面中预览视频内容。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 视频路径 | video_path | 字符串 | 空 | 要预览的视频文件位置 | 视频文件的路径或URL | 输入视频文件路径 |
| 预览质量 | quality | "low"/"medium"/"high" | "medium" | 预览的清晰度 | 视频预览的质量设置 | "high"最清晰但加载慢 |
3.29 Save Video 节点 - 视频保存器
这个节点就像是一个"视频存档器",能把处理后的视频保存到指定目录。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 视频数据 | video | VIDEO | 从上个节点来 | 要保存的视频数据 | 输入的视频数据 | 连接处理后的视频 |
| 保存路径 | save_path | 字符串 | "./output/" | 保存到哪个文件夹 | 视频文件的保存目录 | "./output/"保存到输出文件夹 |
| 文件名 | filename | 字符串 | "video" | 保存的文件名 | 输出视频的文件名 | "my_video"会保存为my_video.mp4 |
| 视频格式 | format | "mp4"/"avi"/"mov" | "mp4" | 保存成什么格式的视频 | 输出视频的文件格式 | "mp4"最通用,"mov"质量好 |
3.30 Get Image Size 节点 - 图片信息获取器
这个节点就像是一个"图片测量尺",能告诉你图片的尺寸和文件大小信息。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | image | IMAGE | 从上个节点来 | 要测量的图片 | 输入的图像数据 | 连接任何图片节点 |
3.31 Hex to RGB 节点 - 颜色格式转换器
这个节点就像是一个"颜色翻译器",能把网页常用的颜色代码转换成RGB数值。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 十六进制颜色 | hex_color | 字符串 | "#FFFFFF" | 网页格式的颜色代码 | 十六进制格式的颜色值 | "#FF0000"红色,"#00FF00"绿色 |
3.32 Calculate 节点 - 数值计算器
这个节点就像是一个"万能计算器",能进行各种数学运算。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 数值A | value_a | 浮点数 | 0.0 | 第一个数字 | 第一个操作数 | 输入10 |
| 运算符 | operation | "+"/"-"/"*"/"/"/"%" | "+" | 要做什么运算 | 数学运算操作符 | "+"加法,"-"减法,"*"乘法 |
| 数值B | value_b | 浮点数 | 0.0 | 第二个数字 | 第二个操作数 | 输入5 |
3.33 Convert Num Type 节点 - 数值类型转换器
这个节点就像是一个"数字格式转换器",能在整数、小数、文字之间转换。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入数值 | input_value | 数值 | 从上个节点来 | 要转换的数字 | 输入的数值数据 | 连接一个数字 |
| 目标类型 | target_type | "int"/"float"/"string" | "int" | 要转换成什么格式 | 目标数据类型 | "int"整数,"float"小数,"string"文字 |
3.34 Get Images Count 节点 - 图片数量统计器
这个节点就像是一个"图片计数器",能告诉你一批图片有多少张。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 图片列表 | images | IMAGE | 从上个节点来 | 要统计的图片集合 | 输入的图像批次数据 | 连接一个图片列表节点 |
3.35 KeyValue 节点 - JSON数据提取器
这个节点就像是一个"数据字典查询器",能从JSON格式的数据中提取特定信息。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| JSON数据 | json_data | 字符串 | 空 | 包含数据的JSON文本 | JSON格式的数据字符串 | '{"name":"张三","age":25}' |
| 键名 | key | 字符串 | 空 | 要查找的数据项名称 | JSON对象中的键名 | "name"获取姓名,"age"获取年龄 |
3.36 Serialize/Deserialize JSON 节点 - JSON序列化/反序列化器
这个节点就像是一个"数据格式转换器",能在普通数据和JSON格式之间转换。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入数据 | input_data | 任意格式 | 从上个节点来 | 要转换的数据 | 输入的数据 | 可以是对象也可以是JSON字符串 |
| 操作类型 | operation | "serialize"/"deserialize" | "serialize" | 是转成JSON还是从JSON转换 | 序列化操作的类型 | "serialize"转成JSON,"deserialize"从JSON转换 |
3.37 PhantomTankEffect 节点 - 幻影坦克效果生成器
这个节点就像是一个"隐藏图片魔术师",能制作那种在不同背景下显示不同图片的特效。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 白色背景图 | white_image | IMAGE | 从上个节点来 | 在白色背景下显示的图片 | 白色背景下可见的图像 | 连接一张风景图 |
| 黑色背景图 | black_image | IMAGE | 从上个节点来 | 在黑色背景下显示的图片 | 黑色背景下可见的图像 | 连接一张人物图 |
| 混合强度 | blend_strength | 0.0-1.0 | 0.5 | 效果的强弱程度 | 幻影坦克效果的混合强度 | 0.5中等效果,0.8强效果 |
3.38 Is Transparent 节点 - 透明度检测器
这个节点就像是一个"透明度探测器",能检查图片是否有透明部分。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | image | IMAGE | 从上个节点来 | 要检查的图片 | 输入的图像数据 | 连接一张PNG图片 |
3.39 Mask Bounding Box Cropping 节点 - 蒙版边界裁剪器
这个节点就像是一个"智能裁剪器",能根据蒙版的边界自动裁剪出最小的包含区域。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图片 | image | IMAGE | 从上个节点来 | 要裁剪的图片 | 输入的图像数据 | 连接一张图片 |
| 蒙版 | mask | MASK | 从上个节点来 | 用来确定裁剪边界的蒙版 | 用于确定裁剪区域的蒙版 | 连接一个蒙版 |
| 边距 | padding | 整数 | 0 | 在蒙版边界外额外保留多少像素 | 裁剪区域的边距像素 | 10表示边界外再保留10像素 |
3.40 Save to Aliyun OSS 节点 - 阿里云存储上传器
这个节点就像是一个"云端搬运工",能把图片或视频上传到阿里云存储服务。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 文件数据 | file_data | IMAGE/VIDEO | 从上个节点来 | 要上传的文件 | 输入的文件数据 | 连接图片或视频节点 |
| AccessKey ID | access_key_id | 字符串 | 空 | 阿里云账号的访问密钥ID | OSS访问凭证ID | 在阿里云控制台获取 |
| AccessKey Secret | access_key_secret | 字符串 | 空 | 阿里云账号的访问密钥 | OSS访问凭证密钥 | 在阿里云控制台获取 |
| Bucket名称 | bucket_name | 字符串 | 空 | 存储桶的名称 | OSS存储桶名称 | 你创建的bucket名称 |
| 文件路径 | object_key | 字符串 | 空 | 在云端的保存路径 | 对象在OSS中的键名 | "images/photo1.jpg" |
3.41 Save Metadata 节点 - 元数据保存器
这个节点就像是一个"信息记录器",能保存图片的描述、参数等额外信息。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 元数据 | metadata | 字典 | 从上个节点来 | 要保存的信息数据 | 包含元数据的字典对象 | 图片的生成参数、提示词等 |
| 保存路径 | save_path | 字符串 | "./metadata/" | 保存到哪个位置 | 元数据文件的保存路径 | "./output/meta/"保存到输出文件夹 |
3.42 Load Metadata From URL 节点 - 网络元数据加载器
这个节点就像是一个"网络信息获取器",能从网址加载元数据信息。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 元数据URL | metadata_url | 字符串 | 空 | 元数据的网址 | 元数据文件的URL地址 | http://example.com/metadata.json |
| 超时时间 | timeout | 整数 | 30 | 等待下载的最长时间 | 网络请求的超时时间 | 30秒通常够用 |
3.43 SolidColorBackground 节点 - 纯色背景生成器
这个节点就像是一个"彩色画布制作器",能生成任意颜色和尺寸的纯色背景图片。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 宽度 | width | 整数 | 512 | 背景图的宽度 | 生成图像的像素宽度 | 1024生成1024像素宽的背景 |
| 高度 | height | 整数 | 512 | 背景图的高度 | 生成图像的像素高度 | 1024生成1024像素高的背景 |
| 颜色 | color | RGB颜色值 | (255,255,255) | 背景的颜色 | RGB格式的颜色值 | (255,0,0)红色,(0,255,0)绿色 |
4. 使用技巧和建议
新手入门建议:
- 从简单开始:先试试 Load Image 和 Resize Image 这些基础节点,熟悉操作流程
- 多实验:每个参数都试试不同的数值,看看效果有什么变化
- 保存工作流:遇到好的效果记得保存工作流,方便以后重复使用
进阶使用技巧:
- 批量处理:使用 Load Image List 一次处理多张图片,提高效率
- 组合使用:比如先用 Extract Transparent Image 抠图,再用 Add Solid Color Background 换背景
- 参数优化:Resize 时选择合适的算法,"lanczos" 质量好但慢,"nearest" 速度快但可能有锯齿
常用组合推荐:
- 换背景流程:Load Image → Extract Transparent Image → Add Solid Color Background
- 图片拼接流程:Load Image List → Image Concat → Save Image
- 尺寸统一流程:Load Image List → Resize Image → Save Image
5. 常见问题解答
Q1:为什么我的透明图片背景变成白色了?
A1:可能是使用了 RGBA to RGB 节点,或者在 Load Image 时没有选择保持透明度。检查一下 keep_alpha 参数是否设为 True。
Q2:Image Overlay 和 Simple Image Overlay 有什么区别?
A2:Image Overlay 需要蒙版精确控制合并区域,适合专业抠图合成;Simple Image Overlay 更像贴贴纸,可以随意调整位置和透明度,操作更简单。
Q3:视频节点加载视频很慢怎么办?
A3:可以设置 frame_limit 参数只加载部分帧,或者降低 Preview Video 的质量设置。
Q4:上传到阿里云OSS失败怎么办?
A4:检查 AccessKey、Bucket 名称是否正确,网络是否正常,以及是否有足够的存储权限。
Q5:蒙版相关的节点看不懂怎么办?
A5:把蒙版想象成"模板"或"镂空板",白色区域是"通过"的部分,黑色区域是"遮挡"的部分。可以先用 Mask to Image 节点把蒙版转换成图片来观察效果。
6. 总结
ComfyUI-Light-Tool 插件就像是给你的 ComfyUI 安装了一个功能强大的工具箱,有了这些节点,你可以:
- 轻松处理各种格式的图片和视频
- 进行专业级的图片合成和编辑
- 批量处理大量文件
- 连接云服务进行存储
- 进行各种数据格式转换
记住,熟练使用这些工具的关键是多动手实践。每个节点都有自己的特色功能,组合使用能产生更强大的效果。从简单的图片加载开始,逐步尝试更复杂的功能,你很快就能成为图片处理高手!