Visualizador de Ventanas de Contexto (KJ)(ContextWindowsVisualizerKJ)

Descripción

Un nodo de visualización interactiva para las ventanas de contexto de ComfyUI. Muestra la ubicación de las ventanas, la superposición, los pesos de fusión y la mezcla por fotograma en tiempo real mientras se ajustan los parámetros. Cuando se conecta un modelo, el nodo opcionalmente aplica las configuraciones de ventana de contexto definidas al modelo durante el muestreo, funcionando de manera similar al nodo Ventanas de Contexto (Manual) central.

Entradas

Todas las entradas controlan la visualización y, cuando se conecta un modelo, el comportamiento de la ventana de contexto aplicado.

• model (MODEL, opcional)
  Un modelo opcional para aplicar las ventanas de contexto durante el muestreo. Cuando está desconectado, solo se muestra la visualización.

• frame_units (COMBO, predeterminado: pixel)
  Unidades para los recuentos de fotogramas.

  • pixel: Convierte índices de fotogramas de píxeles a índices latentes mediante ((n - 1) // temporal_downscale) + 1.
  • latent: Los recuentos de fotogramas se tratan directamente como índices de fotogramas latentes.

• dim (ENTERO, predeterminado: 2, rango: 0–5)
  Índice de dimensión temporal latente. 2 es típico para arquitecturas similares a WAN; 0 para estilo AnimateDiff. Solo relevante cuando se conecta un modelo (ruta del modelo).

• temporal_downscale (ENTERO, predeterminado: 4, rango: 1–16)
  Factor de compresión temporal del VAE utilizado cuando frame_units = pixel. Valores comunes: WAN/Hunyuan/CogVideoX = 4, Mochi = 6, LTXV = 8.

• num_frames (ENTERO, predeterminado: 161, rango: 1–100000)
  Número total de fotogramas a visualizar cuando no hay un modelo conectado (solo ruta de visualización). Cuando se conecta un modelo, esto se ignora y se utiliza la longitud latente real del modelo.

• context_length (ENTERO, predeterminado: 81, rango: 1–100000)
  Longitud de la ventana en unidades de fotograma.

• context_overlap (ENTERO, predeterminado: 30, rango: 0–100000)
  Número de fotogramas superpuestos entre ventanas adyacentes.

• context_schedule (COMBO, sin predeterminado)
  Determina la estrategia de colocación de ventanas.

  • standard_static_balanced: Ventanas estáticas distribuidas uniformemente en el rango de fotogramas, garantizando costuras uniformes para cualquier número de fotogramas.
  • batched_shifted: Ventanas sin superposición cuyas posiciones de costura se desplazan en cada paso de muestreo (~1.0× de cómputo; destinado a combinarse con FreeNoise).
    Los horarios uniformes (futuras adiciones) también se desplazan por paso.

• context_stride (ENTERO, predeterminado: 1, rango: 1–32)
  Potencia máxima de paso para horarios uniformes. Controla ventanas dilatadas (por ejemplo, 1, 2, 4…). Solo efectivo cuando se selecciona un horario uniforme.

• closed_loop (BOOLEANO, predeterminado: falso)
  Cuando está activado, envuelve las ventanas de horario en bucle desde el final hasta el fotograma 0.

• fuse_method (COMBO, predeterminado: pyramid)
  Método de mezcla para regiones superpuestas. Las opciones representan diferentes estrategias de ponderación (por ejemplo, pirámide, uniforme, etc.).

• causal_window_fix (BOOLEANO, predeterminado: falso)
  Antepone un fotograma de anclaje a las ventanas no cero (excepto la primera), que se elimina después de la llamada al modelo. Útil para atención temporal causal.

• freenoise (BOOLEANO, predeterminado: verdadero)
  Habilita la mezcla de ruido FreeNoise para una fusión más suave entre ventanas. Solo relevante cuando se conecta un modelo (ruta del modelo).

• cond_retain_index_list (CADENA, predeterminado: "")
  Lista separada por comas de índices de fotograma relativos a la ventana cuyo acondicionamiento se reutiliza entre ventanas. Por ejemplo, "0" reutiliza el acondicionamiento del primer fotograma por ventana. No tiene efecto en la visualización; solo se aplica cuando se conecta un modelo.

Salidas

• MODEL
  Si se suministró un modelo como entrada, la salida es el mismo modelo con las ventanas de contexto configuradas aplicadas. Si no se suministró ningún modelo, la salida es None (el nodo actúa puramente como visualización).

Notas de Uso

• La visualización se actualiza en vivo a medida que cambia cualquier parámetro, proporcionando retroalimentación inmediata sobre la ubicación de las ventanas, la superposición y la mezcla.
• Cuando se usa el nodo solo para visualización (sin modelo conectado), la entrada num_frames establece el recuento total de fotogramas. Los parámetros marcados como "solo ruta del modelo" (dim, freenoise, cond_retain_index_list) se ignoran.
• Los parámetros que solo son efectivos en la ruta del modelo están claramente indicados en sus descripciones emergentes. La conversión de frame_units solo importa al derivar índices latentes a partir de recuentos de píxeles; si trabajas directamente en espacio latente, establece frame_units en latent.
• Para horarios como batched_shifted, se recomienda combinarlos con freenoise para transiciones suaves.
• La opción causal_window_fix está destinada a modelos con atención causal (por ejemplo, algunos modelos de difusión de vídeo) donde cada ventana necesita un fotograma de anclaje precedente.