ComfyUI_Eagleshadow 插件完整教程
1. 插件简介
ComfyUI_Eagleshadow 是一个专门为 ComfyUI 设计的自定义节点集合,插件地址:https://github.com/Shadetail/ComfyUI_Eagleshadow
这个插件就像是给你的 ComfyUI 工具箱里增加了一堆实用的小工具。想象一下,你平时做图像处理时经常需要做一些简单但重复的事情,比如保存图片到指定文件夹、给图片添加发光效果、调整图片位置等等。而这个插件就是帮你把这些常用功能打包好,让你点点鼠标就能完成,不用再去摸索复杂的操作。
主要能给你带来这些效果:
- 轻松管理和切换不同的模型文件
- 批量处理图片更高效
- 给图片添加各种特效(发光、合成等)
- 更灵活的图片保存和命名方式
- 更稳定的视频帧处理效果
2. 如何安装
安装这个插件就像往你的工具箱里添加新工具一样简单:
方法一:直接下载安装
- 打开你的 ComfyUI 安装目录
- 进入
custom_nodes文件夹 - 在这里新建一个文件夹,命名为
ComfyUI_Eagleshadow - 去 https://github.com/Shadetail/ComfyUI_Eagleshadow 下载插件文件
- 把下载的文件放进刚才创建的文件夹里
- 重启 ComfyUI
方法二:使用 Git(推荐)
- 打开命令行工具
- 切换到你的 ComfyUI 的
custom_nodes文件夹 - 运行命令:
git clone https://github.com/Shadetail/ComfyUI_Eagleshadow.git - 重启 ComfyUI
3. 节点逐一解析
3.1 ES Select Model 节点(模型选择器)
这个节点就像一个超级大的模型收纳盒,原本只能装5个模型,现在能装20个模型。想象你有很多不同的画笔,这个节点就是帮你快速选择用哪支画笔的工具。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 模型选择 | model_name | 下拉菜单 | 根据需要选择 | 就像选择不同的画笔,每个模型画出来的风格都不一样 | 从预加载的20个模型中选择一个用于生成 | 比如你想画动漫风格就选动漫模型,想画真实照片就选写实模型 |
| 模型路径 | model_path | 文件路径 | 自动填充 | 告诉电脑这个模型文件放在哪里 | 模型文件的存储位置路径 | 一般不用手动改,系统会自动找到 |
3.2 ES Float String 节点(数字文字合并器)
这个节点就像一个标签打印机,能把数字和文字合并成一个标签贴在文件名上。比如你想给图片文件名加上"第3.14张图片"这样的标记。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 浮点数 | float_value | 数字 | 根据需要 | 就像温度计上的数字,可以是小数 | 输入的浮点数值,会被保留两位小数 | 比如输入3.14159,会变成3.14 |
| 前缀文字 | prefix_string | 文本 | 根据需要 | 就像给数字前面加个说明,比如"温度:" | 要与数字合并的文本前缀 | 输入"图片_",最终会得到"图片_3.14" |
3.3 ES Save Image 节点(图片保存器)
这个节点就像一个智能文件管理员,能把图片保存到你指定的文件夹,用你想要的文件名。不用再为找不到图片文件而烦恼。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 图片 | image | 图片数据 | 连接其他节点 | 就像你要保存的照片 | 输入的图像张量数据 | 从其他节点接收图片数据 |
| 文件夹路径 | folder_path | 文件夹路径 | D:\我的图片\ | 告诉电脑把图片存到哪个文件夹里 | 目标保存目录的完整路径 | 比如"D:\AI图片\今天的作品" |
| 文件名 | filename | 文件名 | 根据需要 | 给图片起个名字,就像给宠物起名 | 保存的文件名(不包含扩展名) | 比如"美女_001",会保存为"美女_001.png" |
3.4 ES Extract Checkpoint Name 节点(模型名称提取器)
这个节点就像一个文件名解析器,能从复杂的文件路径中提取出模型的真正名字。比如从"D:\models\beautiful_model.safetensors"中提取出"beautiful_model"。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 文件路径 | file_path | 文件路径 | 自动获取 | 就像从一个长长的地址中找出房子的名字 | 包含模型文件完整路径的字符串 | 输入"D:\models\anime_v1.safetensors"得到"anime_v1" |
3.5 ES Select ControlNet 节点(控制网络选择器)
这个节点就像一个专门装控制网络的工具箱,控制网络就像是给AI画画时的各种模板和参考线,帮助AI画出更精确的图像。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 控制网络选择 | controlnet_name | 下拉菜单 | 根据需要选择 | 就像选择不同的绘画模板,有的管线条有的管色彩 | 从可用的ControlNet模型中选择 | 比如选择Canny用于边缘检测,选择Pose用于姿势控制 |
| 控制网络路径 | controlnet_path | 文件路径 | 自动填充 | 告诉电脑这个控制网络文件放在哪里 | ControlNet模型文件的存储路径 | 系统会自动找到对应的文件位置 |
3.6 ES Load Image Batch Fast 节点(快速批量图片加载器)
这个节点就像一个超级快的图片搬运工,能一次性搬运很多图片,而且速度比普通搬运工快100倍。特别适合处理大量图片的时候。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 文件夹路径 | folder_path | 文件夹路径 | 根据需要 | 告诉程序去哪个文件夹找图片 | 包含图片文件的目录路径 | 比如"D:\视频帧\第一集" |
| 图片格式 | image_format | 文件格式 | jpg, png | 就像告诉程序要找什么类型的图片 | 支持的图片文件格式 | 一般选择jpg或png格式 |
| 开始索引 | start_index | 数字 | 0 | 从第几张图片开始处理 | 批量处理的起始图片索引 | 比如设置为10,就从第10张图片开始 |
| 结束索引 | end_index | 数字 | -1 | 处理到第几张图片结束,-1表示全部 | 批量处理的结束图片索引 | 设置为50就处理到第50张图片 |
| 随机种子 | seed | 数字 | 自动生成 | 就像洗牌时的随机数,保证每次运行都有结果 | 用于自动队列执行的随机种子 | 一般用自动生成的就行 |
3.7 ES KSampler Batch Same Noise 节点(批量同噪声采样器)
这个节点就像一个画家,能保证在画一系列相关的图片时使用相同的"画布纹理",这样连续的图片看起来会更加连贯,特别适合制作视频帧。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 模型 | model | 模型 | 连接模型节点 | 就像选择哪个画家来画画 | 用于生成的扩散模型 | 从CheckpointLoaderSimple节点连接 |
| 正面提示词 | positive | 条件 | 连接编码器 | 告诉AI你想要什么样的图片 | 正向条件编码 | 比如"美丽的风景,高质量" |
| 负面提示词 | negative | 条件 | 连接编码器 | 告诉AI你不想要什么 | 负向条件编码 | 比如"模糊,低质量" |
| 潜在空间 | latent_image | 潜在图像 | 连接VAE | 就像是画布的底色 | 输入的潜在空间图像 | 从VAE编码器或其他节点连接 |
| 随机种子 | seed | 数字 | 根据需要 | 就像画画时的随机灵感来源 | 控制随机性的种子值 | 相同种子会产生相似结果 |
| 采样步数 | steps | 数字 | 20-50 | 就像画画的仔细程度,步数越多越精细 | 扩散去噪的采样步数 | 20步适合快速预览,50步适合高质量 |
| CFG值 | cfg | 数字 | 7.0 | 就像画家听你指令的程度,值越大越听话 | 分类器自由引导强度 | 7.0是比较平衡的值 |
| 采样器 | sampler_name | 选择 | euler_a | 就像选择不同的画画技法 | 扩散采样算法 | euler_a适合大多数情况 |
| 调度器 | scheduler | 选择 | normal | 就像画画的节奏控制 | 噪声调度策略 | normal适合大多数情况 |
3.8 ES Batch Images 节点(图片批量打包器)
这个节点就像一个图片打包机,能把12张单独的图片打包成一个包裹,方便批量处理。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 图片1-12 | image1-image12 | 图片 | 连接图片节点 | 就像把12张照片放进一个相册里 | 将12个单独的图像组合成批量 | 每个接口连接一张图片 |
3.9 ES Composite 节点(图片合成器)
这个节点就像一个专业的图片合成师,能把两张图片完美地合成在一起,还能调整大小和透明度。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 底图 | base_image | 图片 | 连接图片节点 | 就像画画的底色背景 | 作为合成底层的图像 | 比如风景照片作为背景 |
| 顶图 | top_image | 图片 | 连接图片节点 | 就像要贴在背景上的贴纸 | 要合成到底图上的图像 | 比如人物照片要合成到风景上 |
| 遮罩 | mask | 遮罩 | 可选连接 | 就像剪纸的模板,控制哪些地方要合成 | 控制合成区域的遮罩图像 | 用白色表示要合成的区域 |
| X坐标 | x | 数字 | 0 | 顶图放在底图的左右位置 | 顶图在底图上的水平位置 | 0是最左边,数字越大越靠右 |
| Y坐标 | y | 数字 | 0 | 顶图放在底图的上下位置 | 顶图在底图上的垂直位置 | 0是最上边,数字越大越靠下 |
| 缩放比例 | scale | 数字 | 1.0 | 顶图的大小调整,1.0是原始大小 | 顶图的缩放因子 | 0.5是缩小一半,2.0是放大一倍 |
3.10 ES Mask Glow 节点(遮罩发光效果器)
这个节点就像一个魔法师,能给图片的特定区域加上发光效果,让图片看起来更加酷炫。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 遮罩 | mask | 遮罩 | 连接遮罩节点 | 就像告诉程序哪些地方要发光 | 输入的遮罩图像 | 白色区域会产生发光效果 |
| 发光大小 | glow_size | 数字 | 10 | 就像灯泡的亮度范围大小 | 发光效果的扩散半径 | 数字越大发光范围越大 |
| 模糊强度 | blur_intensity | 数字 | 5.0 | 就像发光的柔和程度 | 发光边缘的模糊程度 | 数字越大发光越柔和 |
| 发光强度 | glow_intensity | 数字 | 1.0 | 就像发光的亮度 | 发光效果的强度 | 1.0是正常亮度,2.0是两倍亮度 |
| 保留原遮罩 | keep_original | 布尔值 | True | 是否保留原来的图案 | 是否在发光效果上叠加原始遮罩 | True会保留原图案加发光 |
| 边缘淡化 | fadeout | 布尔值 | False | 发光边缘是否要渐渐消失 | 是否在发光边缘应用渐变效果 | True会让发光边缘更自然 |
3.11 ES Mask Dilate 节点(遮罩扩张器)
这个节点就像一个单向的放大镜,只向一个方向扩展图案的边缘,而不是向四周扩展。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 遮罩 | mask | 遮罩 | 连接遮罩节点 | 就像要处理的图案模板 | 输入的二值遮罩图像 | 白色区域会被扩张 |
| 扩张像素 | dilate_pixels | 数字 | 5 | 图案边缘向外扩展多少个点 | 扩张操作的像素数量 | 5表示向外扩展5个像素 |
| 扩张方向 | direction | 选择 | right | 向哪个方向扩展图案 | 扩张的方向选择 | right向右,left向左,up向上,down向下 |
3.12 ES Image Offset 节点(图片位置调整器)
这个节点就像Photoshop里的移动工具,能把图片在画布上任意移动位置。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 图片 | image | 图片 | 连接图片节点 | 要移动位置的图片 | 输入的图像数据 | 任何图片都可以 |
| 水平偏移 | horizontal_offset | 数字 | 0 | 图片左右移动的距离 | 图像在水平方向的偏移量 | 正数向右移,负数向左移 |
| 垂直偏移 | vertical_offset | 数字 | 0 | 图片上下移动的距离 | 图像在垂直方向的偏移量 | 正数向下移,负数向上移 |
3.13 ES Mask Transparency Check 节点(透明度检查器)
这个节点就像一个透明度检测器,能检查图片是否有透明的地方,然后给出不同的结果。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 遮罩 | mask | 遮罩 | 连接遮罩节点 | 要检查的图片模板 | 输入的遮罩图像 | 黑白图片,白色表示不透明 |
| 有透明时输出 | transparent_output | 数字 | 1 | 如果发现透明区域要输出什么数字 | 检测到透明度时的输出值 | 可以用来控制其他节点的行为 |
| 无透明时输出 | opaque_output | 数字 | 2 | 如果没有透明区域要输出什么数字 | 未检测到透明度时的输出值 | 可以用来控制其他节点的行为 |
4. 使用技巧和建议
4.1 模型管理技巧
- 使用ES Select Model节点时,建议按照用途给模型分类命名,比如"人物_写实_v1"、"风景_动漫_v2"
- 经常使用的模型放在列表前面,方便快速选择
4.2 批量处理优化
- 处理大量图片时,优先使用ES Load Image Batch Fast节点,它的速度比普通批量加载快很多
- 使用ES KSampler Batch Same Noise节点处理视频帧时,保持相同的种子值能让帧与帧之间更连贯
4.3 图片合成技巧
- 使用ES Composite节点合成图片时,先调整好顶图的大小和位置,再处理透明度
- 配合ES Mask Glow节点能创造出更专业的合成效果
4.4 文件管理建议
- 使用ES Save Image节点时,建议创建有意义的文件夹结构,比如按日期、项目、风格分类
- 配合ES Float String节点能创建更有序的文件命名规则
5. 常见问题解答
Q: 为什么ES Load Image Batch Fast比普通的批量加载快这么多?
A: 这个节点去掉了很多额外的功能,专注于纯粹的图片加载,就像精简版的软件运行更快一样。
Q: ES KSampler Batch Same Noise节点的同噪声效果不是100%相同怎么办?
A: 作者也发现了这个问题,如果需要完全相同的效果,建议使用3个ComfyUI实例并行处理,或者接受90%的相似度。
Q: 使用ES Mask Glow节点时发光效果不明显?
A: 尝试增加发光强度(glow_intensity)和发光大小(glow_size)参数,同时检查输入的遮罩是否正确。
Q: ES Composite节点合成后图片质量下降?
A: 这个节点内置了伽马校正,确保图片质量。如果还是有问题,检查输入图片的分辨率和格式。
Q: 如何选择合适的模型数量?
A: ES Select Model节点支持20个模型,但不一定要全部填满,根据实际需要选择常用的模型即可。
6. 高级应用场景
6.1 视频处理工作流
结合ES Load Image Batch Fast和ES KSampler Batch Same Noise节点,能创建专业的视频帧处理流程:
- 使用快速批量加载节点导入视频帧
- 使用同噪声采样器保持帧间一致性
- 使用图片保存节点按顺序输出处理后的帧
6.2 批量产品图制作
利用ES Composite和ES Mask Glow节点:
- 准备产品图片和各种背景
- 使用合成节点将产品合成到不同背景
- 使用发光效果节点增加产品的视觉吸引力
6.3 自动化文件管理
结合ES Float String和ES Save Image节点:
- 创建自动编号的文件命名系统
- 按照项目、日期、版本号自动分类保存
- 建立可追溯的文件管理体系
这个插件虽然节点不多,但每个都很实用,特别适合需要批量处理图片或者制作视频的朋友。记住,好的工具是为了让工作更轻松,不要被复杂的参数吓到,多试几次就熟练了!