为 ComfyUI 工作流提供全参数交叉批量调试与可视化抽卡

方案简介

ComfyUI-Lumi Batcher 是字节跳动智能创作团队开源的 ComfyUI 批量处理扩展插件，专注于解决 AIGC 创作中重复调参、手动跑图、素材难管理的痛点。

传统 ComfyUI 调试方式下，用户需要在「模型/参数/尺寸」等维度反复手动替换，每次跑图只能验证一组参数，效率极低。Lumi Batcher 将 workflow 内的所有参数抽象为可交叉的批量维度，用户只需配置一次参数组合，即可由插件自动发起多次推理并聚合结果。

该插件定位于「调参抽卡 + 批量出素材」场景，适合需要高效产出大量风格对比图、商品素材或多模态内容的 AIGC 创作者、设计师及 AI 应用开发者。它通过 Excel/可视化表格的方式让用户对参数与生成结果的对应关系一目了然，显著提升工作流调试与素材生产效率。

亮点与能力

• 全参数交叉批量：不局限于 xyz 三维参数，workflow 内全部参数均可参与交叉调试
• 多组参数自由组合：支持「商品图 + prompt」X 不同基模等多维度参数组合
• 多维表格预览与导出：以表格形式聚合不同参数下的生成结果，便于可视化对比与批量导出
• 多模态支持：覆盖文本、图像、视频及音频场景的批量任务（1.0.11 起支持音频）
• 自定义输出目录：可自定义 output 目录，并兼容 was-node-suite-comfyui 插件的 Image Save 输出节点
• 第三方插件兼容：支持 cg-use-everywhere 等插件场景下的批量调用
• 结果回溯：支持将结果图拖入画布以恢复准确参数
• 双语界面：支持中文/英文双语切换

组成与分工

• ComfyUI：宿主平台，提供 workflow 引擎与节点运行环境
• ComfyUI-Lumi-Batcher：作为 CustomNode 扩展挂载，向 ComfyUI 注册批量任务入口（UI 面板右上角按钮）
• pandas (2.2.0)：参数组合表的加载与笛卡尔积展开，构建批量任务清单
• openpyxl (>=3.0.0)：解析 .xlsx 格式的参数配置表
• Pillow (>=9.0.0)：生成结果的图像读写、缩略图与预览处理
• aiohttp (>=3.11.8) + aiofiles (23.2.1)：通过 ComfyUI 提供的 HTTP API 异步发起任务并读写大体积输出文件
• filetype (1.2.0) + natsort (>=8.4.0)：识别结果文件类型并按自然排序整理批量产物

前置要求

环境要求

• 本地 Python 3.10 及以上版本
• 已安装并可正常运行的 ComfyUI 实例

安装方式一：通过 git 克隆到 ComfyUI 自定义节点目录

git clone https://github.com/bytedance/comfyui-lumi-batcher.git

安装方式二：通过 ComfyUI-Manager

在 ComfyUI-Manager 中搜索 comfyui-lumi-batcher，点击安装。

安装完成后重启 ComfyUI，UI 面板右上角会出现批量工具入口按钮。

实施步骤

1. 准备 ComfyUI 环境

确保本地已安装 ComfyUI，且 Python 版本不低于 3.10。

2. 拉取 Lumi Batcher 源码

进入 ComfyUI 的 CustomNode 目录，执行：

git clone https://github.com/bytedance/comfyui-lumi-batcher.git

或在 ComfyUI-Manager 中搜索 comfyui-lumi-batcher 并点击安装。

3. 重启 ComfyUI

安装完成后重启 ComfyUI 服务，使新扩展生效。

4. 打开批量工具面板

在 ComfyUI 的 UI 面板中，默认在右上角位置点击按钮，打开批量工具界面。

5. 配置参数组合

在工作流内选择需要批量调试的参数节点，通过表格填写多组参数值（如不同基模 × 不同 prompt × 不同尺寸），由插件自动展开笛卡尔积。

6. 发起批量任务

确认参数组合后提交，插件将通过 ComfyUI HTTP API 异步发起多次推理，结果自动落盘到自定义 output 目录。

7. 多维表格预览与导出

通过多维表格聚合不同参数下的生成结果，支持单元格上下左右切换、单图下载、拖回画布恢复参数等操作。

使用与配置要点

验证安装成功

重启 ComfyUI 后，若 UI 面板右上角出现批量工具按钮，即代表扩展加载成功。

自定义输出目录

1.0.5 起支持自定义 output 目录，并兼容 was-node-suite-comfyui 插件的 Image Save 输出节点，可将批量结果定向保存到指定路径。

参数魔法表达式

1.0.3 起自定义参数支持魔法表达式快速输入，便于按规则批量构造参数值（如序列填充）。

任务管理

1.0.3 起任务管理面板支持删除功能；单图结果预览支持一键下载；大图场景下支持单元格上下左右导航而不会触发缩放异常（1.0.9 修复）。

结果回溯

1.0.8 起支持将结果图拖入画布，自动恢复准确的参数配置，便于二次微调。

注意事项与常见问题

• 平台强依赖：本插件本质是 ComfyUI CustomNode，必须依附 ComfyUI 宿主，无法脱离 ComfyUI 单独运行。
• 版本兼容性：README 列出版本日志显示插件需持续跟进 ComfyUI 官方版本改动（如 0.3.44 的 validate_prompt 变更、0.3.67 的 UI 模板选择弹窗），升级 ComfyUI 后需关注插件版本是否同步兼容。
• 路径兼容性：1.0.1 修复了 Windows 场景下文件相对路径和路径兼容性问题，Windows 用户应确保使用 1.0.1 及以上版本。
• 第三方生态：与 cg-use-everywhere、was-node-suite-comfyui 等第三方插件的兼容性已在对应版本中声明支持。
• API 节点场景：1.0.5 起支持使用 ComfyUI API 节点场景下的批量任务。
• 新手帮助：官方提供了飞书新手帮助文档作为补充资料。

优缺点

• ✓ 支持工作流内全部参数交叉
• ✓ 表格化预览与批量导出结果
• ✕ 强依赖 ComfyUI 宿主环境
• ✕ README 较薄缺乏完整 API 文档

出处

本方案挖掘自开源项目 bytedance/comfyui-lumi-batcher，方案内容与实施命令均来自其 README 原文。