ComfyUI-MieNodes 插件完全新手教程
1. 插件简介
ComfyUI-MieNodes 是一个专为 ComfyUI 设计的实用工具插件包,就像是给你的 ComfyUI 装了一个瑞士军刀一样。这个插件主要是为了让你在训练 LoRA 模型时更轻松,同时也提供了很多日常使用的便民工具。
插件原地址: https://github.com/MieMieeeee/ComfyUI-MieNodes
想象一下,你平时整理电脑文件夹时需要批量改名、删除重复文件、格式转换等操作,这个插件就是帮你在 ComfyUI 里做这些事情的。特别是当你要训练自己的 LoRA 模型时,需要准备大量的图片和对应的文字描述文件,这个插件能让你事半功倍。
2. 如何安装
安装这个插件就像在手机上装 App 一样简单:
- 打开 ComfyUI Manager(如果你还没装,先去装一个)
- 在搜索框里输入 "MieNodes"
- 找到 ComfyUI-MieNodes 插件,点击安装
- 重启 ComfyUI 就可以使用了
或者你也可以手动安装:
- 下载插件文件到 ComfyUI 的 custom_nodes 文件夹
- 重启 ComfyUI
3. 节点逐一解析
3.1 批量重命名文件节点(Batch Rename Files)
这个节点就像是一个自动化的文件管理员,帮你把一堆文件按照规律重新命名。比如把 "照片1.jpg"、"照片2.jpg" 这样乱七八糟的文件名,统一改成 "cute_cat_001.jpg"、"cute_cat_002.jpg" 这样整齐的格式。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 文件夹路径 | directory | 文件夹路径 | 你的图片文件夹 | 告诉程序去哪个文件夹找文件 | 指定要操作的目录路径 | 填入 "C:\我的图片" |
| 文件扩展名 | file_extension | .jpg, .png, .txt 等 | .jpg | 只对这种类型的文件动手 | 指定要操作的文件类型 | 填入 ".jpg" 只改图片文件 |
| 编号格式 | numbering_format | ### 或 #### | ### | 决定编号是几位数 | 设定文件编号的位数格式 | "###" 表示 001, 002, 003 |
| 同时更新说明文件 | update_caption_as_well | True/False | True | 图片改名时,对应的文字文件也一起改 | 是否同步更新对应的标注文件 | 勾选后 cat_001.jpg 和 cat_001.txt 一起改 |
| 前缀 | prefix | 任意文字 | 空 | 给文件名前面加个统一的开头 | 为文件名添加的前缀字符串 | 填入 "cute_cat_" |
3.2 批量删除文件节点(Batch Delete Files)
这个节点就像是一个精准的垃圾清理工,能按照你的要求删除特定类型的文件。比如你想清理掉所有临时文件,或者删除某个特定开头的文件。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 文件夹路径 | directory | 文件夹路径 | 你要清理的文件夹 | 告诉程序去哪里删文件 | 指定要清理的目录路径 | 填入 "C:\临时文件" |
| 文件扩展名 | file_extension | .jpg, .png, .txt 等 | .tmp | 只删除这种类型的文件 | 指定要删除的文件类型 | 填入 ".tmp" 删除临时文件 |
| 前缀 | prefix | 任意文字 | 空 | 只删除以这个开头的文件 | 指定要删除文件的前缀过滤条件 | 填入 "temp_" 只删除以 temp_ 开头的文件 |
3.3 批量编辑说明文件节点(Batch Edit Caption Files)
这个节点就像是一个文字编辑助手,能够批量修改图片的说明文字。比如你有100张猫咪图片,每张都有对应的文字描述,现在想给所有描述都加上"可爱的"这个词,这个节点就能帮你一次性搞定。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 文件夹路径 | directory | 文件夹路径 | 你的图片文件夹 | 告诉程序去哪里找说明文件 | 指定包含标注文件的目录 | 填入 "C:\我的数据集" |
| 操作类型 | operation | insert/append/replace/remove | append | 选择要做什么操作 | 指定对文本内容的操作类型 | 选择 "append" 在文字后面添加内容 |
| 文件扩展名 | file_extension | .txt 等 | .txt | 要修改哪种类型的文件 | 指定要操作的文件类型 | 通常选择 ".txt" |
| 目标文字 | target_text | 任意文字 | 空 | 要替换或删除的文字 | 在替换或删除操作中的目标文本 | 填入 "old_word" 表示要替换的词 |
| 新文字 | new_text | 任意文字 | 空 | 要添加、插入或替换成的文字 | 新的文本内容 | 填入 "beautiful, " 给所有图片描述加上"美丽的"标签 |
3.4 添加说明文件节点(Add Caption Files)
这个节点就像是一个贴标签的机器,能为所有图片自动创建对应的说明文件。比如你有一堆图片但没有说明文字,这个节点能给每张图片创建一个同名的 .txt 文件,里面写上你指定的内容。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 文件夹路径 | directory | 文件夹路径 | 你的图片文件夹 | 告诉程序去哪里找图片 | 指定包含图片文件的目录 | 填入 "C:\我的猫咪图片" |
| 说明内容 | caption_content | 任意文字 | 空 | 要写在说明文件里的内容 | 标注文件中的默认文本内容 | 填入 "cute cat, " 给所有图片加上"可爱的猫"标签 |
3.5 汇总说明文件节点(Summarize Caption Files)
这个节点就像是一个文档整理专家,能把文件夹里所有说明文件的内容收集起来,方便你查看或者让 AI 帮你分析。比如你想知道数据集里都有哪些描述词,这个节点就能帮你整理出来。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 文件夹路径 | directory | 文件夹路径 | 你的数据集文件夹 | 告诉程序去哪里找说明文件 | 指定包含标注文件的目录 | 填入 "C:\我的数据集" |
| 添加分隔符 | add_separator | True/False | True | 在不同文件内容之间加个分隔线 | 是否在不同文件内容间添加分隔符 | 勾选后每个文件内容之间会有分隔线 |
| 保存到文件 | save_to_file | True/False | True | 把汇总结果保存成文件 | 是否将汇总结果保存为文件 | 勾选后会生成一个汇总文件 |
| 文件扩展名 | file_extension | .txt 等 | .txt | 要汇总哪种类型的文件 | 指定要汇总的文件类型 | 通常选择 ".txt" |
| 汇总文件名 | summary_file_name | 任意文字 | summary.txt | 汇总文件叫什么名字 | 汇总文件的保存名称 | 填入 "all_captions.txt" |
3.6 批量转换图片格式节点(Batch Convert Images)
这个节点就像是一个图片格式转换器,能把一堆不同格式的图片统一转换成你想要的格式。比如把 PNG 格式的图片全部转成 JPG 格式,节省存储空间。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 文件夹路径 | directory | 文件夹路径 | 你的图片文件夹 | 告诉程序去哪里找图片 | 指定包含图片文件的目录 | 填入 "C:\我的图片" |
| 目标格式 | target_format | jpg/png | jpg | 要转换成什么格式 | 图片转换的目标格式 | 选择 "jpg" 转换成 JPG 格式 |
| 保留原文件 | save_original | True/False | False | 转换后是否保留原来的文件 | 是否在转换后保留原始文件 | 不勾选可以节省空间 |
3.7 删除重复图片节点(Remove Duplicate Images)
这个节点就像是一个火眼金睛的管家,能找出文件夹里相同或相似的图片并删除多余的。比如你不小心把同一张图片保存了好几份,这个节点就能帮你清理掉。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 文件夹路径 | directory | 文件夹路径 | 你的图片文件夹 | 告诉程序去哪里找重复图片 | 指定要清理的图片目录 | 填入 "C:\我的图片" |
| 最大相似度阈值 | max_distance_threshold | 0-64 | 5 | 多相似算重复(数字越小要求越严格) | 判断图片相似度的阈值参数 | 填入 "5" 表示非常相似才算重复 |
3.8 显示内容节点(Display Anything)
这个节点就像是一个万能显示器,能把任何内容以文字形式显示出来,方便你调试和查看数据。就像是在复杂的工作流程中放一个"检查点",让你看看数据处理到哪一步了。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 任意内容 | anything | 任意数据 | 任意 | 把任何东西都显示成文字 | 将输入的任意数据转换为字符串显示 | 连接任何节点的输出就能看到内容 |
3.9 保存数据节点(Save Data)
这个节点就像是一个万能的文件保存器,能把工作流程中的数据保存成不同格式的文件。比如你想把处理结果保存成 JSON 文件供其他程序使用,或者保存成文本文件方便查看。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 数据 | data | 任意数据 | 任意 | 要保存的内容 | 需要保存的数据内容 | 连接其他节点的输出 |
| 文件夹路径 | directory | 文件夹路径 | 你的保存文件夹 | 把文件保存到哪里 | 指定文件保存的目录 | 填入 "C:\我的输出" |
| 文件名 | file_name | 任意文字 | output | 保存的文件叫什么名字 | 保存文件的名称 | 填入 "result_data" |
| 保存格式 | save_format | json/toml/txt | json | 保存成什么格式 | 数据保存的文件格式 | 选择 "json" 保存为 JSON 格式 |
3.10 比较文件节点(Compare Files)
这个节点就像是一个文件对比专家,能比较两个文件有什么不同。比如你修改了配置文件,想知道改了哪些地方,这个节点就能告诉你。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 第一个文件路径 | file1_path | 文件路径 | 第一个文件 | 要比较的第一个文件在哪里 | 第一个用于比较的文件路径 | 填入 "C:\config_old.json" |
| 第二个文件路径 | file2_path | 文件路径 | 第二个文件 | 要比较的第二个文件在哪里 | 第二个用于比较的文件路径 | 填入 "C:\config_new.json" |
| 文件格式 | file_format | json/toml | json | 文件是什么格式的 | 指定文件的数据格式 | 选择 "json" 表示 JSON 格式文件 |
3.11 下载文件节点(Download File)
这个节点就像是一个智能下载器,能从网上下载模型文件到 ComfyUI 的模型文件夹。比如你想下载 Hugging Face 上的模型,不用手动下载再复制,这个节点能直接帮你搞定。
参数详解:
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 网址 | url | 网址链接 | 文件的网址 | 要下载的文件网址 | 要下载文件的完整URL | 填入 "https://..." |
| 保存路径 | save_path | 文件路径 | 模型文件夹 | 下载到哪里 | 文件保存的本地路径 | 填入 "checkpoints/my_model.safetensors" |
| 覆盖已存在文件 | override | True/False | False | 如果文件已存在是否覆盖 | 是否覆盖已存在的同名文件 | 勾选后会覆盖原文件 |
| 使用HF镜像 | use_hf_mirror | True/False | True | 使用国内镜像下载更快 | 是否使用Hugging Face镜像站点 | 勾选可以提高下载速度 |
| 重命名为 | rename_to | 任意文字 | 空 | 下载后改个名字 | 下载后重命名文件的新名称 | 填入 "my_model.safetensors" |
| HF令牌 | hf_token | 令牌字符串 | 空 | 下载私有模型时需要的密钥 | Hugging Face访问令牌 | 填入你的 HF token |
| 触发信号 | trigger_signal | 任意 | 空 | 控制什么时候开始下载 | 用于控制下载时机的信号 | 连接其他节点来控制下载时机 |
4. 使用技巧和建议
4.1 训练 LoRA 的完整流程
-
数据准备阶段:
- 用"批量转换图片格式"把所有图片转成 JPG 格式
- 用"删除重复图片"清理掉重复的图片
- 用"批量重命名文件"给图片统一命名
-
标注准备阶段:
- 用"添加说明文件"给每张图片创建对应的文字描述
- 用"批量编辑说明文件"批量添加或修改标签
-
质量检查阶段:
- 用"汇总说明文件"查看所有标签
- 用"显示内容"节点检查数据处理结果
4.2 日常文件管理技巧
- 定期用"删除重复图片"清理图片文件夹
- 用"批量转换图片格式"统一图片格式
- 用"批量重命名文件"整理文件命名
4.3 数据备份建议
- 在做批量操作前,先备份原始文件
- 使用"保存数据"节点保存重要的处理结果
- 用"比较文件"节点检查配置文件的变化
5. 常见问题解答
Q: 为什么批量操作没有效果?
A: 检查文件路径是否正确,确保路径中没有中文字符,文件夹确实存在。
Q: 下载文件总是失败怎么办?
A: 检查网络连接,如果下载 Hugging Face 的文件,建议开启"使用HF镜像"选项。
Q: 删除重复图片时怎么设置相似度?
A: 数字越小要求越严格,建议从 5 开始试,如果删除太多就调大数字。
Q: 批量编辑说明文件时操作类型怎么选?
A:
- insert:在文字开头插入
- append:在文字末尾添加
- replace:替换指定文字
- remove:删除指定文字
Q: 保存数据时选择什么格式好?
A:
- TXT:人类可读,适合查看
- JSON:程序可读,适合给其他程序使用
- TOML:配置文件格式,适合设置参数
6. 总结
ComfyUI-MieNodes 是一个非常实用的文件管理工具集,特别适合需要处理大量数据的用户。无论你是在训练 LoRA 模型,还是日常整理文件,这个插件都能大大提高你的工作效率。
记住,所有的批量操作都要先备份原始文件,避免误操作造成数据丢失。这个插件还在不断更新中,未来会有更多实用功能加入,值得长期关注。
最重要的是,不要被这些功能吓到,每个节点都很简单,就像使用手机 App 一样,多试几次就熟悉了。从简单的文件重命名开始,逐步掌握所有功能,你会发现 ComfyUI 的世界变得更加便利!