模型预览覆盖(ModelPreviewOverrideKJ)

模型预览覆盖节点（类 ModelPreviewOverrideKJ）在节点上添加一个专用实时预览帧，绕过 ComfyUI 默认的 512 像素采样器预览限制。这对于像素空间模型（Chroma Radiance、ZImage、HiDream-O1 等）特别有用，它们受益于在完整采样器分辨率下查看中间结果。该节点还支持视频模型的动画 WebP 预览，并可选地抑制标准采样器节点预览覆盖，以获得更清晰的工作流。

输入

model（MODEL，必填）

要附加预览覆盖的模型。采样过程中的每一步都将在此节点上生成实时预览。

max_resolution（INT，默认值 1024，范围 0–8192，步长 8）

实时预览小部件的最大边长（以像素为单位）。

• 0 – 不缩小；预览以完整采样器分辨率渲染（极高分辨率时请谨慎使用）。
• 任何正值 – 预览的长边被限制为此大小；另一侧按比例缩放。

jpeg_quality（INT，默认值 80，范围 30–100，步长 1）

将预览图像压缩以传输到 DOM 小部件时使用的 JPEG 质量。值越大画质越好但负载越大；值越小开销越低但压缩伪影可见。

suppress_default_preview（BOOLEAN，默认值 true）

启用后，采样时标准采样器节点预览覆盖将被隐藏，仅此节点的帧更新。进度条继续正常前进。如果仍然希望看到默认的 ComfyUI 预览与节点的实时帧同时显示，请禁用此选项。

preview_frames（INT，默认值 1，范围 1–1024，步长 1）

从每个视频步骤的 Latent 中采样的帧数，用于生成动画预览。

• 1 – 单帧（当前行为，最快）。
• 2 到 1024 – 从采样的帧生成动画 WebP，以 preview_fps 设置的帧率播放。 此输入仅对视频模型（5D Latent）有效；对于图像模型将被忽略。

preview_fps（INT，默认值 12，范围 1–60，步长 1）

动画 WebP 预览的播放帧率。当 preview_frames 为 1 时忽略。

vae（VAE，可选）

可选的 VAE，用于将 Latent 解码为真彩色预览。

• TAEHV‑LTX – 使用快速、小巧的解码（VAE 顶固在 GPU 上）。
• 任何其他 LTX VAE – 通过 vae.decode() 执行全质量解码，每步明显较慢。 如果未提供，节点将回退到模型的默认 VAE（如果可用）或标准解码方法。

输出

MODEL

传递给 model 输入的同一模型，保持不变。此节点是一个直通节点，添加预览功能而不修改模型或其输出。

使用说明

• 实时预览帧作为节点上的自包含小部件出现，因此即使采样器节点的预览被隐藏或启用了 suppress_default_preview，它仍然可见。
• 对于视频模型，将 preview_frames 设置为大于 1 的值，可在采样期间看到动画预览。请注意，每步提取多帧会增加内存和计算开销。
• 使用可选 VAE 时，速度与画质的权衡由 VAE 类型控制：TAEHV‑LTX 优先考虑速度；其他 LTX VAE 优先考虑保真度。