初始化

README.md

@@ -0,0 +1,98 @@
+# ComfyUI-FlowBranch
+
+用于多阶段图像处理的无线结果与惰性流程编排节点。节点位于 **流程分支** 分类。
+
+## 三个节点
+
+- **发送结果**：给一份数据起一个可读名称，例如“原始图像”。
+- **流程编排器**：按顺序管理所有处理阶段；阶段和每个阶段的方案数量都没有固定上限。
+- **读取结果**：在任意位置读取“原始图像”“修脸后”“放大后”或“最终图像”等命名结果。
+
+旧版“阶段开关 / 多路方案 / 条件选择”只为兼容已经保存的工作流保留，已标记为弃用，不会出现在新增节点菜单中。
+
+## 示例：生图、可选修脸、三种可选放大
+
+### 1. 发布起点
+
+把生图结果连接到 **发送结果** 的“数据”，结果名称填写：
+
+```text
+原始图像
+```
+
+### 2. 添加修脸阶段
+
+在 **流程编排器** 中设置：
+
+```text
+起点结果：原始图像
+最终发布为：最终图像
+```
+
+点击“添加阶段”，把阶段结果名称改为“修脸后”，把方案名称改为“FaceDetailer”。
+
+修脸处理链必须这样开始和结束：
+
+```text
+读取结果（原始图像） -> FaceDetailer -> 流程编排器的 FaceDetailer 方案插槽
+```
+
+### 3. 添加放大阶段
+
+再次点击“添加阶段”，把阶段结果名称改为“放大后”。使用“添加方案”加入任意数量的放大方法，例如：
+
+```text
+读取结果（修脸后） -> 放大方法 A -> 方案 A 插槽
+读取结果（修脸后） -> 放大方法 B -> 方案 B 插槽
+读取结果（修脸后） -> 放大方法 C -> 方案 C 插槽
+```
+
+有两种选择方式：
+
+- 手动模式：用每行左侧的单选按钮选择本次运行的方案。
+- 自动模式：开启“自动选择可用方案”，按从上到下的顺序选择第一个未被 Bypass 且确实有结果的方案。
+
+两种模式都只会把最终选中的方案接入执行依赖，其余方案不会由流程编排器触发。
+
+### 4. 使用最终结果
+
+可以直接使用流程编排器的“流程结果”输出，也可以在其他位置添加：
+
+```text
+读取结果（最终图像） -> 保存图片
+```
+
+## 阶段行为
+
+| 操作 | 结果 |
+| --- | --- |
+| 关闭阶段开关 | 不执行该阶段的任何方案，直接沿用上一阶段 |
+| 选择“跳过本阶段” | 阶段保持启用，但本次不执行处理方案 |
+| 选中的方案没有连接 | 自动沿用上一阶段，并显示黄色状态 |
+| 选中的方案已经连接 | 只执行这个方案 |
+| 开启“自动选择可用方案” | 从上到下选择第一个可用方案；全部不可用时沿用上一阶段 |
+| 自动模式发现多个可用方案 | 只选择最上面的方案并给出提示 |
+| 起点或全部输入被 Bypass | 缺失连线按“未连接”处理；使用它的可选端口不会阻止节点继续运行 |
+| 删除方案或阶段 | 对应动态插槽和连线一并安全移除 |
+
+## 顺序保护
+
+每个阶段标题都会显示它应该读取的上一结果，例如“读取：修脸后”。选中的处理方案必须从同名 **读取结果** 节点开始。
+
+使用组 Bypass（`Ctrl+B`）管理自动方案时，应把该方案末端的“发送结果”也放进同一个组。这样整组被 Bypass 后，对应命名结果会从队列 Prompt 中消失，自动模式才能准确判定它不可用。
+
+如果“放大后”方案错误地读取了“原始图像”，编译器会明确报错并停止该流程，防止跳过修脸后仍继续放大和保存。
+
+“读取结果”找不到同名发布位置且没有回退输入时，排队前会移除对应连线，效果与该端口从未连接完全相同。普通节点的可选输入缺失时仍可继续运行；必填输入缺失时则显示 ComfyUI 原生的缺少输入错误。名称重复、循环依赖和阶段顺序错误仍然是明确的配置错误。
+
+排队时，可见流程会展开成真正的 ComfyUI 懒执行依赖。实现不使用 Python 全局变量，不依赖节点摆放顺序，也不会重新序列化工作流或修改其他节点的随机种子。
+
+## 保存与复制
+
+阶段、方案、名称、顺序、开关、当前选择和动态输入 ID 都保存在节点自身的普通工作流数据中。切换工作流、保存后重新打开、复制节点都会保留这些信息，不依赖浏览器缓存或工作流外文件。
+
+## 快捷操作
+
+- 右键 **发送结果**，选择“创建配对读取”，会在右侧创建一个同名 **读取结果**。
+- 右键 **流程编排器**，选择“创建结果读取节点”，可以直接为任意阶段或最终结果创建读取节点。
+- 右键 **读取结果** 选择“跳转到发送位置”，或直接双击节点，可以返回唯一的发送节点；名称冲突时不会擅自选择。