%20(1).png)
Comfyui-LG_GroupExecutor 插件保姆级教程
1. 插件简介
插件地址： https://github.com/LAOGOU-666/Comfyui-LG_GroupExecutor
这个插件就像是给你的ComfyUI装了一个超级智能的工作流管理员！它能让你把不同的节点组织成小组，然后按照你的安排自动执行这些小组，就像有一个助手帮你按顺序完成不同的任务。
主要功能：
- 组执行管理：可以把ComfyUI中的节点分组，然后按顺序自动执行
- 图片传输：在不同的工作流之间传递图片，就像传递接力棒
- 列表处理：可以把多张图片分割、重复、组合等操作
- 快速预览：提供更快速的图片预览功能
- 累积预览：可以收集和展示多次生成的结果
能带来什么效果：
- 自动化工作流：让复杂的多步骤工作流自动执行，无需手动干预
- 批量处理：可以重复执行相同的操作多次，适合批量生成
- 工作流协作：不同的工作流可以互相传递数据
- 提高效率：减少重复操作，让创作过程更流畅
- 灵活控制：可以设置延迟、重复次数等参数
工作原理简单说明：
这个插件通过将ComfyUI的节点分组管理，然后提供执行控制器来按顺序运行这些组。同时提供了图片传输功能，让不同的工作流可以共享数据，就像搭建了一个智能的生产线。
2. 如何安装
方法一：通过ComfyUI管理器安装（推荐）
- 打开ComfyUI
- 点击"Manager"按钮
- 搜索"LG_GroupExecutor"
- 点击安装
方法二：手动安装
- 打开你的ComfyUI安装文件夹
- 进入
custom_nodes文件夹 - 在这里打开命令行窗口
- 输入命令：
git clone https://github.com/LAOGOU-666/Comfyui-LG_GroupExecutor.git
安装后重启
安装完成后，重启ComfyUI就可以使用了。
3. 节点详细解析
3.1 GroupExecutorSingle 节点 - 单组执行控制器
这个节点就像一个任务调度员，负责控制单个组的执行，可以设置执行次数、延迟时间等参数。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| group_name | group_name | 文字 | 空 | 组名称，就像给任务起个名字 | 指定要执行的组的名称 | 输入"生成人像"、"风景处理"等组名 |
| repeat_count | repeat_count | 1-100的整数 | 1 | 重复次数，就像设定任务要做几遍 | 指定该组执行的重复次数 | 设为5表示这个组要执行5次 |
| delay_seconds | delay_seconds | 0.0-60.0的小数 | 0.0 | 延迟秒数，就像每次执行之间的休息时间 | 每次执行之间的延迟时间 | 设为2.0表示每次执行间隔2秒 |
| signal | signal | SIGNAL类型 | 可选 | 执行信号，就像接力棒传递 | 用于连接其他执行节点的信号 | 连接其他GroupExecutor节点形成执行链 |
3.2 GroupExecutorSender 节点 - 执行信号发送器
这个节点就像一个发令枪，负责启动整个执行序列，把所有的执行指令发送出去。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| signal | signal | SIGNAL类型 | 必填 | 执行信号，就像接收所有的任务指令 | 接收来自其他执行节点的信号 | 连接GroupExecutorSingle的输出 |
3.3 GroupExecutorRepeater 节点 - 执行列表重复器
这个节点就像一个复印机，可以把一系列执行指令复制多份，让整个执行序列重复多次。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| signal | signal | SIGNAL类型 | 必填 | 执行信号，就像要复制的原始指令 | 接收要重复的执行信号 | 连接GroupExecutorSingle的输出 |
| repeat_count | repeat_count | 1-100的整数 | 1 | 重复次数，就像设定要复印几份 | 整个执行序列的重复次数 | 设为3表示整个序列执行3遍 |
| group_delay | group_delay | 0.0-300.0的小数 | 0.0 | 组间延迟，就像每轮执行之间的休息时间 | 每轮重复之间的延迟时间 | 设为10.0表示每轮间隔10秒 |
3.4 LG_ImageSender 节点 - 图片发送器
这个节点就像一个快递员，负责把图片打包发送到指定的地址，其他节点可以接收这些图片。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| images | images | IMAGE类型 | 必填 | 要发送的图片，就像要寄出的包裹 | 输入的图像数据 | 连接生成图片的节点输出 |
| filename_prefix | filename_prefix | 文字 | lg_send | 文件名前缀，就像给包裹贴标签 | 保存文件的名称前缀 | 设为"portrait"表示人像图片 |
| link_id | link_id | 0到最大整数 | 1 | 连接ID，就像快递地址编号 | 发送端和接收端的连接标识 | 设为123表示发送到123号地址 |
| accumulate | accumulate | true/false | false | 是否累积，就像是否等齐所有包裹一起寄 | 是否累积所有图像一起发送 | true会等所有图片都准备好再发送 |
| preview_rgba | preview_rgba | true/false | true | 预览格式，就像选择包裹的包装方式 | 预览图像的格式设置 | true显示透明背景，false显示纯色背景 |
| masks | masks | MASK类型 | 可选 | 遮罩信息，就像图片的额外说明 | 与图像对应的遮罩数据 | 连接生成遮罩的节点 |
| signal_opt | signal_opt | 任意类型 | 可选 | 信号传递，就像传递其他信息 | 可选的信号传递 | 用于与其他节点协调 |
3.5 LG_ImageReceiver 节点 - 图片接收器
这个节点就像一个收件人，负责接收指定地址发来的图片包裹，然后拆包使用。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| image | image | 文字 | 空 | 图片文件名，就像包裹单号 | 要接收的图像文件名列表 | 输入"image1.png,image2.png"等文件名 |
| link_id | link_id | 0到最大整数 | 1 | 连接ID，就像收件地址编号 | 与发送端对应的连接标识 | 设为123表示接收123号地址的包裹 |
3.6 ImageListSplitter 节点 - 图片列表分割器
这个节点就像一个挑选员，可以从一堆图片中挑选出你想要的几张，按照指定的顺序排列。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| images | images | IMAGE类型 | 必填 | 图片列表，就像一摞照片 | 输入的图像列表数据 | 连接包含多张图片的节点 |
| indices | indices | 文字 | 空 | 索引号码，就像选择第几张照片 | 要提取的图片索引列表 | 输入"0,2,4"表示选择第1、3、5张图片 |
3.7 MaskListSplitter 节点 - 遮罩列表分割器
这个节点就像图片分割器的孪生兄弟，专门用来挑选遮罩，功能和图片分割器一样。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| masks | masks | MASK类型 | 必填 | 遮罩列表，就像一摞模板 | 输入的遮罩列表数据 | 连接包含多个遮罩的节点 |
| indices | indices | 文字 | 空 | 索引号码，就像选择第几个模板 | 要提取的遮罩索引列表 | 输入"1,3,5"表示选择第2、4、6个遮罩 |
3.8 ImageListRepeater 节点 - 图片列表重复器
这个节点就像一个复印机，可以把每张图片复制多份，让你有更多相同的图片可以使用。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| images | images | IMAGE类型 | 必填 | 图片列表，就像要复印的原稿 | 输入的图像列表数据 | 连接包含图片的节点 |
| repeat_times | repeat_times | 1-100的整数 | 1 | 重复次数，就像设定复印份数 | 每张图片的重复次数 | 设为3表示每张图片复制3份 |
3.9 MaskListRepeater 节点 - 遮罩列表重复器
这个节点和图片重复器功能相同，专门用来复制遮罩，让你有更多相同的遮罩模板。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| masks | masks | MASK类型 | 必填 | 遮罩列表，就像要复印的模板 | 输入的遮罩列表数据 | 连接包含遮罩的节点 |
| repeat_times | repeat_times | 1-100的整数 | 1 | 重复次数，就像设定模板复印份数 | 每个遮罩的重复次数 | 设为2表示每个遮罩复制2份 |
3.10 LG_FastPreview 节点 - 快速预览器
这个节点就像一个快速冲印店，可以快速生成图片预览，支持不同的格式和质量设置。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| images | images | IMAGE类型 | 必填 | 要预览的图片，就像要冲印的照片 | 输入的图像数据 | 连接生成图片的节点 |
| format | format | PNG/JPEG/WEBP | JPEG | 保存格式，就像选择照片纸的类型 | 图像保存的文件格式 | JPEG适合照片，PNG适合有透明的图 |
| quality | quality | 1-100的整数 | 95 | 图片质量，就像选择冲印的清晰度 | 图像压缩质量设置 | 95是高质量，50是中等质量 |
3.11 LG_AccumulatePreview 节点 - 累积预览器
这个节点就像一个收集册，可以把多次生成的图片收集起来，统一展示和管理。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| images | images | IMAGE类型 | 必填 | 要收集的图片，就像要放进相册的照片 | 输入的图像数据 | 连接生成图片的节点 |
| mask | mask | MASK类型 | 可选 | 对应的遮罩，就像照片的说明标签 | 与图像对应的遮罩数据 | 连接生成遮罩的节点 |
4. 前端扩展功能
4.1 组执行器UI界面
这个插件还提供了一个可视化的管理界面，就像一个控制面板，让你可以通过图形界面来管理和执行组。
主要功能：
- 多组执行模式：可以选择多个组按顺序执行
- 单组执行模式：可以单独执行某个组
- 配置保存：可以保存常用的执行配置
- 搜索功能：可以快速找到想要的组
- 拖拽定位：可以把界面拖到任意位置
使用方法：
- 在ComfyUI画布上右键点击
- 选择"⚡ 打开组执行器"
- 在弹出的界面中设置执行参数
- 点击执行按钮开始自动执行
5. 使用技巧和建议
5.1 基础使用流程
- 创建组：在ComfyUI中使用Group功能将相关节点分组
- 设置执行器：使用GroupExecutorSingle设置每个组的执行参数
- 连接信号：用GroupExecutorSender启动执行序列
- 图片传输：使用ImageSender和ImageReceiver在组间传递图片
- 批量处理：使用Repeater节点实现批量执行
5.2 不同场景的使用建议
批量生成场景：
- 使用GroupExecutorRepeater设置大量重复
- 设置适当的延迟避免系统过载
- 使用AccumulatePreview收集所有结果
工作流协作场景：
- 使用ImageSender/Receiver在不同工作流间传递数据
- 设置唯一的link_id避免冲突
- 使用accumulate模式确保数据完整性
图片处理场景：
- 使用ListSplitter选择特定图片
- 使用ListRepeater创建多份副本
- 使用FastPreview快速查看结果
5.3 性能优化建议
- 合理设置延迟：避免系统过载，建议每组间隔1-3秒
- 控制重复次数：大批量处理时分批进行
- 及时清理：定期清理临时文件释放空间
- 监控资源：注意显存和内存使用情况
5.4 工作流设计技巧
- 将相关功能的节点组织成逻辑组
- 使用有意义的组名便于管理
- 设计可重用的组模板
- 合理安排执行顺序避免依赖冲突
6. 常见问题解答
Q1：为什么组执行器找不到我创建的组？
A： 可能的原因：
- 组名称包含特殊字符
- 组边界设置不正确
- 节点没有完全包含在组内
- 需要刷新组列表
Q2：图片传输失败怎么办？
A： 检查以下几点：
- 确保发送端和接收端的link_id相同
- 检查文件名是否正确
- 确认临时目录有写入权限
- 检查网络连接是否正常
Q3：执行过程中出现错误如何处理？
A： 解决方法：
- 使用取消按钮停止执行
- 检查每个组内的节点是否正常
- 调整延迟时间避免冲突
- 查看控制台错误信息
Q4：如何保存和加载执行配置？
A： 操作步骤：
- 在UI界面中设置好参数
- 点击保存按钮并输入配置名
- 下次使用时从下拉菜单选择配置
- 可以删除不需要的配置
Q5：累积预览不显示图片怎么办？
A： 可能的解决方案：
- 确保图片格式正确
- 检查节点连接是否正确
- 重新运行工作流
- 清除浏览器缓存
Q6：如何优化大批量处理的性能？
A： 优化建议：
- 分批处理，每批不超过50张
- 增加组间延迟时间
- 使用较低的图片质量设置
- 定期重启ComfyUI释放内存
7. 高级使用技巧
7.1 复杂工作流设计
- 使用多层嵌套的组结构
- 设计条件执行逻辑
- 实现循环和递归处理
- 创建可配置的模板
7.2 自动化脚本集成
- 结合外部脚本实现更复杂的逻辑
- 使用配置文件管理大量参数
- 实现定时执行功能
- 集成监控和报警机制
7.3 性能监控和调优
- 监控执行时间和资源使用
- 分析瓶颈并优化参数
- 实现负载均衡
- 建立性能基准测试
8. 故障排除
8.1 常见错误及解决方案
错误：组执行失败
- 原因：组内节点配置错误或依赖缺失
- 解决：检查组内每个节点的设置和连接
错误：图片传输超时
- 原因：网络问题或文件过大
- 解决：检查网络连接，减小图片尺寸
错误：内存不足
- 原因：批量处理数量过大
- 解决：减少批量大小，增加延迟时间
错误：配置保存失败
- 原因：权限不足或磁盘空间不够
- 解决：检查文件权限和磁盘空间
8.2 调试技巧
- 使用控制台查看详细错误信息
- 逐步测试每个组的功能
- 使用小批量测试验证配置
- 记录成功的配置参数
9. 实际应用案例
9.1 批量人像生成
设置多个人像生成组，每组使用不同的提示词，批量生成大量人像图片。
9.2 风格转换流水线
创建多个风格转换组，让图片依次经过不同的风格处理。
9.3 质量检测和筛选
设置自动质量检测组，筛选出符合要求的图片进行后续处理。
9.4 多分辨率输出
创建不同分辨率的处理组，同时输出多种尺寸的图片。
10. 总结
Comfyui-LG_GroupExecutor插件是一个功能强大的工作流自动化工具，它通过组管理、执行控制、图片传输等功能，让复杂的ComfyUI工作流变得更加智能和高效。
核心优势：
- 自动化执行，减少手动操作
- 灵活的组管理和控制
- 强大的图片传输功能
- 丰富的列表处理工具
- 直观的可视化界面
适用场景：
- 批量图片生成和处理
- 复杂工作流的自动化
- 多步骤图片处理流水线
- 工作流间的数据协作
使用要点：
- 合理设计组结构和执行顺序
- 适当设置延迟时间避免冲突
- 善用图片传输功能实现协作
- 定期保存和管理执行配置
这个插件为ComfyUI用户提供了强大的自动化能力，是提高工作效率的重要工具。