# ComfyUI TextBatch 插件保姆级使用教程 ## 1. 插件简介 **插件地址：** https://github.com/aidec/Comfyui_TextBatch_aidec 这个插件就像是一个自动化的文本处理助手，专门用来帮你批量处理文本内容。想象一下，你有一堆不同的提示词，平时需要一个一个手动复制粘贴去生成图片，现在有了这个插件，就像有了一个贴心的小助手，可以把你的文本按行分开，然后一个接一个自动帮你处理。 **主要功能：** - 把多行文本自动分成一组一组的，让电脑自动批量处理 - 支持图片文件的批量处理，可以获取图片的文件名 - 让你不用手动一个个复制粘贴，提高工作效率 **能带来什么效果：** - 省时省力：不用再手动换提示词了 - 批量生成：一次性处理多个不同的提示词 - 自动化：像流水线一样，自动处理你的任务 ## 2. 如何安装 ### 方法一：通过 Git 命令安装（推荐） 1. 打开你的文件管理器，找到 ComfyUI 的安装文件夹 2. 进入 `ComfyUI\custom_nodes` 这个文件夹 3. 在这个文件夹里右键，选择"在终端中打开"或"打开命令提示符" 4. 输入以下命令： ``` git clone https://github.com/aidec/Comfyui_TextBatch_aidec.git ``` 5. 等待下载完成 6. 重启 ComfyUI ### 方法二：手动下载安装 1. 访问 https://github.com/aidec/Comfyui_TextBatch_aidec 2. 点击绿色的"Code"按钮，选择"Download ZIP" 3. 下载完成后，解压到 `ComfyUI\custom_nodes` 文件夹 4. 重启 ComfyUI ## 3. 节点详细解析 ### 3.1 Text Queue Processor 节点（文本队列处理器） 这个节点就像是一个智能的文本分发器，把你写的多行文本按照顺序一行一行地发送给其他节点使用。 #### 3.2 参数详解 | 参数名 (界面显示) | 参数名 (代码中) | 参数类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 文本输入 | text | 多行文本 | 每行一个提示词 | 就像一个记事本，你可以在里面写很多行不同的内容，每行都是一个独立的提示词 | 接收多行文本输入，每行作为一个独立的处理单元 | 例如：第一行：美丽的花园第二行：可爱的小猫第三行：壮观的山脉 | | 开始索引 | start_index | 整数 | 0 | 就像书的页码，告诉系统从第几行开始处理，0 表示从第一行开始 | 指定开始处理的文本行索引位置 | 如果设置为 1，就会跳过第一行，从第二行开始处理 | | 当前索引 | current_index | 整数 | 自动变化 | 就像一个计数器，显示现在正在处理第几行文本 | 当前正在处理的文本行索引 | 这个数字会自动增加：0、1、2、3... | ### 3.3 Image Queue Processor 节点（图片队列处理器） 这个节点就像是一个图片管家，专门负责批量处理图片文件，可以告诉你现在正在处理哪张图片。 #### 3.4 参数详解 | 参数名 (界面显示) | 参数名 (代码中) | 参数类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 图片输入 | images | 图片 | 连接其他节点 | 就像一个图片传送带，接收从其他节点传来的图片 | 接收图片数据流进行批处理 | 通常连接到加载图片的节点 | | 开始索引 | start_index | 整数 | 0 | 就像相册的页码，告诉系统从第几张图片开始处理 | 指定开始处理的图片索引位置 | 设置为 2 就会从第三张图片开始处理 | | 当前索引 | current_index | 整数 | 自动变化 | 就像一个图片计数器，显示现在正在处理第几张图片 | 当前正在处理的图片索引 | 这个数字会随着处理进度自动增加 | ### 3.5 Load Images From Dir Batch 节点（批量文件夹图片加载器） 这个节点就像是一个图片收集器，可以一次性从文件夹里把所有图片都拿出来，还能告诉你每张图片的名字和位置。 #### 3.6 参数详解 | 参数名 (界面显示) | 参数名 (代码中) | 参数类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 文件夹路径 | directory | 文件路径 | 你的图片文件夹路径 | 就像告诉系统去哪个房间找图片，需要输入图片存放的文件夹位置 | 指定要批量加载图片的目录路径 | 例如：C:\Users\用户名\Pictures\我的图片 | | 文件名输出 | filenames | 文本 | 自动生成 | 就像一个图片名单，列出所有图片的名字 | 输出图片文件名的字符串列表 | 输出：图片1.png,图片2.png,图片3.png | | 完整路径输出 | full_paths | 文本 | 自动生成 | 就像一个详细地址单，不仅有图片名字，还有完整的存放位置 | 输出图片完整路径的字符串列表 | 输出：C:\Pictures\图片1.png,C:\Pictures\图片2.png | ### 3.7 Image Filename Processor 节点（图片文件名处理器） 这个节点就像是一个智能的文件名解析器，可以从一串文件名中找到你想要的那一个。 #### 3.8 参数详解 | 参数名 (界面显示) | 参数名 (代码中) | 参数类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :--- | :--- | :--- | :--- | :--- | :--- | :--- | | 文件名列表 | filenames | 文本 | 连接其他节点 | 就像一个通讯录，里面存着所有图片的名字 | 接收包含多个文件名的字符串 | 接收：图片1.png,图片2.png,图片3.png | | 索引 | index | 整数 | 连接其他节点 | 就像一个选择器，告诉系统要从列表中选择第几个文件名 | 指定要提取的文件名索引位置 | 索引为 1 时，会提取第二个文件名 | | 文件路径输出 | file_path | 文本 | 自动生成 | 就像一个地址标签，输出选中图片的完整信息 | 输出选定索引对应的文件路径 | 输出：C:\Pictures\图片2.png | ## 4. 使用技巧和建议 ### 4.1 基本使用流程 1. **准备文本**：在 Text Queue Processor 节点中输入你的多行提示词，每行一个 2. **连接节点**：将 Text Queue Processor 的输出连接到你要使用的地方（比如正向提示词） 3. **设置起始点**：确保 start_index 设置为 0 4. **开始处理**：点击运行，系统会自动逐行处理你的文本 ### 4.2 重要注意事项 - **重置索引**：每次运行完成后，记得手动将 start_index 重置为 0 - **单窗口操作**：不要同时打开多个 ComfyUI 窗口，容易出错 - **耐心等待**：第一次运行可能只处理一条，这是正常的，等完成后再运行第二次 ### 4.3 图片批处理技巧 - 使用 Load Images From Dir Batch 节点时，确保图片都在同一个文件夹内 - 配合 Image Filename Processor 使用，可以让输出图片和输入图片使用相同的文件名 - 在做图生图时特别有用，可以轻松识别哪张输出图对应哪张输入图 ## 5. 常见问题解答 ### Q1：为什么第一次运行只处理了一条？ **答：** 这是插件的已知特性，不是错误。第一次运行完成后，再次点击运行就会正常工作。 ### Q2：如何重置 start_index？ **答：** 每次批处理完成后，手动将 start_index 的值改回 0。 ### Q3：可以同时运行多个 ComfyUI 窗口吗？ **答：** 不建议这样做，容易导致任务队列混乱或出现其他错误。 ### Q4：图片文件名输出是什么格式？ **答：** 有两种格式： - filenames：只有文件名（例如：图片1.png） - full_paths：完整路径（例如：C:\Pictures\图片1.png） ### Q5：如果处理过程中出现错误怎么办？ **答：** 1. 检查文本格式是否正确（每行一个提示词） 2. 确认只打开了一个 ComfyUI 窗口 3. 重启 ComfyUI 再试 4. 检查图片文件夹路径是否正确 ## 6. 实际应用场景 ### 6.1 批量生成不同风格的图片 假设你想生成多种风格的风景画： ``` 美丽的日出，油画风格 宁静的湖泊，水彩画风格 壮观的山脉，素描风格 繁华的城市，摄影风格 ``` ### 6.2 批量处理参考图 当你有很多参考图需要进行图生图时，这个插件可以： - 自动加载所有参考图 - 保持输出图片和输入图片的文件名对应 - 节省手动操作的时间 ### 6.3 A/B 测试不同提示词 想要测试不同提示词的效果时，可以把多个版本的提示词放在一起批量测试： ``` 可爱的小猫，高质量 adorable kitten，high quality cute cat，detailed 小猫咪，精细 ``` 这个插件就像是 ComfyUI 的一个得力助手，让你的工作流程更加自动化和高效。虽然目前还有一些小的使用技巧需要注意，但掌握了这些要点后，它会成为你批量处理任务的好帮手！
ComfyUI图像合并插件comfyui-merge使用教程 2025-07-03 22:44 ComfyUI 图像合并插件教程 (comfyui-merge) 1. 插件简介 这是一个专门用来合并图片的 ComfyUI 插件，就像用 PS 把多张图片叠在一起那样。它的特别之处在于你精确控制每张图片的混合方式。 GitHub 地址：https://github.com/LingSss9/com
%20(1).png)
