ComfyUI-FlowBranch

用于多阶段图像处理的无线结果与惰性流程编排节点。节点位于 流程分支 分类。

三个节点

旧版“阶段开关 / 多路方案 / 条件选择”只为兼容已经保存的工作流保留，已标记为弃用，不会出现在新增节点菜单中。

把生图结果连接到 发送结果 的“数据”，结果名称填写：

原始图像

在 流程编排器 中设置：

起点结果：原始图像
最终发布为：最终图像

点击“添加阶段”，把阶段结果名称改为“修脸后”，把方案名称改为“FaceDetailer”。

修脸处理链必须这样开始和结束：

读取结果（原始图像） -> FaceDetailer -> 流程编排器的 FaceDetailer 方案插槽

再次点击“添加阶段”，把阶段结果名称改为“放大后”。使用“添加方案”加入任意数量的放大方法，例如：

读取结果（修脸后） -> 放大方法 A -> 方案 A 插槽
读取结果（修脸后） -> 放大方法 B -> 方案 B 插槽
读取结果（修脸后） -> 放大方法 C -> 方案 C 插槽

有两种选择方式：

两种模式都只会把最终选中的方案接入执行依赖，其余方案不会由流程编排器触发。

可以直接使用流程编排器的“流程结果”输出，也可以在其他位置添加：

读取结果（最终图像） -> 保存图片

操作	结果
关闭阶段开关	不执行该阶段的任何方案，直接沿用上一阶段
选择“跳过本阶段”	阶段保持启用，但本次不执行处理方案
选中的方案没有连接	自动沿用上一阶段，并显示黄色状态
选中的方案已经连接	只执行这个方案
开启“自动选择可用方案”	从上到下选择第一个可用方案；全部不可用时沿用上一阶段
自动模式发现多个可用方案	只选择最上面的方案并给出提示
起点或全部输入被 Bypass	缺失连线按“未连接”处理；使用它的可选端口不会阻止节点继续运行
删除方案或阶段	对应动态插槽和连线一并安全移除

每个阶段标题都会显示它应该读取的上一结果，例如“读取：修脸后”。选中的处理方案必须从同名 读取结果 节点开始。

使用组 Bypass（Ctrl+B）管理自动方案时，应把该方案末端的“发送结果”也放进同一个组。这样整组被 Bypass 后，对应命名结果会从队列 Prompt 中消失，自动模式才能准确判定它不可用。

如果“放大后”方案错误地读取了“原始图像”，编译器会明确报错并停止该流程，防止跳过修脸后仍继续放大和保存。

“读取结果”找不到同名发布位置且没有回退输入时，排队前会移除对应连线，效果与该端口从未连接完全相同。普通节点的可选输入缺失时仍可继续运行；必填输入缺失时则显示 ComfyUI 原生的缺少输入错误。名称重复、循环依赖和阶段顺序错误仍然是明确的配置错误。

排队时，可见流程会展开成真正的 ComfyUI 懒执行依赖。实现不使用 Python 全局变量，不依赖节点摆放顺序，也不会重新序列化工作流或修改其他节点的随机种子。

阶段、方案、名称、顺序、开关、当前选择和动态输入 ID 都保存在节点自身的普通工作流数据中。切换工作流、保存后重新打开、复制节点都会保留这些信息，不依赖浏览器缓存或工作流外文件。