上下文窗口可视化节点（KJ节点）(ContextWindowsVisualizerKJ)

描述

一个用于 ComfyUI 上下文窗口的交互式可视化节点。它在参数调整时实时显示窗口位置、重叠、融合权重以及逐帧混合。当连接了 model 时，该节点可选择在采样期间将配置的上下文窗口设置应用于模型，其功能类似于核心的**上下文窗口（手动）**节点。

输入

所有输入都控制可视化效果，并在连接了模型时控制应用的上下文窗口行为。

• model（MODEL，可选）
  一个可选的模型，用于在采样期间将上下文窗口应用于该模型。当未连接时，仅显示可视化。

• frame_units（COMBO，默认值：pixel）
  帧计数的单位。

  • pixel：通过 ((n - 1) // temporal_downscale) + 1 将像素帧索引转换为 Latent 索引。
  • latent：帧计数直接作为 Latent 帧索引处理。

• dim（INT，默认值：2，范围：0–5）
  Latent 时间维度的索引。对于类似 Wan 万相的架构，典型值为 2；对于 AnimateDiff 风格，为 0。仅当连接了模型时相关（“模型路径”）。

• temporal_downscale（INT，默认值：4，范围：1–16）
  当 frame_units = pixel 时使用的 VAE 时间压缩因子。常见值：Wan 万相/Hunyuan/CogVideoX = 4，Mochi = 6，LTXV = 8。

• num_frames（INT，默认值：161，范围：1–100000）
  当未连接模型时（纯可视化路径）要可视化的总帧数。当连接了模型时，此值将被忽略，并使用模型的实际 Latent 长度。

• context_length（INT，默认值：81，范围：1–100000）
  窗口长度，以帧单位计。

• context_overlap（INT，默认值：30，范围：0–100000）
  相邻窗口之间的重叠帧数。

• context_schedule（COMBO，无默认值）
  决定窗口放置策略。

  • standard_static_balanced：静态窗口在帧范围内均匀分布，保证任何帧数下都有均匀的接缝。
  • batched_shifted：零重叠窗口，其接缝位置在每个采样步骤中滚动（约 1.0 倍计算量；建议与 FreeNoise 配对使用）。
    均匀调度（未来将添加）也会在每个步骤中移位。

• context_stride（INT，默认值：1，范围：1–32）
  均匀调度的最大步长幂。控制扩张窗口（例如 1、2、4…）。仅当选择了均匀调度时生效。

• closed_loop（BOOLEAN，默认值：否）
  启用时，将循环调度的窗口从末尾绕回到第 0 帧。

• fuse_method（COMBO，默认值：pyramid）
  重叠区域的混合方法。选项代表不同的加权策略（例如：金字塔、均匀等）。

• causal_window_fix（BOOLEAN，默认值：否）
  在非零窗口（第一个窗口除外）前添加一个锚定帧，该帧在模型调用后被移除。适用于因果时间注意力。

• freenoise（BOOLEAN，默认值：是）
  启用 FreeNoise 噪波混洗，以实现跨窗口的更平滑混合。仅当连接了模型时相关（“模型路径”）。

• cond_retain_index_list（STRING，默认值：""）
  逗号分隔的窗口相对帧索引列表，这些帧的条件会在不同窗口中重复使用。例如，"0" 会在每个窗口中重复使用第一帧的条件。对可视化无影响；仅当连接了模型时生效。

输出

• MODEL
  如果提供了输入模型，则输出是应用了配置的上下文窗口的同一模型。如果未提供模型，则输出为 None（该节点纯粹作为可视化节点使用）。

使用说明

• 可视化会随着任何参数的变化实时更新，即时反馈窗口位置、重叠和混合情况。
• 当仅使用节点进行可视化（未连接模型）时，num_frames 输入设置总帧数。标记为“仅模型路径”的参数（dim、freenoise、cond_retain_index_list）将被忽略。
• 仅对模型路径有效的参数在其工具提示中已明确标注。frame_units 的转换仅在从像素计数推导 Latent 索引时才有意义；如果直接在 Latent 空间中工作，请将 frame_units 设置为 latent。
• 对于像 batched_shifted 这样的调度，建议与 freenoise 配对使用，以实现平滑过渡。
• causal_window_fix 选项适用于具有因果注意力的模型（例如某些视频扩散模型），其中每个窗口需要一个前置锚定帧。