Context Windows Visualizer (KJ)(ContextWindowsVisualizerKJ)

Description

Un nœud de visualisation interactif pour les fenêtres de contexte ComfyUI. Il affiche en temps réel le placement des fenêtres, leur chevauchement, les pondérations de fusion et le mélange par image au fur et à mesure que les paramètres sont ajustés. Lorsqu'un modèle est connecté, le nœud applique optionnellement les paramètres de fenêtre de contexte configurés au modèle pendant l'échantillonnage, fonctionnant de manière similaire au nœud principal Context Windows (Manual).

Entrées

Toutes les entrées contrôlent la visualisation et, lorsqu'un modèle est connecté, le comportement appliqué des fenêtres de contexte.

• model (MODEL, facultatif)
  Un modèle optionnel auquel appliquer les fenêtres de contexte pendant l'échantillonnage. Lorsqu'il est déconnecté, seule la visualisation est affichée.

• frame_units (COMBO, par défaut : pixel)
  Unités pour les décomptes d'images.

  • pixel: Convertit les indices d'image pixel en indices de latent via ((n - 1) // temporal_downscale) + 1.
  • latent: Les décomptes d'image sont traités directement comme des indices de latent.

• dim (INT, par défaut : 2, plage : 0–5)
  Indice de dimension temporelle latente. 2 est typique pour les architectures de type WAN ; 0 pour le style AnimateDiff. Pertinent uniquement lorsqu'un modèle est connecté (chemin modèle).

• temporal_downscale (INT, par défaut : 4, plage : 1–16)
  Facteur de compression temporelle VAE utilisé lorsque frame_units = pixel. Valeurs courantes : WAN/Hunyuan/CogVideoX = 4, Mochi = 6, LTXV = 8.

• num_frames (INT, par défaut : 161, plage : 1–100000)
  Nombre total d'images à visualiser lorsqu'aucun modèle n'est connecté (chemin visualisation uniquement). Lorsqu'un modèle est connecté, ce paramètre est ignoré et la longueur latente réelle du modèle est utilisée.

• context_length (INT, par défaut : 81, plage : 1–100000)
  Longueur de la fenêtre en unités d'image.

• context_overlap (INT, par défaut : 30, plage : 0–100000)
  Nombre d'images de chevauchement entre les fenêtres adjacentes.

• context_schedule (COMBO, pas de valeur par défaut)
  Détermine la stratégie de placement des fenêtres.

  • standard_static_balanced: Fenêtres statiques réparties uniformément sur la plage d'images, garantissant des coutures uniformes pour tout nombre d'images.
  • batched_shifted: Fenêtres sans chevauchement dont les positions des coutures se décalent à chaque étape d'échantillonnage (~1.0× de calcul ; conçues pour être associées à FreeNoise).
    Les planifications uniformes (ajouts futurs) se décalent également par étape.

• context_stride (INT, par défaut : 1, plage : 1–32)
  Puissance de pas maximale pour les planifications uniformes. Contrôle les fenêtres dilatées (par exemple 1, 2, 4…). Efficace uniquement lorsqu'une planification uniforme est sélectionnée.

• closed_loop (BOOLÉEN, par défaut : False)
  Lorsqu'activé, les fenêtres de planification en boucle sont enroulées de la fin vers l'image 0.

• fuse_method (COMBO, par défaut : pyramid)
  Méthode de mélange pour les régions de chevauchement. Les options représentent différentes stratégies de pondération (par exemple pyramidale, uniforme, etc.).

• causal_window_fix (BOOLÉEN, par défaut : False)
  Ajoute une image d'ancrage aux fenêtres non nulles (sauf la première), qui est retirée après l'appel au modèle. Utile pour l'attention temporelle causale.

• freenoise (BOOLÉEN, par défaut : True)
  Active le brassage de bruit FreeNoise pour un mélange plus lisse entre les fenêtres. Pertinent uniquement lorsqu'un modèle est connecté (chemin modèle).

• cond_retain_index_list (CHAÎNE, par défaut : "")
  Liste séparée par des virgules des indices d'image relatifs à la fenêtre dont le conditionnement est réutilisé entre les fenêtres. Par exemple, "0" réutilise le conditionnement de la première image par fenêtre. N'a aucun effet sur la visualisation ; s'applique uniquement lorsqu'un modèle est connecté.

Sorties

• MODEL
  Si un modèle a été fourni en entrée, la sortie est le même modèle avec les fenêtres de contexte configurées appliquées. Si aucun modèle n'a été fourni, la sortie est None (le nœud agit uniquement comme visualisation).

Notes d'utilisation

• La visualisation se met à jour en direct à chaque modification de paramètre, offrant un retour immédiat sur le placement, le chevauchement et le mélange des fenêtres.
• Lorsque le nœud est utilisé uniquement pour la visualisation (aucun modèle connecté), l'entrée num_frames définit le nombre total d'images. Les paramètres marqués « chemin modèle uniquement » (dim, freenoise, cond_retain_index_list) sont ignorés.
• Les paramètres qui n'affectent que le chemin modèle sont clairement indiqués dans leurs info-bulles. La conversion frame_units n'est importante que lors du calcul des indices latents à partir des comptes de pixels ; si vous travaillez directement dans l'espace latent, réglez frame_units sur latent.
• Pour les planifications comme batched_shifted, l'association avec freenoise est RECOMMANDÉE pour des transitions lisses.
• L'option causal_window_fix est destinée aux modèles avec attention causale (par exemple, certains modèles de diffusion vidéo) où chaque fenêtre a besoin d'une image d'ancrage précédente.