[Bug] KSampler preview error when using –preview-method auto with live preview enabled

问题场景

在 ComfyUI 中使用 KSampler 节点进行采样，启动参数为 --preview-method auto，并在采样过程中启用 live/dynamic preview（实时/动态预览）。此时自定义采样器可能工作正常，但 KSampler 在准备预览回调阶段抛出异常，导致工作流处理失败。相关调用链为 ComfyUI 的 latent_preview.py 进入 VideoHelperSuite 的 videohelpersuite/latent_preview.py，在 WrappedPreviewer 初始化时触发异常。

报错原文

[ERROR] !!! Exception during processing !!! Unsupported preview type for VHS animated previews
Traceback (most recent call last):
  File "...\ComfyUI\execution.py", line 545, in execute
    ...
  File "...\ComfyUI\nodes.py", line 1585, in common_ksampler
    callback = latent_preview.prepare_callback(model, steps)
  File "...\ComfyUI\latent_preview.py", line 117, in prepare_callback
    previewer = get_previewer(model.load_device, model.model.latent_format)
  File "...\ComfyUI\custom_nodes\ComfyUI-VideoHelperSuite\videohelpersuite\latent_preview.py", line 114, in get_latent_video_previewer
    return WrappedPreviewer(previewer, rate_setting)
  File "...\ComfyUI\custom_nodes\ComfyUI-VideoHelperSuite\videohelpersuite\latent_preview.py", line 31, in __init__
    raise Exception('Unsupported preview type for VHS animated previews')
Exception: Unsupported preview type for VHS animated previews

原因分析

根据 Issue 评论确认，此问题由 ComfyUI-bleh 插件引起。ComfyUI-bleh 与 VideoHelperSuite 在预览处理上存在冲突：VideoHelperSuite 的 WrappedPreviewer 只接受特定类型的预览器，而 ComfyUI-bleh 提供的预览器不带 taesd 或 latent_rgb_factors 属性，于是被判定为“Unsupported preview type for VHS animated previews”。自定义采样器不受影响，可能是因为其预览路径没有经过同一段 KSampler 预处理逻辑。

环境排查

• 确认 ComfyUI 启动参数是否为 --preview-method auto，以及采样时是否开启 live/dynamic preview。
• 确认是否安装了 ComfyUI-bleh 插件，以及其配置文件中是否启用了预览相关选项。
• 确认 ComfyUI-VideoHelperSuite 版本是否为 Issue 中涉及的分支/提交（4d907bee61e92c2e65af3bd6383a4e4d356126d1）。
• 确认报错栈是否包含 ComfyUI-Lora-Manager 的 metadata_hook.py；该文件出现在调用链中，但不代表它是根因。
• Check Issue 未提供 Python、CUDA、PyTorch、显卡型号信息，这些项目无需作为已知必需条件，但排查时建议确认依赖版本与当前 ComfyUI 版本兼容。

解决步骤

1. 优先尝试 Issue 评论中的 Option 1：按 ComfyUI-bleh 的配置说明，在 blehconfig.yaml 中关闭其预览选项，然后重启 ComfyUI 并重新运行 KSampler 工作流。该方式避免修改 VideoHelperSuite，是确认可行的规避方案。
2. 如果必须同时保留 ComfyUI-bleh 与 VideoHelperSuite 的预览，可尝试 Option 2：修改 ComfyUI-VideoHelperSuite/videohelpersuite/latent_preview.py。修改前先备份该文件。
3. 在 latent_preview.py 第 28 行附近，将 self.latent_rgb_factors_bias 的赋值改为使用 getattr(previewer, 'latent_rgb_factors_bias', None)，以兼容不含该属性的预览器。
4. 在第 113 行之后（get_latent_video_previewer 相关逻辑处）加入 Issue 评论给出的判断：如果 previewer 既没有 taesd 也没有 latent_rgb_factors，则从 latent_format 中取 latent_rgb_factors；为空时直接返回原 previewer；否则用 latent_preview.Latent2RGBPreviewer 重新包装，并传入 latent_rgb_factors_bias 与 latent_rgb_factors_reshape。
5. 保存后重启 ComfyUI，再运行相同的 KSampler 工作流验证。

验证方法

重新以 --preview-method auto 启动 ComfyUI，开启采样实时预览，运行一个使用 KSampler 的工作流。若不再出现 Unsupported preview type for VHS animated previews，且采样过程与预览显示正常，则说明冲突已避开或补丁生效。若选择 Option 2，还应确认 ComfyUI-bleh 的预览功能与 VideoHelperSuite 的动画预览可以同时工作。

参考来源

Kosinkadink/ComfyUI-VideoHelperSuite #714

AI 工具推荐

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

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

了解 GamsGo AI

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