%20(1).png)
ComfyUI Lumi Batcher 插件保姆级教程
1. 插件简介
插件地址： https://github.com/bytedance/comfyui-lumi-batcher
ComfyUI Lumi Batcher 是由字节跳动智能创作团队开发的一款专业批量处理插件。这个插件就像是给你的 ComfyUI 装了一个"超级管家"，专门帮你批量生成图片、视频等内容，让你告别一张一张手动调参数的痛苦！
这个插件能给我们带来什么效果？
想象一下，你要测试 10 个不同的模型配合 5 种不同的提示词，按照传统方法你需要手动操作 50 次。但有了这个插件，你只需要设置一次参数，它就能自动帮你生成所有 50 种组合的结果！
主要功能：
- 🎯 批量参数测试：就像调音台一样，可以同时调节多个"旋钮"（参数）
- 📊 结果可视化管理：生成的所有图片都整齐排列，像相册一样方便查看
- 📦 一键打包下载：所有结果可以打包成压缩包，一次性下载
- 🔄 任务管理：可以查看、取消、删除批量任务，就像管理手机里的下载任务
- 🌍 多语言支持：支持中文和英文界面切换
2. 如何安装
重要提醒： 你的电脑需要安装 Python 3.10 或更高版本
方法一：通过 Git 命令安装（推荐）
- 打开命令行工具（Windows 用户按 Win+R 输入 cmd，Mac 用户打开终端）
- 进入你的 ComfyUI 安装目录下的 custom_nodes 文件夹
- 输入以下命令：
git clone https://github.com/bytedance/comfyui-lumi-batcher.git
- 重启 ComfyUI
方法二：通过 ComfyUI-Manager 安装
- 在 ComfyUI 界面中打开 ComfyUI-Manager
- 搜索
comfyui-lumi-batcher - 点击安装按钮
- 重启 ComfyUI
安装成功标志
安装成功后，你会在 ComfyUI 界面的右上角看到一个新的按钮，点击它就能打开批量工具界面。
3. 功能模块详解
重要说明： 这个插件不是传统的 ComfyUI 节点插件，而是一个完整的 Web 应用界面。它通过浏览器界面提供所有功能，没有需要拖拽到工作流中的节点。
3.1 批量任务创建器
这是插件的核心功能，就像一个"任务工厂"，帮你批量生产各种组合的结果。
功能说明：
- 可以选择工作流中的任何参数进行批量测试
- 支持多个参数同时变化（叉乘组合）
- 自动计算会生成多少个结果
主要参数：
| 参数名称 | 参数类型 | 可选值 | 建议值 | 通俗解释 | 专业解释 | 使用示例 |
|---|---|---|---|---|---|---|
| 任务名称 | 文本输入 | 任意文本 | 描述性名称 | 给这次批量任务起个名字，方便以后找到 | 用于标识和管理批量任务的名称 | "测试不同风格模型" |
| 参数配置 | 参数选择器 | 工作流中的所有参数 | 根据需求选择 | 选择你想要批量测试的"旋钮"，比如模型、提示词等 | 选择需要进行批量处理的工作流参数 | 选择模型参数和采样步数 |
| 参数值列表 | 值输入器 | 根据参数类型变化 | 覆盖测试范围 | 为每个选中的"旋钮"设置不同的值 | 为选定参数设置不同的取值 | 模型A、模型B、模型C |
| 队列优先级 | 数字选择 | -1, 0, 正数 | 0 | 决定任务的"插队"顺序，-1表示最优先 | 控制任务在队列中的执行优先级 | 紧急任务设置为-1 |
3.2 任务管理中心
这里就像一个"任务控制台"，可以查看所有批量任务的状态。
功能说明：
- 显示所有历史任务
- 可以搜索、筛选任务
- 支持取消正在运行的任务
- 可以删除不需要的任务
主要参数：
| 参数名称 | 参数类型 | 可选值 | 建议值 | 通俗解释 | 专业解释 | 使用示例 |
|---|---|---|---|---|---|---|
| 任务名称搜索 | 文本输入 | 任意文本 | 空或关键词 | 输入任务名称的一部分来快速找到想要的任务 | 通过任务名称进行模糊搜索 | 输入"风格"找到所有包含风格的任务 |
| 状态筛选 | 下拉选择 | 全部/运行中/成功/失败/已取消 | 全部 | 只显示特定状态的任务，就像筛选邮件一样 | 根据任务执行状态进行过滤 | 选择"失败"查看出错的任务 |
| 每页显示数量 | 数字选择 | 10/20/50/100 | 20 | 一页显示多少个任务，就像调节相册每页照片数量 | 控制分页显示的任务数量 | 任务多时选择50提高浏览效率 |
| 页码 | 数字输入 | 正整数 | 1 | 翻到第几页，就像翻书一样 | 分页导航的页码控制 | 跳转到第3页查看更多任务 |
3.3 参数配置器
这是设置批量参数的地方，就像一个"调音台"，每个滑块代表一个可以调节的参数。
功能说明：
- 支持多种参数类型（文本、数字、选择等）
- 可以设置参数的多个值
- 支持参数分组功能
- 提供魔法表达式快速输入
主要参数：
| 参数名称 | 参数类型 | 可选值 | 建议值 | 通俗解释 | 专业解释 | 使用示例 |
|---|---|---|---|---|---|---|
| 参数类型 | 选择器 | 字符串/数字/布尔值/组合 | 根据实际需求 | 选择这个参数是文字、数字还是开关类型 | 定义参数的数据类型 | 提示词选择"字符串" |
| 参数名称 | 文本显示 | 自动识别 | 无需修改 | 显示这个参数在工作流中的名字 | 工作流中参数的标识名称 | "positive_prompt" |
| 参数值列表 | 多值输入 | 根据类型变化 | 覆盖测试范围 | 输入这个参数要测试的所有不同值 | 该参数在批量处理中的所有取值 | "风景,人物,动物" |
| 魔法表达式 | 表达式输入 | 范围表达式 | 根据需要使用 | 快速生成一系列数值，比如1到10的所有整数 | 使用表达式快速生成参数值序列 | "1..10" 生成1到10 |
| 分组模式 | 开关 | 开启/关闭 | 关闭 | 把多个参数绑定在一起，同时变化 | 将多个参数组合为一个参数组 | 把"模型"和"对应提示词"绑定 |
3.4 结果查看器
这里就像一个"成果展示厅"，所有生成的结果都整齐排列展示。
功能说明：
- 网格式显示所有结果
- 支持图片、视频、文本等多种格式
- 可以预览、下载单个结果
- 支持批量选择和操作
主要参数：
| 参数名称 | 参数类型 | 可选值 | 建议值 | 通俗解释 | 专业解释 | 使用示例 |
|---|---|---|---|---|---|---|
| 显示模式 | 切换按钮 | 网格/列表 | 网格 | 选择结果的排列方式，网格像相册，列表像文件夹 | 控制结果的显示布局方式 | 查看图片用网格，查看详情用列表 |
| 网格大小 | 滑块 | 小/中/大 | 中 | 调节每个结果显示的大小，就像调节相册缩略图大小 | 控制网格中每个项目的显示尺寸 | 结果多时选择小尺寸 |
| 筛选条件 | 多选框 | 成功/失败/各种参数值 | 全选 | 只显示符合条件的结果，就像筛选照片 | 根据条件过滤显示的结果 | 只看"风景"类型的结果 |
| 排序方式 | 下拉选择 | 时间/参数值/文件名 | 时间 | 决定结果的排列顺序 | 控制结果的排序规则 | 按时间排序看最新生成的 |
| 预览模式 | 开关 | 开启/关闭 | 开启 | 鼠标悬停时是否显示大图预览 | 控制是否启用悬停预览功能 | 开启后方便快速查看 |
3.5 下载管理器
这里负责打包和下载所有结果，就像一个"快递打包站"。
功能说明：
- 自动将所有结果打包成压缩包
- 支持按参数分类打包
- 显示打包进度
- 提供下载链接
主要参数：
| 参数名称 | 参数类型 | 可选值 | 建议值 | 通俗解释 | 专业解释 | 使用示例 |
|---|---|---|---|---|---|---|
| 打包状态 | 状态显示 | 等待中/打包中/完成/失败 | 自动更新 | 显示打包的当前进度，就像快递状态 | 显示打包任务的执行状态 | "打包中"表示正在压缩文件 |
| 文件名称 | 文本显示 | 任务名称.zip | 自动生成 | 下载文件的名称，通常是任务名加.zip | 下载文件的完整文件名 | "风格测试_20241201.zip" |
| 文件大小 | 数字显示 | 自动计算 | 无需设置 | 显示压缩包的大小，帮你估算下载时间 | 压缩包的文件大小信息 | "156.7 MB" |
| 下载链接 | 按钮 | 点击下载 | 打包完成后可用 | 点击这个按钮开始下载压缩包 | 触发文件下载的操作按钮 | 打包完成后点击下载 |
3.6 资源上传器
这里用于上传批量处理需要的资源文件，就像一个"素材库"。
功能说明：
- 支持上传图片、Excel表格等文件
- 自动解析Excel中的参数配置
- 管理上传的资源文件
- 支持拖拽上传
主要参数：
| 参数名称 | 参数类型 | 可选值 | 建议值 | 通俗解释 | 专业解释 | 使用示例 |
|---|---|---|---|---|---|---|
| 文件类型 | 选择器 | 图片/Excel/压缩包 | 根据需要选择 | 选择要上传的文件类型 | 指定上传文件的格式类型 | 批量提示词选择Excel |
| 上传方式 | 选择器 | 点击选择/拖拽上传 | 拖拽上传 | 选择上传文件的方式，拖拽更方便 | 选择文件上传的交互方式 | 直接把文件拖到界面上 |
| 文件大小限制 | 数字显示 | 系统设定 | 无需修改 | 显示单个文件最大允许的大小 | 上传文件的大小限制 | "最大50MB" |
| 解析选项 | 复选框 | 自动解析/手动配置 | 自动解析 | Excel文件是否自动识别参数配置 | 控制是否自动解析文件内容 | Excel表格建议自动解析 |
3.7 语言切换器
这个功能让你可以在中文和英文界面之间切换，就像手机的语言设置。
功能说明：
- 支持中文和英文界面
- 实时切换，无需重启
- 记住用户选择
主要参数：
| 参数名称 | 参数类型 | 可选值 | 建议值 | 通俗解释 | 专业解释 | 使用示例 |
|---|---|---|---|---|---|---|
| 界面语言 | 切换按钮 | 中文/English | 中文 | 选择界面显示的语言 | 控制用户界面的显示语言 | 英文用户选择English |
| 自动检测 | 开关 | 开启/关闭 | 开启 | 根据浏览器语言自动选择界面语言 | 基于浏览器语言自动设置界面语言 | 开启后首次使用自动适配 |
4. 使用技巧和建议
4.1 新手入门建议
-
从简单开始：第一次使用时，建议只选择1-2个参数进行测试，比如只测试不同的采样步数。
-
合理控制数量：批量任务的数量 = 各个参数值数量的乘积。比如3个模型 × 5个提示词 = 15个任务。新手建议控制在20个以内。
-
先小批量测试：在大规模批量处理前，先用少量参数测试，确保工作流没问题。
4.2 高效使用技巧
-
使用魔法表达式：
1..10生成1到10的整数0.1..1.0:0.1生成0.1到1.0，步长0.1的小数seed1,seed2,seed3生成指定的种子值
-
参数分组策略：
- 把相关参数组合在一起，比如"模型+对应的最佳提示词"
- 避免无意义的参数组合
-
任务命名规范：
- 使用描述性名称，如"风格测试_20241201"
- 包含日期和主要测试内容
4.3 性能优化建议
-
控制并发数量：同时运行的批量任务不要太多，避免显卡过载。
-
合理设置优先级：紧急任务设置为-1，普通任务使用默认值0。
-
及时清理任务：定期删除不需要的历史任务，释放存储空间。
5. 常见问题解答
Q1：为什么我看不到批量工具按钮？
A： 检查以下几点：
- 确认插件已正确安装在 custom_nodes 目录
- 重启 ComfyUI 后再查看
- 检查浏览器控制台是否有错误信息
Q2：批量任务创建失败怎么办？
A： 常见原因和解决方法：
- 工作流本身有错误：先手动运行一次工作流确保正常
- 参数配置错误：检查参数值是否符合要求
- 内存不足：减少批量任务数量
Q3：生成的结果在哪里找？
A： 结果保存位置：
- 图片：ComfyUI的output文件夹
- 压缩包：插件的download文件夹
- 通过结果查看器可以直接预览和下载
Q4：如何取消正在运行的批量任务？
A： 在任务管理中心找到对应任务，点击"取消"按钮即可。
Q5：Excel文件应该如何格式化？
A： Excel文件格式要求：
- 第一行为参数名称
- 每一列代表一个参数
- 每一行代表一组参数值
- 支持文本、数字等多种类型
Q6：为什么有些任务显示失败？
A： 任务失败的常见原因：
- 工作流中的节点配置错误
- 缺少必要的模型文件
- 参数值超出允许范围
- 系统资源不足
6. 高级功能说明
6.1 自定义输出节点支持
插件自动识别以下类型的输出节点：
- SaveImage：保存图片节点
- ShowText|pysssss：显示文本节点
- VHS_VideoCombine：视频合成节点
- VideoCombine_Adv：高级视频合成节点
- SaveVideo：保存视频节点
6.2 资源管理功能
- 自动资源上传：批量任务创建时自动上传相关资源
- 资源映射管理：维护资源文件和任务的对应关系
- 智能清理：删除任务时自动清理相关资源文件
6.3 任务状态管理
插件支持以下任务状态：
- waiting：等待中
- running：运行中
- success：成功完成
- failed：执行失败
- cancelled：已取消
- partial_success：部分成功
7. 总结
ComfyUI Lumi Batcher 是一个功能强大的批量处理插件，它通过直观的Web界面让批量生成变得简单易用。无论你是新手还是专业用户，都能通过这个插件大大提高工作效率。
插件特色总结：
- 🎯 零学习成本：直观的界面设计，会用ComfyUI就会用这个插件
- 🚀 效率提升：一次设置，批量生成，告别重复操作
- 📊 结果管理：可视化结果展示，方便对比和选择
- 🔧 功能完整：从参数配置到结果下载，一站式解决方案
记住，这个插件的核心价值在于让你从繁琐的重复操作中解放出来，把更多时间用在创意和优化上。开始使用时建议从简单的参数测试开始，逐步掌握各种高级功能。