%20(1).png)
ComfyUI-EZ-AF-Nodes 插件新手保姆级教程
1. 插件简介
GitHub原地址： https://github.com/ez-af/ComfyUI-EZ-AF-Nodes
这个插件就像是给ComfyUI装了一个"智能提示词管理器"。平时我们写提示词都是一个个手打，很麻烦对吧？这个插件就是让你可以：
- 把常用的提示词保存在文件里，想用的时候直接点击选择，就像从菜单里点菜一样简单
- 从Excel表格（CSV文件）里读取提示词，一次性管理成百上千个提示词
- 把多个提示词自动组合起来，不用再一个个复制粘贴了
- 随机选择提示词，让每次生成的图片都有惊喜
简单说就是：让提示词管理变得像用美图秀秀选滤镜一样简单！
2. 如何安装
方法一：使用ComfyUI管理器（推荐）
- 先安装ComfyUI管理器（如果还没装的话）
- 重启ComfyUI
- 打开管理器，搜索"ez-af"
- 点击安装
方法二：手动安装
- 在ComfyUI的"custom_nodes"文件夹里，打开命令行
- 输入：
git clone https://github.com/ez-af/ComfyUI-EZ-AF-Nodes.git - 重启ComfyUI
重要提醒： 这个插件需要先安装"pythongosssss Custom Scripts"才能正常工作，记得先装这个依赖！
3. 节点逐一解析
3.1 EZ File Loader（文件加载器）- 从文本文件读取提示词
这个节点就像一个"提示词相册"，你可以把经常用的提示词保存成文件，然后用这个节点来选择和使用。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 文件选择 | file_path | 文件路径 | 根据需要选择 | 选择你要读取的文本文件，就像选择要播放的歌曲一样 | 指定要加载的文本文件路径 | 选择"人物描述.txt"文件 |
| 模式 | mode | single/multiple/random | single | 决定怎么选择提示词：单选、多选还是随机 | 选择输出模式：单个、多个或随机 | single=一次只选一个，multiple=可以选多个，random=随机选一个 |
| 种子 | seed | 数字 | 0 | 控制随机选择的"骰子"，相同数字会得到相同结果 | 用于随机模式的随机种子 | 种子设为123，每次都会随机到相同的提示词 |
3.2 EZ CSV Loader（表格加载器）- 从CSV文件读取提示词
这个节点就像一个"提示词数据库"，可以从Excel表格（CSV格式）里读取整理好的提示词。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| CSV文件 | csv_file | 文件路径 | 根据需要选择 | 选择你的Excel表格文件，就像选择通讯录一样 | 指定要加载的CSV文件路径 | 选择"角色设定.csv"文件 |
| 行选择 | row_selection | 行号 | 1 | 选择表格的第几行数据，就像选择菜单的第几道菜 | 指定要读取的数据行 | 选择第3行就会读取表格第3行的所有内容 |
| 模式 | mode | single/multiple/random | single | 决定怎么选择表格行：单选、多选还是随机 | 选择输出模式：单个、多个或随机 | single=选一行，multiple=选多行，random=随机选一行 |
| 种子 | seed | 数字 | 0 | 控制随机选择的"骰子"，相同数字会得到相同结果 | 用于随机模式的随机种子 | 种子设为456，每次都会随机到相同的表格行 |
3.3 EZ Tag Loader（标签加载器）- 从标签文件读取
这个节点就像一个"标签贴纸册"，可以从标签文件里选择各种描述标签。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 标签文件 | tag_file | 文件路径 | 根据需要选择 | 选择你的标签文件，就像选择贴纸册一样 | 指定要加载的标签文件路径 | 选择"风格标签.txt"文件 |
| 附加文本 | additional_text | 文本 | 空 | 在每个标签后面添加额外的文字，就像给贴纸加个边框 | 在每个标签后添加的文本内容 | 输入"风格"，标签"可爱"就变成"可爱风格" |
| 模式 | mode | single/multiple/random | single | 决定怎么选择标签：单选、多选还是随机 | 选择输出模式：单个、多个或随机 | single=选一个标签，multiple=选多个标签，random=随机选标签 |
| 种子 | seed | 数字 | 0 | 控制随机选择的"骰子"，相同数字会得到相同结果 | 用于随机模式的随机种子 | 种子设为789，每次都会随机到相同的标签 |
3.4 EZ Concatenate（文本拼接器）- 把多个文本合并
这个节点就像一个"文字胶水"，可以把多个不同的文本粘在一起，中间还可以加各种连接符。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入1 | input1 | 文本 | 空 | 第一个要拼接的文本，就像做三明治的第一层 | 第一个输入文本 | 输入"美丽的女孩" |
| 输入2 | input2 | 文本 | 空 | 第二个要拼接的文本，就像做三明治的第二层 | 第二个输入文本 | 输入"长发飘逸" |
| 输入3 | input3 | 文本 | 空 | 第三个要拼接的文本，就像做三明治的第三层 | 第三个输入文本 | 输入"微笑着" |
| 分隔符 | delimiter | 文本 | ", " | 文本之间的连接符，就像三明治层之间的酱料 | 用于分隔各个输入文本的字符 | 用","分隔，结果是"美丽的女孩, 长发飘逸, 微笑着" |
| 美化输出 | beautify | 开关 | 开启 | 自动整理文本格式，就像给文字做美容一样 | 是否对输出文本进行格式美化 | 开启后会自动去除多余空格和标点 |
3.5 EZ Switch（选择器）- 从多个输入中选一个
这个节点就像一个"遥控器"，可以从多个输入中选择其中一个输出，支持按顺序选、随机选或自动选。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入1 | input1 | 任意类型 | 空 | 第一个候选项，就像遥控器的1号频道 | 第一个输入选项 | 可以是文本、图片、模型等任何东西 |
| 输入2 | input2 | 任意类型 | 空 | 第二个候选项，就像遥控器的2号频道 | 第二个输入选项 | 可以是文本、图片、模型等任何东西 |
| 输入3 | input3 | 任意类型 | 空 | 第三个候选项，就像遥控器的3号频道 | 第三个输入选项 | 可以是文本、图片、模型等任何东西 |
| 选择模式 | mode | index/random/automatic | index | 选择方式：按编号选、随机选还是自动选 | 选择输入的模式 | index=按编号选，random=随机选，automatic=自动选第一个有内容的 |
| 索引 | index | 数字 | 0 | 当选择"按编号选"时，选择第几个输入 | 指定要选择的输入索引 | 设为1就选择第一个输入，设为2就选择第二个输入 |
| 种子 | seed | 数字 | 0 | 控制随机选择的"骰子"，相同数字会得到相同结果 | 用于随机模式的随机种子 | 种子设为999，每次都会随机到相同的输入 |
3.6 EZ Extract Prompt（提示词提取器）- 从文本中提取特定部分
这个节点就像一个"文字筛子"，可以从一大段文本中提取出你需要的特定部分。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入文本 | input_text | 文本 | 空 | 要处理的原始文本，就像一本书 | 包含多个部分的原始文本 | 输入"[人物=美女][场景=海边][风格=写实]" |
| 提取标识 | header | 文本 | 空 | 要提取的部分标识，就像书的章节标题 | 用于识别要提取内容的标识符 | 输入"人物"就会提取"美女"这部分 |
| 提取所有 | extract_all | 开关 | 关闭 | 是否提取所有非标识部分，就像提取整本书除了目录的所有内容 | 是否提取所有非标识符的内容 | 开启后会提取所有方括号外的内容 |
3.7 EZ Extract Size（尺寸提取器）- 从文本中提取宽高数值
这个节点就像一个"尺寸探测器"，可以从文本中自动找出宽度和高度的数字。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入文本 | input_text | 文本 | 空 | 包含尺寸信息的文本，就像商品说明书 | 包含宽高数值的文本字符串 | 输入"图片尺寸1024x768像素" |
| 宽度输出 | width | 数字 | 0 | 自动识别出的宽度数值，就像商品的长度 | 从文本中提取的宽度值 | 会自动输出1024 |
| 高度输出 | height | 数字 | 0 | 自动识别出的高度数值，就像商品的高度 | 从文本中提取的高度值 | 会自动输出768 |
3.8 EZ String Input（字符串输入器）- 万能文本输入
这个节点就像一个"万能插头"，可以把文本当作任何类型的数据输出，让文本能连接到原本不支持文本的地方。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 文本内容 | text | 文本 | 空 | 你想输入的文本内容，就像在便签上写字 | 要输入的文本字符串 | 输入"masterpiece, best quality" |
| 输出类型 | output_type | ANY | ANY | 输出的数据类型，设为ANY就是万能类型 | 指定输出数据的类型 | 设为ANY可以连接到任何需要文本的地方 |
4. 使用技巧和建议
4.1 文件组织技巧
- 在插件的"data"文件夹里按类型整理你的文件：
- PROMPTS文件夹：放人物、场景、风格等文本文件
- CSV文件夹：放表格文件
- TAGS文件夹：放标签文件
- THUMBNAILS文件夹：放缩略图（与文本文件同名的PNG图片）
4.2 提示词管理技巧
- 把常用的提示词按主题分类保存，比如"人物.txt"、"场景.txt"、"风格.txt"
- 使用CSV文件可以创建更复杂的提示词数据库，每列代表不同的属性
- 利用随机模式可以创造惊喜效果，让每次生成都不一样
4.3 工作流优化技巧
- 使用EZ Concatenate节点可以避免堆叠太多的文本合并节点
- EZ Switch节点可以轻松切换不同的模型、提示词或设置
- 合理使用种子参数可以确保结果的可重复性
5. 常见问题解答
Q1: 为什么节点显示错误或无法正常工作？
A: 确保你已经安装了"pythongosssss Custom Scripts"依赖，这是必需的前置插件。
Q2: 如何添加缩略图？
A: 在THUMBNAILS文件夹里放置与文本文件同名的PNG图片，比如"人物.txt"对应"人物.png"。
Q3: CSV文件应该怎么格式化？
A: 第一行应该是标题行（比如"人物,场景,风格"），后面每行是对应的数据。
Q4: 随机模式每次都一样怎么办？
A: 检查是否连接了种子输入，如果连接了固定的种子值，随机结果就会固定。
Q5: EZ Switch节点报错"类型不匹配"怎么办？
A: 确保你连接的输入类型与接收节点期望的类型匹配，虽然EZ Switch支持任意类型，但接收端可能有限制。
6. 实际应用场景
场景1：角色卡生成器
使用CSV文件存储不同角色的属性（姓名、外貌、服装、表情等），通过EZ CSV Loader随机或选择性地生成角色描述。
场景2：风格切换器
用EZ Switch节点在多个艺术风格之间快速切换，比如写实、动漫、油画等风格。
场景3：批量提示词测试
使用EZ Tag Loader的多选模式，一次性测试多个不同的修饰词效果。
场景4：智能提示词组合
结合多个EZ File Loader节点，分别加载人物、场景、风格等不同类型的提示词，用EZ Concatenate自动组合成完整的提示词。
这个插件就像是给ComfyUI装上了一套"提示词管理系统"，让复杂的提示词工作变得简单有序。无论是新手还是老手，都能通过这个插件大大提高工作效率！