ComfyUI-MiniMaxH3-CLIPCached: дисковый кэш условий H3
Новый узел ComfyUI кэширует на диск conditioning Qwen3-VL для MiniMax H3: повторные запуски с тем же промптом пропускают энкодер 14,6 ГБ, ускорение с 29,9 с до 1,1 с.
Кэширующая нода заменяет штатную ноду условий H3, а этап диффузии не затрагивается.
Что кэшируется, а что нет
Это не ускоритель сэмплирования. Это не TeaCache и не FirstBlockCache, и он не влияет на шаги сэмплирования. Нода заменяет штатную ноду условий H3 в ComfyUI: при попадании в кэш она загружает ранее вычисленные текстовые и визуальные условия с диска вместо запуска кодировщика Qwen3-VL, а этап диффузии выполняется без изменений.
| Изменение | Новая запись кэша? |
|---|---|
| Текст промпта | Да |
| Чекпоинт кодировщика | Да |
| Пиксели ключевых кадров и референсов, видимые кодировщику | Да, если меняется видимое кодировщику содержимое |
| Сид, сэмплер, планировщик, шаги | Нет |
| LoRA дальше по графу или сила (strength) | Нет |
Такое разделение важно для итеративных рабочих процессов: если перезапускать один и тот же промпт, меняя только настройки сэмплера или веса LoRA, каждый запуск после первого будет попаданием в кэш.
Измеренные показатели
Контролируемый бенчмарк автора (по 5 прогонов на режим, медианные значения, RTX 5080 16 ГБ под WSL2; для нативного режима и промаха кэша кодировщик намеренно считывался «на холодную»):
| Режим | Формирование условий | Пиковая VRAM | Пиковая RAM процесса |
|---|---|---|---|
| Нативный | 29.85 с | 15.24 ГиБ | 29.25 ГиБ |
| Промах кэша | 32.23 с | 15.24 ГиБ | 28.25 ГиБ |
| Попадание в кэш | 1.12 с | 2.67 ГиБ | 3.38 ГиБ |
Промах кэша намеренно не быстрый путь: он всё равно запускает кодировщик и записывает результат на диск, добавляя около 2 секунд. Зато после кодирования кодировщик выгружается, а не остаётся в памяти, поэтому сэмплирование проходит с освобождённой памятью. На скриншоте автора в нативном режиме во время сэмплирования в памяти остаются и модель H3 на 11.7 ГБ, и кодировщик на 14.6 ГБ, тогда как при попадании в кэш загруженным остаётся только DiT, а потребление RAM процесса падает с 40 ГБ до 25.5 ГБ.
Узлы и управление кэшем
В пакет входят кэширующие аналоги штатных узлов H3 Image-to-Video (FL2VA) и Reference-to-Video (Ref2VA), варианты с двумя разрешениями, которые подготавливают условия и для базового прохода, и для целевого апскейла, а также общий селектор имени кодировщика.
Каждый уникальный запрос условий становится записью кэша, которая хранится до удаления, и при частой итеративной работе записи накапливаются. Встроенная панель менеджера кэша позволяет просматривать записи, помечать их тегами и удалять лишнее. Требования: ComfyUI 0.30.0 или новее с нативными узлами H3.
Доступность
Нода доступна в ComfyUI Manager и в реестре как minimaxh3-clipcached; также можно клонировать репозиторий в custom_nodes. В текущей версии нет автоматической очистки кэша, Ref2VA использует фиксированные слоты референсов, а кодировщики GGUF не тестировались.
Комментарии
Войдите через GitHub, чтобы участвовать в обсуждении.