YMC Node Suite ComfyUI 插件完整教程

1. 插件简介

YMC Node Suite ComfyUI 是一个功能丰富的 ComfyUI 自定义节点插件包，提供了包括文本处理、区域管理和输入输出操作在内的实用功能。

插件地址： https://github.com/YMC-GitHub/ymc-node-suite-comfyui

这个插件就像是给你的 ComfyUI 装了一个"瑞士军刀"，里面有各种小工具，能帮你更方便地处理文字、管理文件、组织提示词等。特别适合那些需要经常处理文本内容、管理多个文件路径，或者想要更精细控制 AI 绘画过程的朋友。

2. 如何安装

方法一：手动安装

1. 打开你的 ComfyUI 安装目录
2. 找到 custom_nodes 文件夹
3. 在命令行中输入： git clone https://github.com/YMC-GitHub/ymc-node-suite-comfyui.git
4. 重启 ComfyUI

方法二：ComfyUI Manager 安装

1. 打开 ComfyUI Manager
2. 搜索 "ymc-node-suite-comfyui"
3. 点击安装
4. 重启 ComfyUI

安装完成后，你可以在节点搜索框中输入 "ymc suite" 来找到这些节点，或者右键菜单中找到 "ymc suite" 分类。

3. 节点逐一解析

3.1 text-util-prompt-join 节点：文字拼接器

这个节点就像一个"文字打包机"，可以把多个分散的文字片段组合成一个完整的提示词。比如你有几段描述，想要把它们合并成一个完整的画面描述。

3.1.1 参数详解

| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :— | :— | :— | :— | :— | :— | :— | | 文本1 | text1 | 文本输入 | 空或主要描述 | 第一段要合并的文字 | 第一个文本字符串输入 | 输入"一个美丽的女孩" | | 文本2 | text2 | 文本输入 | 空或补充描述 | 第二段要合并的文字 | 第二个文本字符串输入 | 输入"长发飘飘" | | 文本3 | text3 | 文本输入 | 空或细节描述 | 第三段要合并的文字 | 第三个文本字符串输入 | 输入"穿着白色连衣裙" | | 分隔符 | separator | 字符串 | ", " | 文字之间用什么连接 | 文本拼接的分隔符 | 用逗号空格分开，或者用"and"连接 | | 输出格式 | format | 选择项 | "joined" | 最终文字的排列方式 | 输出文本的格式化方式 | 选择直接拼接还是格式化输出 |

3.2 text-util-path-list 节点：路径管理器

这个节点就像一个"地址簿"，可以帮你管理多个文件路径，让你不用每次都手动输入长长的文件地址。

3.2.1 参数详解

| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :— | :— | :— | :— | :— | :— | :— | | 路径1 | path1 | 文件路径 | 空或常用路径 | 第一个文件的存放地址 | 第一个文件系统路径 | 输入"C:\images\models\" | | 路径2 | path2 | 文件路径 | 空或常用路径 | 第二个文件的存放地址 | 第二个文件系统路径 | 输入"D:\outputs\" | | 路径3 | path3 | 文件路径 | 空或常用路径 | 第三个文件的存放地址 | 第三个文件系统路径 | 输入"E:\temp\" | | 路径4 | path4 | 文件路径 | 空或常用路径 | 第四个文件的存放地址 | 第四个文件系统路径 | 输入"F:\backup\" | | 路径5 | path5 | 文件路径 | 空或常用路径 | 第五个文件的存放地址 | 第五个文件系统路径 | 输入"G:\projects\" | | 路径6 | path6 | 文件路径 | 空或常用路径 | 第六个文件的存放地址 | 第六个文件系统路径 | 输入"H:\resources\" | | 路径7 | path7 | 文件路径 | 空或常用路径 | 第七个文件的存放地址 | 第七个文件系统路径 | 输入"I:\archives\" | | 输出索引 | output_index | 数字 | 0 | 选择输出哪个路径 | 指定输出的路径索引 | 输入0输出第一个路径，输入1输出第二个路径 |

3.3 cutoff-region-util 节点：区域文字生成器

这个节点就像一个"区域标签机"，可以帮你给画面的不同区域创建带有权重的文字描述，让 AI 知道在画面的哪个位置画什么内容。

3.3.1 参数详解

| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :— | :— | :— | :— | :— | :— | :— | | 区域文本 | region_text | 文本输入 | 描述性文字 | 这个区域要画什么内容 | 区域对应的文本描述 | 输入"beautiful face" | | 权重 | weight | 数字 | 1.0 | 这个区域的重要程度 | 文本权重数值 | 输入1.2表示比较重要，0.8表示不太重要 | | X坐标 | x_coord | 数字 | 0 | 区域在画面中的左右位置 | 区域的X轴坐标 | 输入100表示距离左边100个像素 | | Y坐标 | y_coord | 数字 | 0 | 区域在画面中的上下位置 | 区域的Y轴坐标 | 输入50表示距离顶部50个像素 | | 宽度 | width | 数字 | 100 | 区域的宽度大小 | 区域的像素宽度 | 输入200表示区域宽200像素 | | 高度 | height | 数字 | 100 | 区域的高度大小 | 区域的像素高度 | 输入150表示区域高150像素 | | 启用 | enable | 布尔值 | true | 是否使用这个区域 | 是否启用该区域设置 | 选择true启用，false禁用 |

