ComfyUI-EnumCombo 是一款轻量级、无依赖的 ComfyUI 自定义节点,解决工作流中“魔法数字”(Magic Numbers)难以维护的问题。它允许用户通过定义清晰的文本标签(如 TXT2IMG, IMG2IMG)来生成对应的整数值(INT),并通过下拉菜单进行选择,从而替代晦涩难懂的纯数字输入。
- GitHub:https://github.com/SparknightLLC/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-EnumCombo | CRZnodes (Custom Dropdown) |
|---|---|---|
| 依赖项 | ✅ 无 | ❌ 需安装完整插件包 |
| 功能范围 | 专注枚举转整数 | 通用数据映射、仪表盘组件 |
| 复杂性 | 极低,单一职责 | 较高,功能繁多 |
| 适用性 | 轻量级逻辑控制 | 复杂 UI 构建、任意数据映射 |
建议:如果你只需要一个简单的“下拉选数字”功能,ComfyUI-EnumCombo 是更轻量的选择;如果你需要构建复杂的控制面板或映射任意数据类型,CRZnodes 可能更适合。
快速开始
安装
通过 ComfyUI Manager 搜索 ComfyUI-EnumCombo 并安装,或手动克隆到 custom_nodes 目录:
cd ComfyUI/custom_nodes
git clone https://github.com/[作者用户名]/ComfyUI-EnumCombo.git
使用示例
- 添加节点:在工作流中添加
Enum Combo节点。 - 定义枚举:
- 如果使用 Advanced 版本,直接在节点内的文本框输入:
LOW MEDIUM HIGH - 如果使用 Compact 版本,创建一个包含上述文本的 primitive 节点或字符串常量,连接到
enum_definition输入端。
- 如果使用 Advanced 版本,直接在节点内的文本框输入:
- 连接输出将节点的
value(INT) 输出连接到需要整数控制的节点(如Switch节点的switch_index)。 - 选择值:点击下拉菜单,选择
MEDIUM,下游节点将接收到对应的整数值(例如1)。
© 版权声明
文章版权归作者所有,未经允许请勿转载。









