简体中文 | English

https://github.com/user-attachments/assets/9d4588b5-696f-4b5c-b01b-4b6def5056cf

 

---

 

📌 概述

ComfyUI-Lumi-Batcher 是 ComfyUI 的专用批量处理扩展，旨在提升 AIGC 创作效率。

 

😭 您是否正面临以下创作挑战？

❌ 模型选择困难：
花费数小时手动更换模型，却始终无法确定最佳风格。

❌ 参数调优头疼：
反复调整尺寸、权重、采样步数等参数多达20次，仍无法达到预期效果。

❌ 素材管理混乱：
生成100张图片命名不统一，耗费10分钟生成，却要花2小时才能找到所需文件。

 

---

 

☀️ ComfyUI-Lumi-Batcher 如何解决这些问题？

ComfyUI-Lumi-Batcher 不仅超越了 WebUI 中的 XYZ Plot 等工具，更成为强大的批量生成与参数测试利器。

• 突破基础维度限制：可自由交叉测试任何工作流参数，不受 XYZ 轴的约束。
• 灵活的参数组合：支持创意性地组合参数（如“产品图 + 提示词” × 不同基础模型）。
• 可视化结果管理：以多维网格形式浏览输出结果，便于预览和批量导出。

 

---

 

😁 为什么选择 ComfyUI-Lumi-Batcher？

• 🔥 易于上手：界面直观，学习曲线低——可无缝衔接您现有的 ComfyUI 使用经验。
• 🔥 效率大幅提升：用单次参数配置取代重复的手动输入，并借助 AI 辅助进行素材管理。
• 🔥 多模态支持：加速文本、图像及视频创作流程。

 

---

 

⭐️ 发布说明

• 🎵 1.0.11 版：支持音频场景批量处理

• ✂️ 1.0.10 版：适配 ComfyUI 最新 0.3.67 版本更新，确保批量工具功能正常运行。

• 🚀 1.0.9 版：修复预览表格中切换含图片/视频单元格时的缩放问题；新增使用方向键导航单元格的功能。

• 🚀 1.0.8 版：修复 ComfyUI 官方最新 UI 模板选择弹窗中的滚动问题，并支持将结果图片拖拽至画布以恢复准确参数。

• ✂️ 1.0.7 版：适配 ComfyUI 最新更新，保障批量工具功能稳定。

• ☀️ 1.0.6 版：兼容 ComfyUI 官方 0.3.44 版本对 validate_prompt 的改动。

• ☕️ 1.0.5 版：支持 API 节点场景下的批量处理，允许自定义输出目录，并且批量支持 was-node-suite-comfyui 插件中的 Image Save 输出节点。

• 👁 1.0.4 版：优化从工作流发起批量任务时的检测逻辑，避免实际启动推理任务；同时支持使用 cg-use-everywhere 插件场景下的批量处理。

• 🔍 1.0.3 版：任务管理新增删除功能，自定义参数支持魔法表达式快速输入，单张结果预览新增下载功能。

• 📚 1.0.2 版：支持中英双语版本及语言切换功能。

• 💻 1.0.1 版：修复 Windows 环境下文件相对路径及路径兼容性问题。

• 🎉 1.0.0 版：ComfyUI-Lumi-Batcher 首次发布，具备基础批量处理功能及多模态支持。

 

---

 

🚀 安装

本地环境需安装 Python 3.10 或更高版本

• 方法一：在 ComfyUI 的 CustomNode 目录下，使用 git 命令克隆该项目，然后重启 ComfyUI：

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

• 方法二：在 ComfyUI-Manager 中搜索 comfyui-lumi-batcher 并点击安装。

安装完成后，在 ComfyUI 的 UI 面板右上角，默认位置，点击按钮即可打开批量工具界面。

 

---

 

🤝 获取帮助

新手指南

ComfyUI Lumi Batcher 快速上手指南

ComfyUI Lumi Batcher 是由字节跳动智能创作团队开发的专用批处理扩展，旨在解决模型切换繁琐、参数调试困难及素材管理混乱等痛点。它支持超越传统 XYZ Plot 的多维参数组合测试，并具备可视化的结果管理与导出功能。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows / Linux / macOS
• Python 版本：3.10 或更高版本
• 前置依赖：已安装并正常运行的 ComfyUI 环境

安装步骤

您可以选择以下任意一种方式进行安装：

方法一：使用 ComfyUI Manager（推荐）

1. 启动 ComfyUI，点击右侧菜单中的 Manager 按钮。
2. 选择 Install Custom Nodes。
3. 在搜索框中输入 comfyui-lumi-batcher。
4. 找到对应插件后点击 Install。
5. 安装完成后，重启 ComfyUI 以生效。

方法二：使用 Git 命令手动安装

1. 进入 ComfyUI 的自定义节点目录：

   cd ComfyUI/custom_nodes
   

2. 克隆项目仓库：

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

3. 安装完成后，重启 ComfyUI。

提示：若国内网络访问 GitHub 较慢，可尝试配置 Git 代理或使用国内镜像源加速克隆过程。

基本使用

安装并重启 ComfyUI 后，请按以下步骤开始第一次批处理任务：

1. 打开工具界面 在 ComfyUI 主界面右上角，点击新出现的 Lumi Batcher 按钮（通常显示为网格或批量图标），弹出批处理控制面板。

2. 配置工作流与参数

   • 加载您现有的 ComfyUI 工作流（例如文生图或图生图流程）。
   • 在 Lumi Batcher 面板中，选择需要批量测试的参数（如：Checkpoint 模型、Prompt 提示词、采样步数、分辨率等）。
   • 利用其灵活的分组功能，设置多维度的参数组合（例如：3 种模型 × 5 组提示词）。

3. 执行与预览

   • 点击 Start Batch 开始任务。
   • 任务运行期间，您可以在面板的多维网格中实时预览生成的图片/视频结果。
   • 支持使用方向键快速浏览不同单元格的结果，或直接拖拽结果图回画布以还原对应参数。

4. 导出结果 测试完成后，利用内置的管理功能对满意的结果进行批量导出或整理，无需手动在文件夹中筛选。