
Preview Bridge (Image) can’t open Mask Editor
快速结论:这个报错出现在使用 ComfyUI Impact Pack 的 Preview Bridge (Image) 节点时,点击打开 Mask Editor 无反应。优先排查 ComfyUI_frontend 版本是否过高,已知 1.33.10 版本存在兼容性问题。
问题场景
用户升级 ComfyUI 及相关组件后,在 Impact Pack 的 Preview Bridge (Image) 节点上点击 Mask Editor 按钮无法弹出编辑器。Mask Editor 从其他节点(如 Load Image)启动时工作正常。此外,Preview Bridge 节点在收到新图像后,原本应生成 4 张图像到 input/clipspace 目录,升级后不再创建这些图像。
报错原文
Preview Bridge (Image) can't open Mask Editor
Usually the Preview Bridge node create 4 images in the "input/clipspace" when receiving a new image. These images are not being created anymore.
开发者控制台显示错误:
它试图用奇怪的“$1-0”占位符值作为文件名打开图片
原因分析
可能原因:ComfyUI_frontend 1.33.10 版本中,Preview Bridge 节点的 JavaScript 代码中某个钩子(hook)不再正常工作,导致在调用 Mask Editor 时传入了错误的占位符(如 $1-0、$6-0)作为文件名,从而无法正确打开编辑器。这是一个前端兼容性问题,而非后端逻辑错误。
环境排查
- ComfyUI 版本:0.3.76(触发问题),0.3.77(暂时未修复)
- ComfyUI_frontend 版本:v1.33.10(已知问题版本)
- ComfyUI-Impact-Pack 版本:8.28.0
- ComfyUI-Manager 版本:V3.37.2
- Inspire-Pack 版本:1.23.0
- Python 版本:3.13.6
- PyTorch 版本:2.8.0+cu129
- 操作系统:Windows(win32)
解决步骤
注意:以下解决方法仅为社区用户提供的临时应急方案,官方尚未发布完全修复补丁。
- 降级 ComfyUI_frontend 版本(可优先尝试):将 ComfyUI_frontend 版本回退到
1.32.10。降级后 Mask Editor 应能正常打开。但请注意,此版本可能与新版 ComfyUI 不完全兼容(尽管经测试仍可使用),且每次工作流需要刷新后才能在新图像上做遮罩。 - 升级 ComfyUI:将 ComfyUI 升级到 0.3.77 版本。注意:有用户报告升级到 0.3.77 后问题仍然存在,仅供尝试。
- 等待官方修复:该问题在 Impact Pack 的 GitHub Issue #1155 中已被确认,但截至关闭时(2025-12-05)尚未有完美解决方案。建议关注后续 ComfyUI_frontend 或 Impact Pack 的更新。
验证方法
降级后,在 Preview Bridge (Image) 节点上点击 Mask Editor 按钮,观察是否能正常弹出编辑器界面。同时可检查 ComfyUI/input/clipspace 目录,确认节点收到新图像后是否重新生成 4 张临时图像文件。



