Визуализатор контекстных окон (KJ)(ContextWindowsVisualizerKJ)

Описание

Интерактивная нода визуализации контекстных окон для ComfyUI. Она отображает расположение окон, перекрытие, веса слияния и покадровое смешение в реальном времени по мере изменения параметров. Когда к ноде подключена модель, она опционально применяет настроенные параметры контекстных окон к модели во время выборки, работая аналогично базовой ноде Context Windows (Manual).

Входы

Все входы управляют визуализацией и, при подключении модели, поведением применяемых контекстных окон.

• model (MODEL, опционально)
  Опциональная модель для применения контекстных окон во время выборки. Когда модель отключена, отображается только визуализация.

• frame_units (COMBO, по умолчанию: pixel)
  Единицы измерения количества кадров.

  • pixel: Преобразует индексы кадров в пикселях в латентные индексы по формуле ((n - 1) // temporal_downscale) + 1.
  • latent: Количество кадров обрабатывается непосредственно как индексы латентных кадров.

• dim (INT, по умолчанию: 2, диапазон: 0–5)
  Индекс латентного временного измерения. Значение 2 типично для архитектур типа WAN; 0 — для AnimateDiff-стиля. Актуально только при подключении модели (путь модели).

• temporal_downscale (INT, по умолчанию: 4, диапазон: 1–16)
  Коэффициент временного сжатия VAE, используемый когда frame_units = pixel. Типичные значения: 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)
  Метод смешивания для перекрывающихся областей. Опции представляют различные стратегии взвешивания (например, пирамидальная, равномерная и т.д.).

• causal_window_fix (BOOLEAN, по умолчанию: False)
  Добавляет опорный кадр в начало ненулевых окон (кроме первого), который удаляется после вызова модели. Полезно для каузального временного внимания.

• freenoise (BOOLEAN, по умолчанию: True)
  Включает перетасовку шума FreeNoise для более сглаженного смешивания между окнами. Актуально только при подключенной модели (путь модели).

• cond_retain_index_list (STRING, по умолчанию: "")
  Список разделенных запятыми индексов кадров относительно окна, чьи условия повторно используются между окнами. Например, "0" повторно использует условие первого кадра для каждого окна. Не влияет на визуализацию; применяется только при подключенной модели.

Выходы

• MODEL
  Если на вход была подана модель, выходом является та же модель с примененными настроенными контекстными окнами. Если модель не была подана, выход — None (нода действует исключительно как визуализация).

Примечания по использованию

• Визуализация обновляется в реальном времени при изменении любого параметра, обеспечивая мгновенную обратную связь по расположению окон, перекрытию и смешиванию.
• При использовании ноды только для визуализации (без подключенной модели) вход num_frames задает общее количество кадров. Параметры, отмеченные как «только путь модели» (dim, freenoise, cond_retain_index_list), игнорируются.
• Параметры, влияющие только на путь модели, четко указаны в их подсказках. Преобразование frame_units имеет значение только при получении латентных индексов из количества пикселей; если вы работаете напрямую в латентном пространстве, установите frame_units в latent.
• Для расписаний, таких как batched_shifted, рекомендуется совместное использование с freenoise для плавных переходов.
• Опция causal_window_fix предназначена для моделей с каузальным вниманием (например, некоторые модели диффузии видео), где каждому окну требуется предшествующий опорный кадр.