%20(1).png)
ComfyUI Zygion 实用工具节点插件教程
1. 插件简介
插件地址： https://github.com/zygion/comfyui-zygion-util-nodes
这个插件是一套专门为 ComfyUI 设计的实用工具节点合集，就像是给你的图像生成工作台增加了一套万能工具箱。这个插件主要解决的是让你的工作流程更加灵活和自动化，特别适合那些需要批量处理、模板化操作和复杂场景管理的朋友。
主要功能亮点： - 让你能够像制作购物清单一样管理各种元素（Item List 节点） - 提供模板功能，就像用印章一样可以重复使用相同的设置（Template Input 和 Template Processor 节点） - 帮你排队处理不同的场景，就像银行排号一样井井有条（Scene Queue 节点） - 提供智能开关功能，让数据在需要的时候才通过（Trigger Passthrough 节点）
2. 如何安装
方法一：使用 ComfyUI Manager（推荐）
- 在 ComfyUI 界面中打开 Manager 管理器
- 搜索 "i-zygion-util-nodes" 或者 "zygion"
- 点击安装按钮
- 重启 ComfyUI
方法二：手动安装
- 打开命令行工具（Windows 用户打开 cmd，Mac 用户打开终端）
- 进入你的 ComfyUI 安装目录下的 custom_nodes 文件夹
- 执行命令：
git clone https://github.com/zygion/comfyui-zygion-util-nodes - 重启 ComfyUI
3. 节点详细解析
3.1 Item List 节点 - 物品清单管理器
这个节点就像是一个智能的购物清单或者待办事项列表。你可以把各种元素（比如不同的文字描述、数字参数等）放进一个列表里，然后让工作流程按顺序或者按规则来使用这些元素。
3.2 Item List 节点参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 物品列表 | item_list | 文本输入 | 每行一个项目 | 就像写购物清单一样，每行写一个要用的东西 | 定义要循环使用的元素列表 | 第一行写"可爱小猫"，第二行写"威猛老虎"，第三行写"温顺小狗" |
| 选择模式 | selection_mode | 顺序/随机/指定 | 顺序 | 决定怎么从清单里挑东西，像排队还是抽签 | 控制元素选择的逻辑方式 | 选"顺序"就是按照你写的顺序来，选"随机"就是随机抽一个 |
| 当前索引 | current_index | 数字 | 0 | 告诉节点现在要用清单里的第几个东西 | 指定当前要使用的列表项位置 | 填0就是第一个，填1就是第二个，以此类推 |
3.3 Template Input 节点 - 模板输入器
这个节点就像是一个可以重复使用的印章模板。你可以设计一个基础的模板，然后在需要的地方留空白，之后可以往这些空白处填入不同的内容。
3.4 Template Input 节点参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 模板文本 | template_text | 文本 | 带占位符的文本 | 就像填空题，用{}包起来的地方就是要填的空 | 包含变量占位符的文本模板 | "一只{颜色}的{动物}在{地点}里{动作}" |
| 变量1 | variable_1 | 文本 | 根据需要 | 填第一个空白的内容 | 第一个模板变量的值 | 如果模板里有{颜色}，这里就填"红色" |
| 变量2 | variable_2 | 文本 | 根据需要 | 填第二个空白的内容 | 第二个模板变量的值 | 如果模板里有{动物}，这里就填"小猫" |
| 变量3 | variable_3 | 文本 | 根据需要 | 填第三个空白的内容 | 第三个模板变量的值 | 如果模板里有{地点}，这里就填"花园" |
3.5 Template Processor 节点 - 模板处理器
这个节点是 Template Input 的好搭档，专门负责把模板和变量组合起来，输出最终的结果。就像是一个自动的文字组装工厂。
3.6 Template Processor 节点参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入模板 | input_template | 模板输入 | 来自Template Input | 接收别的节点传过来的模板 | 接收模板数据的输入端口 | 连接Template Input节点的输出 |
| 处理模式 | process_mode | 单次/批量 | 单次 | 决定是一次处理一个还是一口气处理很多个 | 控制模板处理的批次方式 | 选"单次"就处理一个，选"批量"就一次处理多个模板 |
| 输出格式 | output_format | 文本/JSON | 文本 | 决定最后出来的结果是普通文字还是特殊格式 | 指定输出数据的格式类型 | 一般选"文本"就够用了，除非需要特殊数据格式 |
3.7 Scene Queue Node 节点 - 场景队列管理器
这个节点就像是一个智能的排队系统，可以让你预先设置好很多不同的场景（比如不同的角色、背景、风格等），然后按顺序或者按规则来处理这些场景。
3.8 Scene Queue Node 节点参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 场景列表 | scene_list | JSON格式 | 按需配置 | 就像电影剧本，每个场景都有自己的设定 | 定义所有待处理场景的配置数据 | {"scene1": {"prompt": "森林小屋", "style": "卡通"}, "scene2": {"prompt": "现代都市", "style": "写实"}} |
| 队列模式 | queue_mode | 顺序/优先级 | 顺序 | 决定是按顺序排队还是重要的先处理 | 控制场景处理的优先级逻辑 | 选"顺序"就像银行排号，选"优先级"就像急诊科分诊 |
| 当前场景 | current_scene | 数字 | 0 | 告诉节点现在要处理第几个场景 | 指定当前要处理的场景索引 | 0表示第一个场景，1表示第二个场景 |
| 自动推进 | auto_advance | 开启/关闭 | 关闭 | 决定是否自动跳到下一个场景 | 控制是否自动推进到下一场景 | 开启后处理完当前场景会自动跳到下一个 |
3.9 Trigger Passthrough Node 节点 - 触发通道节点
这个节点就像是一个智能的开关或者闸门，只有在满足特定条件的时候才会让数据通过。就像是门卫一样，检查证件合格才放行。
3.10 Trigger Passthrough Node 节点参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 触发条件 | trigger_condition | 布尔值 | False | 就像开关，True就是开，False就是关 | 控制数据通过的布尔条件 | 设为True时数据才能通过，False时就被拦住 |
| 输入数据 | input_data | 任意类型 | 根据需要 | 要通过这个节点的数据，就像过安检的行李 | 需要被条件控制的输入数据 | 可以是文字、图片、数字等任何东西 |
| 默认值 | default_value | 任意类型 | None | 当条件不满足时输出的备用值 | 触发条件为False时的替代输出 | 比如条件不满足时输出空白或者默认图片 |
| 反向模式 | invert_mode | 开启/关闭 | 关闭 | 把开关的逻辑颠倒过来 | 反转触发条件的逻辑判断 | 开启后True变成拦截，False变成通过 |
4. 使用技巧和建议
4.1 组合使用技巧
-
模板+列表组合：把 Item List 的输出连接到 Template Input 的变量输入，可以实现批量模板填充，就像批量制作个性化邀请函一样。
-
场景队列管理：使用 Scene Queue Node 来管理复杂的工作流程，特别适合需要生成系列图片的情况，比如制作故事书或者角色设定集。
-
条件控制流程：用 Trigger Passthrough Node 来控制工作流程的分支，根据不同条件执行不同的处理路径。
4.2 性能优化建议
- 合理设置队列大小：Scene Queue 不要一次性加载太多场景，建议控制在10个以内
- 模板重用：设计通用的模板可以大大提高工作效率
- 条件优化：Trigger 节点的条件判断要尽量简单，避免复杂的逻辑
5. 常见问题解答
5.1 安装相关问题
Q: 安装后找不到节点怎么办？ A: 重启 ComfyUI，然后在节点菜单中搜索 "zygion" 或者 "util"
Q: 插件与其他节点冲突怎么办？ A: 检查是否有同名的节点，可以尝试禁用其他类似的插件
5.2 使用相关问题
Q: Item List 支持什么格式的内容？ A: 支持纯文本、数字、简单的 JSON 格式，每行一个项目
Q: Template 的占位符有格式要求吗？ A: 使用 {变量名} 的格式，变量名要和输入的变量对应
Q: Scene Queue 可以保存设置吗？ A: 可以把场景配置保存为 JSON 文件，下次直接加载使用
5.3 高级使用问题
Q: 如何实现循环处理？ A: 结合 Scene Queue 的自动推进功能和外部的循环控制节点
Q: 可以嵌套使用模板吗？ A: 可以，Template Processor 的输出可以作为另一个 Template Input 的输入
6. 实际应用案例
6.1 批量角色设定生成
使用 Item List 存储不同的角色名称，Template Input 设计角色描述模板，Template Processor 组合生成，最后用 Scene Queue 按顺序处理每个角色。
6.2 条件化风格切换
用 Trigger Passthrough 根据不同条件切换不同的风格设定，实现智能的风格适配。
6.3 故事情节自动化
结合所有节点创建一个完整的故事生成流水线，从角色设定到场景描述，再到最终的图像生成。
这个插件虽然节点不多，但每个都很实用，特别适合需要批量处理和模板化操作的场景。通过合理组合这些节点，可以大大提高你的工作效率，让复杂的工作流程变得简单有序。记住，熟练使用这些工具的关键是多实践，从简单的应用开始，逐步探索更复杂的组合方式。