Image Batch Filter (ImageBatchFilter) - ComfyUI-KJNodes

Image Batch Filter 节点，该节点接收一个图像批次作为输入，并允许用户定义一个代表“空”的颜色值（如纯黑）和一个容差阈值。

Image Batch Filter 是一个用于图像批处理的过滤节点，其核心功能是自动识别并移除批次中的“空”图像。它通过比较图像与指定颜色来判断是否为空，从而帮助用户清理无效的图像数据，提升后续处理流程的效率。

节点功能

该节点接收一个图像批次作为输入，并允许用户定义一个代表“空”的颜色值（如纯黑）和一个容差阈值。在内部，它会计算批次中每张图像与指定颜色的平均差异，若差异低于阈值，则判定该图像为空。用户可以选择直接移除这些空图像，或用另一张替换图像来填充其位置，以保持批次大小不变。

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`images`	IMAGE	是	-	-	images（输出参数）：过滤或替换后的图像批次。
`replacement_image`	IMAGE	否	-	-	replacement_image（输入参数）：可选参数，用于替换被判定为空图像的图像。若不提供，则直接移除空图像。

参数名称	数据类型	必填	默认值	取值范围/选项	说明
`empty_color`	STRING	是	0, 0, 0	-	empty_color（输入参数）：定义被视为“空”的颜色，格式为“R, G, B”的字符串，例如“0, 0, 0”代表纯黑色。
`empty_threshold`	FLOAT	是	0.01	0.0 - 1.0 (步长: 0.01)	empty_threshold（输入参数）：判断图像是否为空的容差阈值，范围 0.0 到 1.0，步长 0.01。值越小，判断越严格。

参数名称	数据类型	说明
images	IMAGE	images（输出参数）：过滤或替换后的图像批次。
removed_indices	STRING	removed_indices（输出参数）：以字符串形式输出被移除或替换的图像在原批次中的索引位置。

在生成图像的工作流中，如果上游节点（如批量生成或图像加载）可能产生大量纯色或无效的占位图像，可以使用此节点进行自动过滤。例如，在结合多个 LoRA 模型进行批量风格测试时，用此节点过滤掉生成失败的纯色图，只将有效的图像传递给后续的放大或组合节点，确保流程顺畅。

该节点要求替换图像（如果提供）的通道数与输入图像一致，否则会进行自动缩放，这可能影响图像质量。此外，空颜色的判断基于像素平均值，对于包含细微噪声或纹理的“近似空”图像可能不够精确，需根据实际情况调整阈值。