3.4 io-text-save 节点：文本保存器

这个节点就像一个"文档保存器"，可以把你的文字内容保存到电脑的文件里，方便以后查看或备份。

3.4.1 参数详解

| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :— | :— | :— | :— | :— | :— | :— | | 文本内容 | text_content | 文本输入 | 要保存的文字 | 你想要保存的文字内容 | 需要保存的文本数据 | 输入"今天的AI画作很棒" | | 文件名 | filename | 文本输入 | "output.txt" | 保存的文件叫什么名字 | 输出文件的名称 | 输入"my_prompts.txt" | | 文件路径 | file_path | 文本输入 | 当前目录 | 文件保存在哪个文件夹 | 文件保存的目录路径 | 输入"C:\ComfyUI\outputs\" | | 编码格式 | encoding | 选择项 | "utf-8" | 文字的保存格式 | 文本文件的字符编码 | 选择utf-8支持中文，选择ascii仅支持英文 | | 覆盖模式 | overwrite | 布尔值 | false | 如果文件已存在是否覆盖 | 是否覆盖同名文件 | 选择true会覆盖，false会追加内容 | | 自动换行 | auto_newline | 布尔值 | true | 是否自动添加换行符 | 是否在文本末尾添加换行 | 选择true方便阅读，false保持原样 |

3.5 io-util-file-list-get 节点：文件列表获取器

这个节点就像一个"文件夹浏览器"，可以帮你获取某个文件夹里所有文件的列表，方便你批量处理文件。

3.5.1 参数详解

| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :— | :— | :— | :— | :— | :— | :— | | 目录路径 | directory_path | 文本输入 | 目标文件夹路径 | 要查看哪个文件夹 | 要扫描的目录路径 | 输入"C:\ComfyUI\models\checkpoints\" | | 文件类型过滤 | file_extension | 文本输入 | "" | 只看什么类型的文件 | 文件扩展名过滤器 | 输入".png"只看图片，输入"*.txt"只看文本 | | 包含子文件夹 | include_subdirs | 布尔值 | false | 是否也看子文件夹里的文件 | 是否递归扫描子目录 | 选择true会看所有子文件夹，false只看当前文件夹 | | 排序方式 | sort_method | 选择项 | "name" | 文件列表按什么顺序排列 | 文件列表的排序方式 | 选择"name"按名称排序，"date"按日期排序，"size"按大小排序 | | 最大文件数 | max_files | 数字 | 1000 | 最多显示多少个文件 | 返回文件列表的最大数量 | 输入100表示最多显示100个文件 | | 显示隐藏文件 | show_hidden | 布尔值 | false | 是否显示隐藏的文件 | 是否包含隐藏文件 | 选择true会显示所有文件，false只显示普通文件 |

4. 使用技巧和建议

4.1 文本处理技巧

• 提示词拼接：使用 text-util-prompt-join 节点时，建议用逗号空格", "作为分隔符，这样生成的提示词更容易被 AI 理解
• 路径管理：text-util-path-list 节点可以预设常用路径，避免每次都要手动输入长路径
• 文件备份：使用 io-text-save 节点定期保存重要的提示词，建议开启覆盖模式的时候要小心

4.2 区域控制技巧

• 区域权重设置：使用 cutoff-region-util 时，重要区域权重建议设置在 1.1-1.3 之间，不要设置过高
• 区域坐标：坐标系统以左上角为原点(0,0)，向右为X轴正方向，向下为Y轴正方向

4.3 工作流程建议

1. 先用 text-util-path-list 设置好常用路径
2. 用 text-util-prompt-join 组合提示词
3. 用 cutoff-region-util 精细控制画面区域
4. 最后用 io-text-save 保存重要设置

5. 常见问题解答

Q1：为什么找不到这些节点？

A1：确保插件已正确安装并重启 ComfyUI，可以在搜索框中输入"ymc suite"来快速找到。

Q2：文本保存失败怎么办？

A2：检查文件路径是否正确，确保目标文件夹存在，并且 ComfyUI 有写入权限。

Q3：区域权重设置多少合适？

A3：一般建议在 0.8-1.5 之间，过高可能导致画面不自然，过低可能效果不明显。

Q4：路径输入格式有什么要求？

A4：Windows 系统使用反斜杠"\"，Linux/Mac 使用正斜杠"/"，路径末尾建议不要加斜杠。

Q5：可以同时使用多个节点吗？

A5：完全可以，这些节点设计为可以相互配合使用，形成完整的工作流程。

6. 高级应用示例

6.1 批量图片处理工作流

1. 使用 io-util-file-list-get 获取图片文件列表
2. 结合 text-util-path-list 管理输入输出路径
3. 用 cutoff-region-util 为每个区域设置不同的处理参数
4. 最后用 io-text-save 记录处理日志

6.2 复杂提示词管理

1. 将不同类型的描述词分别输入到 text-util-prompt-join 的不同文本框
2. 使用合适的分隔符组合成完整提示词
3. 通过 cutoff-region-util 为重要区域增加权重
4. 用 io-text-save 保存优秀的提示词组合

这个插件就像给你的 ComfyUI 加了一套"办公自动化"工具，让原本繁琐的文本处理、文件管理变得简单高效。记住，熟练使用这些工具的关键是多练习，慢慢你就能找到最适合自己工作流程的使用方法。