%20(1).png)
ComfyUI_PromptBatcher 插件：让你一次性处理多个文字描述的超实用工具
1. 插件简介
GitHub 原地址： https://github.com/synthetai/ComfyUI_PromptBatcher
这个插件就像一个超级聪明的文件整理员，它可以帮你一次性读取很多个文本文件里的文字描述，然后让 ComfyUI 根据这些描述生成一大批图片。
想象一下，你有100个不同的文字描述存在100个文本文件里，比如"美丽的夕阳"、"可爱的小猫"、"神秘的森林"等等。如果没有这个插件，你需要一个一个地复制粘贴这些文字，然后一张一张地生成图片，那得累死你！
有了这个插件，你就像雇了一个助手，它会： - 自动读取文件夹里所有的文本文件 - 把每个文件里的文字描述都记住 - 让 ComfyUI 按照这些描述一口气生成所有图片
能给你带来什么效果： - 节省大量时间：不用手动复制粘贴文字描述 - 批量生成图片：一次性处理几十甚至上百个描述 - 组织更有序：可以按照文件名前缀来筛选要处理的文件 - 灵活控制：可以选择从第几个文件开始处理，处理多少个文件
2. 如何安装
安装这个插件就像在手机上装APP一样简单：
- 找到你的 ComfyUI 安装文件夹
- 进入
custom_nodes子文件夹 - 在命令行中输入：
git clone https://github.com/synthetai/ComfyUI_PromptBatcher.git - 重启 ComfyUI
安装完成后，你就能在节点列表里看到 "PromptBatcher" 分类了。
3. 节点详解
3.1 Load Prompts From Dir 节点 - 文件夹文字描述读取器
这个节点就像一个超级读书机，它会钻进你指定的文件夹，把里面所有文本文件的内容都读出来。
参数详解：
| 参数名 (界面显示) | 参数名 (代码里) | 参数类型 | 建议值 | 通俗解释 | 专业解释 | 使用举例 |
|---|---|---|---|---|---|---|
| Directory | directory | 文件夹路径 | 你存放文本文件的文件夹 | 告诉节点去哪个文件夹找文本文件，就像告诉快递员你家地址 | 指定包含提示词文本文件的目录路径 | 输入："C:\my_prompts\" 或 "prompts/" |
| File Prefix | file_prefix | 文本(可选) | 留空或输入特定前缀 | 只读取文件名开头是这些字母的文件，就像只要姓张的人 | 过滤文件名，只加载以指定前缀开头的文件 | 输入："scene_" 只读取 scene_1.txt, scene_2.txt 等 |
| File Load Cap | file_load_cap | 数字(可选) | 0(不限制) 或你想要的数量 | 最多读取几个文件，就像限制每次最多吃几个苹果 | 限制加载的文件数量，0表示无限制 | 输入：10 表示最多读取10个文件 |
| Start Index | start_index | 数字(可选) | 0(从第一个开始) | 从第几个文件开始读取，就像从第5页开始看书 | 指定开始加载文件的索引位置 | 输入：5 表示跳过前5个文件，从第6个开始读 |
| Load Always | load_always | 勾选框(可选) | 不勾选 | 每次运行都重新读取文件，就像每次都重新数一遍你的钱 | 强制每次执行时都重新加载文件 | 勾选：适合文件内容经常变化的情况 |
输出结果： - PROMPT（文字描述列表）：读取到的所有文字描述，就像一个装满纸条的盒子 - FILE_PATH（文件路径列表）：对应每个文字描述的文件完整路径，就像每张纸条的来源地址
3.2 Save Prompts To Files 节点 - 文字描述文件保存器
这个节点就像一个超级文件管理员，它可以把你写的多行文字，每一行都保存成一个单独的文本文件。
参数详解：
| 参数名 (界面显示) | 参数名 (代码里) | 参数类型 | 建议值 | 通俗解释 | 专业解释 | 使用举例 |
|---|---|---|---|---|---|---|
| Text | text | 多行文本框 | 你要保存的文字描述 | 在这里写你的文字描述，每行一个，就像写购物清单 | 多行文本输入，每行将被保存为单独的文件 | 输入："美丽的夕阳\n可爱的小猫\n神秘的森林" |
| Output Directory | output_directory | 文件夹路径(可选) | "input"(默认) | 文件保存到哪个文件夹，就像选择把东西放在哪个抽屉里 | 指定保存文件的目录路径 | 输入："my_prompts" 或 "C:\saved_prompts\" |
| File Prefix | file_prefix | 文本(可选) | "Scene"(默认) | 文件名的开头部分，就像给每个文件起个统一的姓 | 生成文件名的前缀标识 | 输入："prompt_" 生成 prompt_1.txt, prompt_2.txt 等 |
输出结果： - Output Path（输出路径）：文件保存的完整路径，就像告诉你东西放在哪里了 - File Prefix（文件前缀）：使用的文件名前缀，就像确认给文件起的统一姓氏
4. 使用技巧和建议
4.1 文件整理小贴士
- 统一命名：把你的文字描述文件都用相同的格式命名，比如 "prompt_001.txt", "prompt_002.txt"
- 分类管理：用文件前缀来分类，比如 "landscape_" 开头的存风景描述，"portrait_" 开头的存人像描述
- 备份重要文件：在批量处理前，先备份你的文字描述文件
4.2 提高效率的方法
- 合理设置处理数量：如果文件很多，可以先用 File Load Cap 限制数量，分批处理
- 善用起始索引：如果处理中断了，可以用 Start Index 从中断的地方继续
- 文件夹结构清晰：把不同类型的文字描述放在不同文件夹里
4.3 与其他节点配合
- 连接采样器：把 Load Prompts From Dir 的 PROMPT 输出连接到 KSampler 的 positive 输入
- 循环处理：配合循环节点可以实现自动化批量生成
- 条件判断：可以根据文件名或内容进行条件处理
5. 常见问题解答
Q1: 为什么读取不到文件？
A: 检查以下几点： - 文件夹路径是否正确（注意斜杠方向） - 文件是否为 .txt 格式 - 文件是否有读取权限 - 路径中是否包含中文字符（建议使用英文路径）
Q2: 文件读取顺序是什么？
A: 通常按文件名的字母顺序读取，所以建议用数字编号来控制顺序，比如 001.txt, 002.txt
Q3: 可以处理多少个文件？
A: 理论上没有限制，但建议单次处理不超过100个文件，以免内存占用过大
Q4: 文件内容格式有什么要求？
A: 每个文本文件应该只包含一个文字描述，不要有多行内容
Q5: 如何处理包含特殊字符的文字描述？
A: 确保文本文件使用 UTF-8 编码保存，这样可以正确处理中文和其他特殊字符
6. 实际应用场景
6.1 艺术创作批量生成
如果你是艺术家，可以准备100个不同的艺术风格描述，然后一次性生成100张不同风格的作品进行筛选。
6.2 商业用途快速出图
电商需要大量产品图片时，可以准备所有产品的描述文本，然后批量生成产品展示图。
6.3 教学演示
制作教学课件时，可以准备不同主题的描述，批量生成相关图片素材。
6.4 创意实验
想测试不同文字描述的效果时，可以准备多个版本的描述，然后批量生成进行对比。
7. 高级使用技巧
7.1 动态文件管理
开启 "Load Always" 选项后，你可以在 ComfyUI 运行过程中修改文本文件，节点会自动读取最新内容。
7.2 文件筛选策略
巧妙使用 File Prefix 可以实现分类处理，比如： - "day_" 开头的文件处理白天场景 - "night_" 开头的文件处理夜晚场景 - "indoor_" 开头的文件处理室内场景
7.3 批量保存优化
使用 Save Prompts To Files 节点时，可以先在文本框中编辑和调整所有描述，确认无误后再保存。
这个插件虽然看起来简单，但它能大大提高你的工作效率，特别是在需要生成大量图片的场景下。掌握了这个工具，你就能像专业的图片生产工厂一样，快速高效地批量生成各种图片了！