ComfyUI-EnumCombo:让工作流控制更清晰、更易读

插件7个月前发布 小马良
264 0

ComfyUI-EnumCombo 是一款轻量级、无依赖的 ComfyUI 自定义节点,解决工作流中“魔法数字”(Magic Numbers)难以维护的问题。它允许用户通过定义清晰的文本标签(如 TXT2IMG, IMG2IMG)来生成对应的整数值(INT),并通过下拉菜单进行选择,从而替代晦涩难懂的纯数字输入。

  • GitHub:https://github.com/SparknightLLC/ComfyUI-EnumCombo
ComfyUI-EnumCombo:让工作流控制更清晰、更易读

核心目的

在复杂的 ComfyUI 工作流中,我们经常需要使用整数来控制逻辑分支、开关状态或变量索引。例如:

  • 0 代表文生图
  • 1 代表图生图
  • 2 代表重绘

直接使用数字不仅容易出错,而且随着时间推移,开发者很难记住每个数字代表的含义。ComfyUI-EnumCombo 通过引入**枚举(Enum)**概念,将这些数字映射为可读的文本标签,既保持了后端逻辑对 INT 类型的需求,又提升了前端交互的可读性和可维护性。

主要特性

1. 直观的枚举定义语法

支持类似编程语言的枚举定义方式:

  • 自动递增:默认从 0 开始自动赋值。
  • 显式赋值:支持手动指定起始值,后续值自动递增。
  • 空格支持:使用引号包裹包含空格的标签。
  • 注释支持:支持 #, //, /* */ 多种注释格式。

示例:

# 基础定义
TXT2IMG
IMG2IMG
INPAINT

# 显式赋值与空格标签
"Text to Image" = 3
"Image to Image"  # 自动变为 4
"Inpaint Masked"  # 自动变为 5

2. 两种节点模式

节点名称特点适用场景
Enum Combo紧凑版。仅输出 INT 值。下拉菜单内容通过外部链接动态更新。需要极简界面、频繁切换枚举定义的复杂工作流。
Enum Combo Advanced高级版。内置多行文本编辑器定义枚举。输出 INT, STRING (名称), INDEX (位置), COUNT (总数)。需要获取枚举元数据、或在节点内直接编辑定义的独立模块。

3. 轻量且无依赖

  • 零第三方依赖:纯原生 Python 实现,不引入额外的库负担。
  • 严格类型输出:只输出标准的 INT 和 STRING,确保与其他节点(如 Switch, Set/Get Variable)的完美兼容。
  • 无 Monkey-patching:不修改 ComfyUI 核心行为,稳定性高。

🆚 与 CRZnodes 等替代方案的对比

特性ComfyUI-EnumComboCRZnodes (Custom Dropdown)
依赖项✅ 无❌ 需安装完整插件包
功能范围专注枚举转整数通用数据映射、仪表盘组件
复杂性极低,单一职责较高,功能繁多
适用性轻量级逻辑控制复杂 UI 构建、任意数据映射

建议:如果你只需要一个简单的“下拉选数字”功能,ComfyUI-EnumCombo 是更轻量的选择;如果你需要构建复杂的控制面板或映射任意数据类型,CRZnodes 可能更适合。

快速开始

安装

通过 ComfyUI Manager 搜索 ComfyUI-EnumCombo 并安装,或手动克隆到 custom_nodes 目录:

cd ComfyUI/custom_nodes
git clone https://github.com/[作者用户名]/ComfyUI-EnumCombo.git

使用示例

  1. 添加节点:在工作流中添加 Enum Combo 节点。
  2. 定义枚举:
    • 如果使用 Advanced 版本,直接在节点内的文本框输入:
      LOW
      MEDIUM
      HIGH
      
    • 如果使用 Compact 版本,创建一个包含上述文本的 primitive 节点或字符串常量,连接到 enum_definition 输入端。
  3. 连接输出将节点的 value (INT) 输出连接到需要整数控制的节点(如 Switch 节点的 switch_index)。
  4. 选择值:点击下拉菜单,选择 MEDIUM,下游节点将接收到对应的整数值(例如 1)。
© 版权声明

相关文章