Зачем нужны alter-list.json и model-list.json в ComfyUI-Manager

Короткий ответ: если при запуске ComfyUI вы видите в логе строки про alter-list.json и model-list.json, Manager не «завис», а обновляет служебные списки. Первый файл помогает подсказывать подходящие расширения и альтернативы по задачам и тегам, второй хранит каталог моделей с путями, типами файлов и ссылками на загрузку. На этой базе работают окна установки моделей и нод, поиск недостающих компонентов и часть автоматических подсказок.

Дальше разберём схему старта, сравним оба файла в таблице, посмотрим, как устроен кэш, и закончим чек-листом на случай, когда строки default cache updated есть, а нужная модель или нода всё равно не появились в интерфейсе.

Если вы искали alter-list json comfyui, model-list json comfyui или comfyui manager lists, речь как раз об этих двух служебных базах Manager.

Что это за файлы и чем они отличаются

Оба JSON-файла относятся не к вашему workflow, а к инфраструктуре ComfyUI-Manager. Они нужны, чтобы менеджер видел мир не только через локальные папки, но и через собственную базу данных: какие модели обычно ставят через интерфейс, куда их сохранять, какие расширения подходят под конкретную задачу и что можно предложить пользователю в качестве замены или дополнения.

Файл	Что хранит	Где используется	Практическая польза
model-list.json	Каталог моделей: имя, тип, save_path, filename, источник, размер, описание	Install Models, подсказки по загрузке, раскладка файлов по папкам	Manager понимает, что скачать и куда положить
alter-list.json	Список расширений и альтернатив по тегам и сценариям	Рекомендации по нодам, поиск похожих решений, сопоставление задач и пакетов	Manager предлагает релевантные ноды, а не пустой список

Главная мысль: model-list.json отвечает за модели и их маршрутизацию по каталогам, а alter-list.json — за слой рекомендаций по расширениям. Поэтому они часто обновляются вместе: один список обслуживает загрузку ресурсов, второй — навигацию по экосистеме нод.

Как ComfyUI-Manager обновляет списки при старте

Во время запуска Manager поднимает отдельную стартовую задачу и запрашивает несколько служебных баз: custom-node-list.json, extension-node-map.json, model-list.json, alter-list.json и github-stats.json. После этого каждый полученный JSON сохраняется в локальный кэш. Отсюда и знакомые строки в логе вида default cache updated.

Ключевой момент в том, что обновление идёт не как часть вашего workflow, а как отдельная подготовка данных для самого менеджера. Поэтому наличие этих строк обычно означает не сбой, а успешную синхронизацию внутренней базы. На практике это хорошо видно на свежих установках: ComfyUI уже запускается, а Manager параллельно добирает списки, чтобы затем открыть актуальные окна установки нод и моделей.

После загрузки файлов Manager не ограничивается только записью кэша. Он ещё и обновляет удалённые данные для каталога кастомных нод, чтобы интерфейс не опирался на устаревший список. Именно поэтому при первом старте после обновления ComfyUI-Manager лог может быть чуть длиннее обычного.

1. Определяется активный канал данных.
2. Для каждого служебного JSON собирается URL источника.
3. Файл скачивается и записывается в локальный кэш под служебным именем.
4. Manager использует кэш как быструю базу для интерфейса.
5. При необходимости добираются свежие данные для каталога нод.

Промежуточный вывод: когда Manager обновляет эти списки при старте, он готовит собственную базу поиска и установки. Это не пересборка вашего workflow и не проверка конкретной модели из текущего проекта.

Что хранится в model-list.json

model-list.json — это справочник моделей, которые Manager умеет устанавливать через своё окно. Внутри у каждой записи обычно есть понятное имя, тип модели, базовая категория, путь сохранения, имя файла, ссылка на скачивание, ориентир по размеру и короткое описание. Благодаря этому Manager знает не просто «что скачать», а ещё и куда именно положить файл, чтобы ComfyUI увидел его в нужном загрузчике.

Например, для разных типов ресурсов используются разные целевые каталоги: апскейлеры, эмбеддинги, VAE, чекпойнты, текстовые энкодеры, diffusion-модели и другие классы файлов. Если бы такого списка не было, окно Install Models свелось бы к набору сырых ссылок, а пользователю пришлось бы вручную разбирать папки и типы ресурсов.

Для повседневной работы это даёт три преимущества:

• модель скачивается в ожидаемую папку, а не «куда попало»;
• снижается шанс перепутать тип файла и каталог;
• Manager может показать описание и назначение модели ещё до установки.

Именно поэтому при вопросе «почему Manager видит модель в списке, но нода её не подхватывает» полезно смотреть не только на сам файл, но и на его путь. Если тема хранения моделей для вас сейчас актуальна, пригодится материал про папки для LLM-моделей в ComfyUI.

Что хранится в alter-list.json

alter-list.json устроен иначе. Это не каталог моделей, а список расширений с тегами и краткими описаниями. По сути, Manager хранит здесь «карточки соответствия» между задачей и подходящими пакетами нод. Внутри записи обычно есть идентификатор репозитория, набор тегов и пояснение, что именно даёт расширение.

Зачем это нужно на практике? Допустим, пользователь ищет решение для апскейла, detailer-пайплайна, prompt-утилит, controlnet-предобработки или похожих сценариев. Manager может показать не одну случайную ноду, а несколько подходящих вариантов, потому что ориентируется на теги и описания из alter-list.json. Это особенно полезно, когда точное имя пакета забыто, а задача понятна.

