描述
快速批处理预览允许您将整个图像或遮罩批处理以单个H.264 MP4缩略图条的形式预览，在ComfyUI界面中以交互式网格显示。每个帧编码为I帧（关键帧），支持随机访问——点击任意图块可放大，然后前后浏览整个批处理，无需生成数百个单独的PNG文件。这使得大规模生成迭代显著更快且资源占用更少。
此节点属于 KJNodes/experimental 类别，设计为视觉诊断工具；它不产生任何数据输出。
输入
| 输入 | 类型 | 必填 | 默认值 | 最小值 | 最大值 | 步长 | 描述 |
|---|---|---|---|---|---|---|---|
input | IMAGE、MASK 或批处理 | ✅ | – | – | – | – | 要预览的图像或遮罩批处理。可以是单张图像、一批图像或遮罩批处理。 |
max_thumb_size | INT | ✅ | 512 | 512 | 1024 | 8 | 详细视图缩略图（点击图块后放大的视图）的最大边长（像素）。网格图块（缩略图条）的尺寸自动限制为256像素。 |
crf | INT | ✅ | 25 | 0 | 51 | 1 | H.264编码的恒定速率因子。值越低，图像质量越高，但文件体积越大；值越高，节省空间但降低质量。低于18的值通常被视为视觉无损。 |
max_grid_frames | INT | ✅ | 1024 | 1 | 4096 | 1 | 如果输入批处理的帧数超过此值，节点将等间隔采样批处理，使网格上只显示这么多帧。通过点击放大视图仍可访问整个批处理。 |
使用说明
- 何时使用快速批处理预览： 当您需要快速检查大量已生成帧时（例如在动画工作流、Latent批处理采样或遮罩序列验证期间），使用此节点代替保存单个预览图像。
- 文件处理： 生成的MP4文件临时存储，关闭ComfyUI后丢弃。不会写入标准输出文件夹。
- 内存与性能： 由于此节点使用带关键帧的单个视频文件，避免了写入和读取N个单独PNG的开销。预览成百上千帧的批处理时，可显著减少延迟。
- 等间隔采样逻辑： 当批处理长度超过
max_grid_frames时，网格显示帧的均匀子集（例如每N帧取一帧）。放大视图仍可遍历整个批处理。 - 无输出： 此节点仅用于实时预览，不会向下游传递数据。请将其放置在工作流链的末端。
- 实验性状态： 由于位于
KJNodes/experimental，此节点在未来的版本中可能发生API变更。升级自定义节点包时请检查更新。
评论
使用 GitHub 登录后即可参与讨论。