%20(1).png)
ControlFlowUtils 插件保姆级教程
1. 插件简介
插件原地址： https://github.com/VykosX/ControlFlowUtils
ControlFlowUtils 是一个超级强大的 ComfyUI 插件，就像给你的工作流程加了一个"智能大脑"！它能让你的工作流程变得更聪明，可以自动循环、自动判断、自动选择，完全不需要你手动操作。
这个插件能给我们带来什么效果？
- 让工作流程自动重复执行（就像设置闹钟一样）
- 根据条件自动选择不同的路径（就像导航软件选路线）
- 在不同的执行之间保存和传递数据（就像记事本记住信息）
- 自动管理内存和模型（就像手机自动清理垃圾）
- 处理文件和文本操作（就像文件管理器）
简单来说，这就是一个让 ComfyUI 变得"智能化"和"自动化"的超级工具包！
2. 如何安装
方法一：通过 ComfyUI Manager 安装（推荐）
- 打开 ComfyUI Manager
- 搜索 "ControlFlowUtils"
- 点击安装
- 重启 ComfyUI
方法二：手动安装
- 打开你的 ComfyUI 文件夹
- 进入
custom_nodes文件夹 - 下载插件：
git clone https://github.com/VykosX/ControlFlowUtils.git - 重启 ComfyUI
3. 节点详解
3.1 Cycle 节点 - 循环计数器
这个节点就像一个"计数器"，可以记住当前是第几次执行，让你的工作流程能够在多次运行之间传递信息。
3.1.1 必填参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| start | start | 整数 | 0 | 计数器的起始数字，就像从几开始数数 | 循环计数器的初始值 | 设置为0表示从第0次开始，设置为1表示从第1次开始 |
| step | step | 整数 | 1 | 每次增加多少，就像每次数数加几 | 每次迭代时计数器的增量 | 设置为1表示每次加1，设置为2表示每次加2 |
| end | end | 整数 | 10 | 数到多少就停止，就像数到10就不数了 | 循环结束的目标值 | 设置为10表示数到10就停止循环 |
3.1.2 可选参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| manual_reset | manual_reset | true/false | false | 手动重新开始计数，就像重置秒表 | 手动触发循环重置 | 设置为true可以强制重新开始循环 |
| auto_reset | auto_reset | true/false | true | 数完了自动重新开始，就像循环播放音乐 | 到达结束值后是否自动重置 | true表示循环结束后自动重新开始 |
3.2 CycleContinue 节点 - 循环数据传递器
这个节点就像一个"传话筒"，把上一次的结果传给下一次使用。
3.2.1 必填参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| CYCLE | CYCLE | CYCLE类型 | 来自Cycle节点 | 连接循环计数器，就像插电源线 | 循环状态对象 | 必须连接到Cycle节点的输出 |
| data | data | 任意类型 | 你的数据 | 要在循环中传递的主要数据 | 循环中传递的主数据 | 可以是图片、文本或任何数据 |
3.2.2 可选参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| index_override | index_override | 整数 | 无 | 强制跳到指定的循环次数 | 手动覆盖当前循环索引 | 设置为5可以直接跳到第5次循环 |
| aux | aux | 任意类型 | 无 | 额外的辅助数据，就像备用口袋 | 辅助数据传递 | 可以传递额外的信息或参数 |
3.3 CycleEnd 节点 - 循环结束器
这个节点就像一个"终点站"，告诉系统这一轮循环结束了。
3.3.1 必填参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| CYCLE | CYCLE | CYCLE类型 | 来自Cycle节点 | 连接循环计数器，确认循环状态 | 循环状态对象 | 必须连接到Cycle节点的输出 |
| data | data | 任意类型 | 处理后的数据 | 这一轮循环处理完的数据 | 当前循环迭代的结果数据 | 把处理好的图片或数据传进来 |
3.4 LoopOpen 节点 - 循环开始器
这个节点就像一个"自动重复机"，可以让一段工作流程自动重复执行很多次。
3.4.1 必填参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| start | start | 整数 | 1 | 从第几次开始重复 | 循环起始值 | 设置为1表示从第1次开始 |
| step | step | 整数 | 1 | 每次增加多少 | 循环步长 | 设置为1表示每次加1，设置为2表示隔一个执行 |
| end | end | 整数 | 10 | 重复到第几次停止 | 循环结束值 | 设置为10表示重复10次就停止 |
| condition | condition | 文本 | True | 什么条件下才重复，就像设置闹钟条件 | 循环执行条件 | 写"True"表示一直重复，可以写复杂条件 |
3.5 LoopClose 节点 - 循环结束器
这个节点就像循环的"出口"，决定是继续循环还是结束。
3.5.1 必填参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| LOOP | LOOP | 任意类型 | 来自LoopOpen | 连接循环开始器 | 循环状态对象 | 必须连接到LoopOpen节点 |
| condition | condition | 文本 | True | 继续循环的条件 | 循环继续条件 | 写"True"表示按计划循环，可以写提前结束条件 |
3.6 UniversalSwitch 节点 - 万能开关
这个节点就像一个"智能分配器"，可以根据你的设置把不同的输入分配到不同的输出。
3.6.1 必填参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| input1 | input1 | 任意类型 | 你的数据 | 第一个输入口，就像插座的第一个孔 | 第一个输入数据 | 可以连接任何类型的数据 |
| mode | mode | 下拉选择 | SWITCH | 选择分配模式，就像选择播放模式 | 开关工作模式 | SWITCH是单选，CYCLE是循环分配 |
| selection_in | selection_in | 整数 | 1 | 选择第几个输入，就像选择第几个频道 | 输入选择索引 | 1表示选择第1个输入，2表示选择第2个输入 |
| selection_out | selection_out | 整数 | 1 | 输出到第几个口，就像选择第几个扬声器 | 输出选择索引 | 1表示输出到第1个口，2表示输出到第2个口 |
| validate_typing | validate_typing | true/false | false | 是否检查数据类型匹配 | 类型验证开关 | 暂未实现，保持false即可 |
3.7 IfConditionSelector 节点 - 条件判断器
这个节点就像一个"智能选择器"，可以根据条件自动选择不同的路径。
3.7.1 必填参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| condition | condition | 下拉选择 | A == B | 选择比较方式，就像选择比较规则 | 条件比较类型 | A == B表示相等，A > B表示大于 |
| require_inputs | require_inputs | true/false | true | 是否需要输入数据，还是只返回对错 | 是否返回输入数据 | true返回数据，false只返回true/false |
| NOT | NOT | true/false | false | 是否反转结果，就像取反 | 条件结果反转 | true会把对的变成错的，错的变成对的 |
| custom_expression | custom_expression | 文本 | 2a == 5b+2 | 自定义比较公式 | 自定义条件表达式 | 可以写复杂的数学或逻辑表达式 |
3.7.2 可选参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| A | A | 任意类型 | 无 | 第一个比较对象 | 条件比较的第一个值 | 可以是数字、文本或其他数据 |
| B | B | 任意类型 | 无 | 第二个比较对象 | 条件比较的第二个值 | 可以是数字、文本或其他数据 |
| TRUE_IN | TRUE_IN | 任意类型 | 无 | 条件为真时返回的数据 | 条件成立时的输出 | 条件满足时会输出这个数据 |
| FALSE_IN | FALSE_IN | 任意类型 | 无 | 条件为假时返回的数据 | 条件不成立时的输出 | 条件不满足时会输出这个数据 |
3.8 HaltExecution 节点 - 执行停止器
这个节点就像一个"紧急刹车"，可以在需要的时候停止整个工作流程。
3.8.1 必填参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| disable | disable | true/false | false | 是否禁用停止功能，就像安全锁 | 是否禁用停止执行 | false表示可以停止，true表示不会停止 |
| method | method | true/false | false | 停止方式选择 | 停止执行的方法 | false是取消整个任务，true是阻止后续执行 |
| clear_queue | clear_queue | true/false | false | 是否清空任务队列 | 是否清除执行队列 | true会清空所有等待的任务 |
| alert_on_trigger | alert_on_trigger | true/false | false | 停止时是否弹出警告 | 是否显示停止警告 | true会在停止时显示提醒信息 |
| input | input | 任意类型 | 你的数据 | 要传递的数据 | 透传的数据 | 数据会原样传递到输出 |
3.9 MemoryStorage 节点 - 记忆存储器
这个节点就像一个"记事本"，可以记住数据并在不同的地方使用。
3.9.1 必填参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| Name | Name | 文本 | 变量名 | 给这个记忆起个名字，就像文件名 | 内存存储的唯一标识符 | 比如"我的图片"、"计数器"等 |
3.9.2 可选参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| Input | Input | 任意类型 | 无 | 要存储的数据 | 要保存到内存的数据 | 可以是图片、数字、文本等任何数据 |
| Reset | Reset | true/false | false | 是否清空这个记忆 | 是否重置存储内容 | true会删除存储的数据 |
| AcceptNulls | AcceptNulls | true/false | false | 是否接受空值 | 是否允许存储空值 | true允许存储空数据，false会忽略空数据 |
3.10 DataMonitor 节点 - 数据监视器
这个节点就像一个"万能显示器"，可以显示、转换和处理各种数据。
3.10.1 必填参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| text | text | 文本 | 空 | 要处理的文本内容 | 文本输入框 | 可以写文字、公式或代码 |
| output_type | output_type | 下拉选择 | ANY | 输出数据的类型 | 输出数据类型转换 | ANY保持原样，STRING转为文字，INT转为整数 |
3.10.2 可选参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| passthrough | passthrough | 任意类型 | 无 | 要显示和传递的数据 | 透传数据输入 | 连接任何数据都会显示出来 |
| aux | aux | 任意类型 | 无 | 辅助数据1 | 第一个辅助数据输入 | 可以用于公式计算或显示 |
| aux2-aux5 | aux2-aux5 | 任意类型 | 无 | 辅助数据2-5 | 额外的辅助数据输入 | 提供更多数据用于处理 |
3.11 StringOperation 节点 - 文字处理器
这个节点就像一个"文字工具箱"，可以对文字进行各种操作。
3.11.1 必填参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| input | input | 任意类型 | 你的文字 | 要处理的文字或列表 | 输入的字符串或列表数据 | 可以是"Hello World"或["a","b","c"] |
| operation | operation | 下拉选择 | UPPERCASE | 选择要做的操作 | 字符串操作类型 | UPPERCASE变大写，LOWERCASE变小写 |
| start_from_end | start_from_end | true/false | false | 是否从末尾开始处理 | 是否从字符串末尾开始操作 | true从后往前处理，false从前往后处理 |
| case_insensitive | case_insensitive | true/false | false | 是否忽略大小写 | 是否忽略大小写差异 | true不区分大小写，false区分大小写 |
3.12 其他实用节点
3.12.1 FallbackImagePreviewer 节点 - 容错图片预览器
这个节点就像一个"智能相框"，即使没有图片也不会出错。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| images | images | 图片 | 你的图片 | 要预览的图片 | 输入图像数据 | 连接任何图片都可以预览 |
| fallback_width | fallback_width | 整数 | 512 | 没有图片时生成的宽度 | 占位图像宽度 | 没图片时会生成这个宽度的黑色图片 |
| fallback_height | fallback_height | 整数 | 512 | 没有图片时生成的高度 | 占位图像高度 | 没图片时会生成这个高度的黑色图片 |
3.12.2 UnloadModels 节点 - 模型卸载器
这个节点就像"内存清理器"，可以释放显存空间。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| Passthrough | Passthrough | 任意类型 | 你的数据 | 要传递的数据 | 透传数据 | 数据会原样传递，同时清理显存 |
| ForceUnload | ForceUnload | true/false | false | 是否强制立即卸载 | 强制卸载模式 | true立即卸载，false请求卸载 |
3.12.3 GarbageCollector 节点 - 垃圾回收器
这个节点就像"系统清理工具"，可以释放内存空间。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| Input | Input | 任意类型 | 你的数据 | 要传递的数据 | 透传数据 | 数据会原样传递，同时清理内存 |
| RAM | RAM | true/false | true | 是否清理系统内存 | 是否执行RAM清理 | true会尝试清理系统内存（仅Windows） |
| Mode | Mode | true/false | false | 清理模式选择 | 清理执行模式 | false等待完成，true异步执行 |
3.12.4 Wait 节点 - 等待器
这个节点就像"定时器"，可以让工作流程暂停一段时间。
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| Delay | Delay | 小数 | 5.0 | 等待多少秒 | 延迟时间（秒） | 5.0表示等待5秒，0.5表示等待半秒 |
| Input | Input | 任意类型 | 无 | 要传递的数据 | 透传数据 | 等待结束后会传递这个数据 |
3.12.5 其他辅助节点
NullInput 节点 - 空输入器：提供空值输入
NullOutput 节点 - 空输出器：输出空值
SimpleToggle 节点 - 简单开关：输出true或false
InvertCondition 节点 - 条件反转器：把true变false，false变true
文件操作节点：
- ReadTextFile 节点 - 文本文件读取器：读取文本文件内容
- SaveTextFile 节点 - 文本文件保存器：保存文本到文件
- FolderSearch 节点 - 文件夹搜索器：搜索文件夹中的文件
选择器节点：
- ModelSelector 节点 - 模型选择器：选择可用的模型
- LoraSelector 节点 - LoRA选择器：选择可用的LoRA
- VAESelector 节点 - VAE选择器：选择可用的VAE
4. 使用技巧和建议
4.1 新手推荐组合
- 简单循环： Cycle → CycleContinue → CycleEnd
- 条件判断： IfConditionSelector + UniversalSwitch
- 数据存储： MemoryStorage + DataMonitor
- 内存管理： UnloadModels + GarbageCollector
4.2 高级应用场景
- 批量处理图片： 使用循环节点处理多张图片
- 条件生成： 根据不同条件生成不同风格的图片
- 数据累积： 在多次执行间累积和处理数据
- 自动化工作流： 创建完全自动化的复杂流程
5. 常见问题解答
Q1: 循环节点不工作怎么办？
A: 检查以下几点：
- Cycle、CycleContinue、CycleEnd三个节点必须正确连接
- 确保start、step、end参数设置合理
- 检查是否有manual_reset被意外开启
Q2: 条件判断总是不准确？
A: 可能的原因：
- 检查A和B输入是否正确连接
- 确认condition选择的比较方式是否正确
- 如果使用CUSTOM模式，检查custom_expression语法
Q3: 内存不足怎么办？
A: 尝试以下解决方案：
- 使用UnloadModels节点及时卸载模型
- 使用GarbageCollector节点清理内存
- 在循环中定期清理，避免内存累积
Q4: 数据在循环中丢失？
A: 确保：
- 使用MemoryStorage节点保存重要数据
- 在CycleContinue和CycleEnd之间正确传递数据
- 检查AcceptNulls设置是否合适
6. 高级功能说明
6.1 自定义表达式
在DataMonitor和IfConditionSelector中可以使用复杂的Python表达式：
- 支持数学运算：
2 * a + 3 * b - 支持逻辑判断：
a > 5 and b < 10 - 支持列表操作：
[x for x in range(10) if x % 2 == 0]
6.2 内存存储变量
可以在表达式中使用内存存储的变量：
- 使用
%变量名%格式引用存储的数据 - 支持复杂数据类型的存储和引用
6.3 循环嵌套
可以创建复杂的嵌套循环结构，实现更复杂的自动化流程。
7. 总结
ControlFlowUtils是一个功能极其强大的插件，它为ComfyUI带来了真正的编程能力。通过合理使用这些节点，你可以创建出非常智能和自动化的工作流程，大大提高工作效率。
记住这几个要点：
- 循环节点需要正确的三件套连接
- 条件判断要仔细设置比较条件
- 及时清理内存避免资源不足
- 善用内存存储在不同执行间传递数据
希望这个教程能帮助你更好地使用这个强大的插件！