ComfyUI-DatasetHelper 数据集小助手插件教程

1. 插件简介

这是一个能帮你整理和管理图片素材的超级实用小工具！想象一下，你有一大堆图片需要整理，这个插件就像一个贴心的小助手，帮你把图片分门别类地整理好，还能帮你给图片贴标签。

GitHub 地址：https://github.com/fblissjr/ComfyUI-DatasetHelper

2. 安装方法

就像安装手机 APP 一样简单： 1. 打开你的 ComfyUI 文件夹 2. 找到 custom_nodes 文件夹（如果没有就新建一个） 3. 在这个文件夹里用 git clone 下载插件，或者直接下载 zip 解压都行 4. 重启 ComfyUI，插件就安装好啦！

3. 节点详解

3.1 ImageDirectoryScan 图片扫描器节点

这个节点就像一个图片探测器，帮你找到文件夹里的所有图片。

参数表： | 参数名(显示) | 参数名(代码) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 使用举例 | |------------|------------|--------|--------|----------|----------|---------| | 文件夹路径 | directory_path | 文字输入 | D:/我的图片 | 你想要扫描的图片文件夹在哪 | 图片目录的绝对路径 | 比如填入"D:/我的照片/风景" | | 是否递归搜索 | recursive | 是/否 | 是 | 是否要翻找子文件夹里的图片 | 是否遍历子目录 | 如果选"是"，连文件夹里的文件夹也会被搜索 |

3.2 DatasetBatchLoader 图片批量加载器

就像一个自动传送带，把一堆图片一次性搬运进来。

参数表： | 参数名(显示) | 参数名(代码) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 使用举例 | |------------|------------|--------|--------|----------|----------|---------| | 批次大小 | batch_size | 数字 | 4 | 一次想处理几张图片 | 单次加载的图片数量 | 设置为4就是一次处理4张图片 | | 当前索引 | current_index | 数字 | 0 | 从第几张图片开始加载 | 当前处理的图片索引 | 设置为0就是从第一张开始 |

3.3 DatasetBatchInfo 批次信息显示器

像一个信息报告员，告诉你现在正在处理哪些图片。

参数表： | 参数名(显示) | 参数名(代码) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 使用举例 | |------------|------------|--------|--------|----------|----------|---------| | 显示详细信息 | show_details | 是/否 | 是 | 要不要看图片的详细信息 | 是否显示元数据信息 | 选"是"会显示图片大小等信息 |

4. 使用技巧和建议

• 先从小批量图片开始尝试，熟悉了再处理大量图片
• 建议创建专门的文件夹存放待处理的图片，方便管理
• 处理大量图片时，建议批次大小设置在4-8之间，避免内存占用过大

5. 常见问题解答

Q：为什么扫描不到我的图片？ A：检查一下文件夹路径是不是写对了，Windows系统要用反斜杠"\"或者"/"都可以

Q：批次大小设置多少合适？ A：根据你电脑配置来定，普通电脑建议4-8张，配置好的可以试试更多

Q：处理中途出错怎么办？ A：记住当前索引号，下次从这个索引号继续处理就行

6. 额外提示

• 这个插件特别适合需要批量处理图片的场景
• 可以配合其他节点一起使用，组成自动化工作流
• 记得定期备份重要图片，以防万一

希望这份教程能帮助你轻松上手 ComfyUI-DatasetHelper 插件！如果还有不明白的地方，随时问我哦~