PreviewBridge: with an RGBA input, the MASK output differs between the first and the next runs, and `restore_mask` restores the previous inp

该问题通常出现在把带 alpha 通道的 RGBA 图像(例如 Join Image with Alpha 输出的分割 alpha)接入 PreviewBridge 时:首次运行 MASK 输出为空,而 restore_mask 又会把上一次输入图像的 alpha 当成“已保存的掩码”恢复出来。优先

快速结论:该问题通常出现在把带 alpha 通道的 RGBA 图像(例如 Join Image with Alpha 输出的分割 alpha)接入 PreviewBridge 时:首次运行 MASK 输出为空,而 restore_mask 又会把上一次输入图像的 alpha 当成“已保存的掩码”恢复出来。优先排查并启用 PreviewBridge 的 alpha_as_mask 选项。

适用环境:ComfyUI Impact Pack,主分支版本 61b9388(含 #1275 的修复),工作流为 Join Image with Alpha → PreviewBridge;修复版本为 1374741(反馈中称为 8.31),启用 alpha_as_mask 后验证通过。

最快修复方案:更新到包含 #1282(1374741)的版本,在 PreviewBridge 节点中启用新增的 alpha_as_mask 选项。此后 RGBA 输入的 alpha 会从第一次运行起直接作为 MASK 输出。

注意事项:alpha_as_mask 默认是禁用的,此时 alpha 只属于图像、不会被当作掩码,首次运行 MASK 仍为空;只有在需要“把输入 alpha 作为初始掩码”的场景(如用分割结果做手动修图起点)才应启用。启用后输入变更时新 alpha 会替换旧掩码,restore_mask 不会覆盖它。

问题场景

用户在 ComfyUI 中运行 Impact Pack 的 PreviewBridge 节点,上游用 Join Image with Alpha 把一张图像与自动分割得到的 alpha 合成 RGBA 图像输入。由于 PreviewBridge 会把掩码存进预览文件的 alpha 通道,RGBA 输入中的“输入 alpha”与“编辑器中绘制的掩码”被混在一起,从而出现两种不一致行为:restore_mask = never 时输入变化后的第一次运行 MASK 输出为空的 64×64 掩码(mask = None → torch.zeros((64, 64))),第二次运行才得到新的分割;restore_mask = always / if_same_size 时,输入变化后 get_previewbridge_mask(image) 读取的是上一个预览文件的 alpha(即上一次的分割),并被写入新预览和输出,导致分割对象换了、掩码仍停留在旧对象上。

报错原文

PreviewBridge: with an RGBA input, the MASK output differs between the first and the next runs, and `restore_mask` restores the previous input alpha

原因分析

可能原因:PreviewBridge 在刷新分支中当 mask is None 时直接输出空掩码,未处理 RGBA 输入自带的 alpha;同时 restore_mask 恢复逻辑读取的是预览文件 alpha,无法区分“掩码编辑器保存的掩码”与“上游输入的 alpha”。Issue 作者给出的本地临时改动是在 if mask is None: 之前补充 if mask is None and images.shape[-1] == 4: mask = 1. - images[..., 3],但这一方案仅用于说明问题,未被作为正式修复。

环境排查

  • 确认 Impact Pack 版本是否包含 #1282 修复(提交 1374741);旧版本(如 61b9388)不含 alpha_as_mask 选项。
  • 确认 PreviewBridge 节点参数中是否存在 alpha_as_mask,以判断是否已升级到修复版本。
  • 确认上游是否确实输出 4 通道 RGBA 图像(例如 Join Image with Alpha 且 alpha 为分割结果)。
  • 确认 restore_mask 当前取值为 never、always 还是 if_same_size,以便对照复现现象。
  • Issue 未提供操作系统、Python、CUDA、PyTorch、显卡或依赖版本信息,无需据此调整排查方向。

解决步骤

  1. 将 ComfyUI Impact Pack 更新到包含 #1282(1374741)的版本,并重启 ComfyUI。
  2. 打开工作流中的 PreviewBridge 节点,找到新增的 alpha_as_mask 选项。
  3. 对于 Join Image with Alpha → PreviewBridge 且 alpha 为分割掩码的场景,启用 alpha_as_mask。
  4. 保持 restore_mask 默认逻辑即可:启用 alpha_as_mask 后,输入 alpha 从第一次运行起即为 MASK 输出,掩码编辑器以它为起点;输入不变时编辑器内的修改会被保留,输入变化时新 alpha 会替换旧掩码。
  5. 如果不需要把输入 alpha 当作掩码,保持 alpha_as_mask 禁用:此时 MASK 在首次及后续运行均为空,直到在掩码编辑器中绘制,且 restore_mask 只恢复编辑器保存的掩码,不再恢复上一次输入的 alpha。
  6. 如有此前按 Issue 建议添加的本地补丁(针对 mask is None 的改动),在升级后移除,避免与官方实现冲突。

验证方法

启用 alpha_as_mask 后重新运行工作流:第一次运行应直接输出该 alpha 对应的掩码(包括高斯模糊后的柔和边缘),而不是空的 64×64 掩码;在掩码编辑器中以不同笔刷不透明度修改后,只要上游输入不变,修改应被保留;更换上游分割后再次运行,输出掩码应替换为新分割而不是沿用旧对象。按要求,若行为不符可重新打开该 Issue。

参考来源

ltdrdata/ComfyUI-Impact-Pack #1283

GamsGo AI

AI 工具推荐

想把多个 AI 模型放在一个入口?

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。

这个方案解决了吗?

celebrityanime
celebrityanime
文章: 36045

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注