У этого списка есть ещё одна ценность: он помогает ориентироваться в экосистеме ComfyUI, где близкие по функции расширения часто называются по-разному. Пользователь мыслит задачей, а не названием репозитория. Manager закрывает этот разрыв и превращает поиск в более понятный сценарий.

Проще говоря: alter-list.json нужен не для скачивания весов, а для смысловой навигации по кастомным нодам. Это слой рекомендаций, который делает Manager полезнее обычного списка GitHub-репозиториев.

Как работает кэш и почему это ускоряет запуск

В обычном режиме ComfyUI-Manager не тянет все списки с нуля при каждом открытии любого окна. У него есть несколько режимов работы с базой: локальная база, удалённая база и режим канала с кэшем примерно на один день. По умолчанию после нового запуска интерфейс опирается именно на кэшированный режим, чтобы списки открывались быстрее.

Это хороший компромисс между актуальностью и скоростью. Вы получаете не статичный снимок, который обновляется только вместе с самим Manager, и не постоянное ожидание сетевых запросов перед каждым действием. Сначала Manager использует локально сохранённые данные, а при старте или явном обращении к удалённому каналу освежает их.

С технической точки зрения кэш нужен ещё и для нестабильных сценариев: временные сетевые сбои, закрытая среда, ограниченный доступ к удалённым источникам. В таких случаях Manager может опереться на уже сохранённые JSON-файлы, а не превращаться в пустой каталог. Поэтому строки про обновление кэша — это часть механизма устойчивости, а не декоративный лог.

В реальной работе это удобно и после установки missing nodes. Сначала Manager обновляет свои списки, затем вы ставите недостающий пакет, а потом делаете полный перезапуск ComfyUI. Именно полный restart, а не простое обновление вкладки, чаще всего завершает цикл корректно: нода регистрируется, зависимости подхватываются, а интерфейс перечитывает списки и состояние папок заново.

Если вы недавно ставили новый пакет, держите рядом ещё два полезных материала: про зависимости после установки ноды и про ситуацию, когда workflow отработал, а output остался пустым.

Что делать, если списки обновились, а проблема осталась

Сам факт обновления alter-list.json и model-list.json ещё не гарантирует, что конкретная нода или модель тут же заработают. Эти файлы дают Manager актуальную карту ресурсов, но не исправляют автоматически конфликт зависимостей, битую установку пакета или неверный путь к файлу.

Практический чек-лист:

• проверьте, что после установки ноды был именно полный перезапуск ComfyUI;
• посмотрите, нет ли красных или неизвестных нод в workflow после перезапуска;
• убедитесь, что модель лежит в правильной папке для своего типа;
• если нода всё ещё помечена как unknown, удалите её из workflow и добавьте заново;
• если пакет ставился вручную, проверьте зависимости и журнал запуска;
• когда Manager работает в закрытой среде, учитывайте, что он может опираться на старый кэш.

Отдельно стоит помнить, что default cache updated и успешная генерация — это разные уровни системы. Первый уровень относится к данным Manager, второй — к вашим нодам, моделям, зависимостям и совместимости самого workflow. Поэтому логично разделять диагностику: сначала Manager, потом пакет нод, затем модель и только после этого сам граф.

Если проблема касается не итоговых файлов, а промежуточных папок, полезно также проверить материал про временные файлы в папке temp. Он хорошо дополняет картину, когда кажется, что Manager всё сделал правильно, а нужного результата на виду нет.

Частые вопросы

Нужно ли удалять эти JSON-файлы вручную?

Обычно нет. Manager сам обновляет кэш при старте и умеет работать с локальной, кэшированной и удалённой базой. Ручная чистка нужна только в редких диагностических сценариях, когда вы точно понимаете, что кэш повреждён или сильно устарел.

Почему строки про обновление списков появляются даже тогда, когда я ничего не устанавливаю?

Потому что Manager готовит свою служебную базу на старте ComfyUI, а не только в момент установки. Ему нужны актуальные каталоги заранее, чтобы быстро открыть окна моделей и кастомных нод.

Эти файлы относятся к моему workflow?

Нет, напрямую — к Manager. Но косвенно они влияют на удобство работы с workflow, потому что через них Manager ищет недостающие пакеты, показывает каталог моделей и помогает подобрать нужное расширение.

Почему после обновления списков нужной ноды всё равно нет?

Чаще всего причина в том, что нужный пакет не установлен, установлен не полностью или не зарегистрировался после рестарта. Реже проблема упирается в старый кэш или несовместимую версию самого пакета.

Итог

Итог простой: model-list.json нужен ComfyUI-Manager как рабочий каталог моделей с путями и метаданными, а alter-list.json — как слой рекомендаций и альтернатив по кастомным нодам. При старте Manager обновляет эти списки, складывает их в кэш и на их основе строит интерфейс установки, подсказки и часть поиска по экосистеме ComfyUI.

Поэтому строки об обновлении этих файлов в логе чаще всего означают, что Manager делает именно то, что должен: готовит актуальную карту моделей и нод перед вашей работой. А если после этого что-то не запускается, причину уже стоит искать не в самих списках, а в путях, зависимостях, установке пакета и совместимости workflow.