快速结论:该问题通常出现在把带 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、显卡或依赖版本信息,无需据此调整排查方向。
解决步骤
- 将 ComfyUI Impact Pack 更新到包含 #1282(
1374741)的版本,并重启 ComfyUI。 - 打开工作流中的
PreviewBridge节点,找到新增的alpha_as_mask选项。 - 对于
Join Image with Alpha→PreviewBridge且 alpha 为分割掩码的场景,启用alpha_as_mask。 - 保持
restore_mask默认逻辑即可:启用alpha_as_mask后,输入 alpha 从第一次运行起即为 MASK 输出,掩码编辑器以它为起点;输入不变时编辑器内的修改会被保留,输入变化时新 alpha 会替换旧掩码。 - 如果不需要把输入 alpha 当作掩码,保持
alpha_as_mask禁用:此时 MASK 在首次及后续运行均为空,直到在掩码编辑器中绘制,且restore_mask只恢复编辑器保存的掩码,不再恢复上一次输入的 alpha。 - 如有此前按 Issue 建议添加的本地补丁(针对
mask is None的改动),在升级后移除,避免与官方实现冲突。
验证方法
启用 alpha_as_mask 后重新运行工作流:第一次运行应直接输出该 alpha 对应的掩码(包括高斯模糊后的柔和边缘),而不是空的 64×64 掩码;在掩码编辑器中以不同笔刷不透明度修改后,只要上游输入不变,修改应被保留;更换上游分割后再次运行,输出掩码应替换为新分割而不是沿用旧对象。按要求,若行为不符可重新打开该 Issue。
参考来源
ltdrdata/ComfyUI-Impact-Pack #1283
AI 工具推荐
想把多个 AI 模型放在一个入口?
GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型,适合写作、绘图、视频和日常 AI 工作流。
推广链接:通过此链接购买,我可能获得佣金,不影响你的价格。
这个方案解决了吗?
可以继续搜索完整报错,或查看同一工具的其他排查指南。


