コンテキストウィンドウビジュアライザー (KJ)(ContextWindowsVisualizerKJ)

説明

ComfyUIのコンテキストウィンドウをインタラクティブに可視化するノードです。パラメータを調整すると、ウィンドウ配置、オーバーラップ、フューズ重み、フレームごとのブレンドをリアルタイムで表示します。modelが接続されている場合、このノードは設定されたコンテキストウィンドウ設定をサンプリング中にモデルにオプションで適用します。これはコアの**Context Windows (Manual)**ノードと同様に機能します。

入力

すべての入力は可視化を制御し、モデルが接続されている場合は適用されるコンテキストウィンドウの動作も制御します。

• model (MODEL、オプション)
  サンプリング中にコンテキストウィンドウを適用するオプションのモデル。切断されている場合は、可視化のみが表示されます。

• frame_units (COMBO、デフォルト: pixel)
  フレーム数の単位。

  • pixel: ピクセルフレームインデックスを((n - 1) // temporal_downscale) + 1で潜在インデックスに変換します。
  • latent: フレーム数を直接潜在フレームインデックスとして扱います。

• dim (INT、デフォルト: 2、範囲: 0–5)
  潜在時間次元インデックス。WANライクなアーキテクチャでは2が一般的、AnimateDiffスタイルでは0。モデルが接続されている場合（"model path"）のみ関連します。

• temporal_downscale (INT、デフォルト: 4、範囲: 1–16)
  frame_units = pixelのときに使用されるVAE時間圧縮係数。一般的な値: WAN/Hunyuan/CogVideoX = 4、Mochi = 6、LTXV = 8。

• num_frames (INT、デフォルト: 161、範囲: 1–100000)
  モデルが接続されていないとき（可視化のみのパス）に可視化する総フレーム数。モデルが接続されている場合は無視され、モデルの実際の潜在長が使用されます。

• 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、デフォルト: False)
  有効にすると、ループスケジュールのウィンドウを末尾からフレーム0に折り返します。

• fuse_method (COMBO、デフォルト: pyramid)
  オーバーラップ領域のブレンド方法。オプションは異なる重み付け戦略（例: pyramid、uniformなど）を表します。

• causal_window_fix (BOOLEAN、デフォルト: False)
  ゼロ以外のウィンドウ（最初のウィンドウを除く）にアンカーフレームを前置し、モデル呼び出し後に取り除きます。因果的時間アテンションに有用です。

• freenoise (BOOLEAN、デフォルト: True)
  FreeNoiseノイズシャッフリングを有効にし、ウィンドウ間のブレンドをスムーズにします。モデルが接続されている場合（"model path"）のみ関連します。

• cond_retain_index_list (STRING、デフォルト: "")
  ウィンドウ相対フレームインデックスのカンマ区切りリストで、その条件付けがウィンドウ間で再利用されます。例えば"0"は各ウィンドウの最初のフレームの条件付けを再利用します。可視化には影響せず、モデルが接続されている場合のみ適用されます。

出力

• MODEL
  入力としてモデルが指定された場合、出力は設定されたコンテキストウィンドウが適用された同じモデルです。モデルが指定されていない場合、出力はNoneです（ノードは純粋に可視化として機能します）。

使用上の注意

• パラメータが変更されるたびに可視化がリアルタイムで更新され、ウィンドウ配置、オーバーラップ、ブレンドを即座にフィードバックします。
• ノードを可視化のみに使用する場合（モデル未接続）、num_frames入力が総フレーム数を設定します。"model path only"とマークされたパラメータ（dim、freenoise、cond_retain_index_list）は無視されます。
• モデルパスでのみ有効なパラメータは、ツールチップに明確に記載されています。frame_unitsの変換は、ピクセル数から潜在インデックスを導出する場合にのみ重要です。潜在空間で直接作業する場合は、frame_unitsをlatentに設定してください。
• batched_shiftedなどのスケジュールでは、スムーズな遷移のためにfreenoiseと組み合わせることを推奨します。
• causal_window_fixオプションは、因果的アテンションを持つモデル（例: 一部のビデオ拡散モデル）を対象としており、各ウィンドウに先行するアンカーフレームが必要です。