Когда после установки ноды нужен полный Stop/Start, а не Refresh

Короткий ответ. После установки или обновления кастомной ноды ComfyUI нужен полный Stop/Start процесса, когда изменился Python-код, зависимости или регистрация узлов. Кнопка Refresh обновляет веб-интерфейс и списки, но не перезапускает Python, который уже импортировал старый набор пакетов. Если вы только положили модель в правильную папку, иногда достаточно обновить список, однако после изменения custom_nodes надёжнее перезапустить сервер. Это следует из порядка установки в официальной инструкции ComfyUI.

Что обновляет Refresh, а что загружается при старте

Браузер отображает граф и отправляет задачи, а сервер ComfyUI исполняет ноды в Python-процессе. Обновление вкладки или кнопка обновления интерфейса не заставляют этот процесс заново читать файлы расширения с диска. Поэтому ситуация «репозиторий уже в custom_nodes, а нода всё ещё отсутствует» после одного Refresh ожидаема. Сначала остановите активный процесс, затем запустите тот же экземпляр ComfyUI и проверьте лог загрузки. Если в облачном шаблоне есть отдельная кнопка Restart ComfyUI, убедитесь, что она перезапускает именно приложение, а не только веб-прокси.

Разделяйте три разных действия: обновить браузер, перезапустить ComfyUI и пересоздать весь pod. Для новой Python-ноды обычно нужен второй пункт. Пересоздание pod может стереть данные на контейнерном диске, поэтому не используйте его как первую диагностическую попытку. Сохранность файлов зависит от типа хранилища; у Runpod это отдельно описано в документации о дисках.

Когда достаточно обновить список файлов

Если вы только скопировали checkpoint, LoRA или VAE в папку моделей, открытый интерфейс может показывать старый список. Обновите список моделей в соответствующей ноде, проверьте путь, а если файл не появился — перезапустите ComfyUI. При использовании символьных ссылок, дополнительных путей или сетевого тома сначала убедитесь, что файл виден процессу сервера. Вкладка вашего компьютера может показывать одну папку, а ComfyUI внутри контейнера — другую.

Для смены prompt, seed, параметров sampler или связей в обычном workflow перезапуск не нужен. Достаточно повторного запуска задачи. Если вы поменяли конфигурацию кастомной ноды на диске, смотрите README расширения: часть настроек считывается при старте, часть — при каждом выполнении. Не делайте Stop/Start после каждого изменения текста, иначе теряете время и возможную очередь.

Порядок после установки ноды

1. Сохраните JSON workflow и убедитесь, что нет незавершённой генерации, результат которой ещё нужен.
2. Проверьте, что файлы расширения находятся в custom_nodes активной установки.
3. Если README требует зависимости, установите их через Python этой же установки.
4. Остановите сервер ComfyUI штатным способом и дождитесь завершения процесса.
5. Запустите его вновь. В стартовом логе найдите имя пакета и проверьте отсутствие IMPORT FAILED.
6. Обновите браузер, найдите ноду и откройте workflow заново.

Если вы используете облачный pod, не путайте остановку приложения с остановкой аренды GPU. Остановленный сервер ComfyUI при работающем pod может продолжать расходовать оплачиваемое время. Когда работа завершена, отдельно примите решение по pod и скачайте результаты. Конкретные правила сохранения зависят от провайдера и типа диска. В локальной установке эта часть не относится к делу.

Что делать, если нода не появилась

Первое доказательство — стартовый лог. Если там ошибка импорта, исправляйте её причину: пакет Python, конфликт версии, отсутствующий системный компонент. Если ошибки нет, сравните точное имя ноды с README. Название репозитория может быть другим. Если лог вообще не упоминает расширение, перепроверьте расположение папки и активный экземпляр ComfyUI. Не устанавливайте несколько случайных форков с похожими названиями: так сложнее выяснить, какой код загрузился.

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

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

Нужно ли перезагружать весь компьютер?

Обычно нет. Достаточно завершить и снова запустить процесс ComfyUI. Перезагрузка компьютера скрывает причину и расходует больше времени.

Почему после Stop/Start красная нода осталась?

Пакет мог не импортироваться, отсутствовать в этой установке или изменить имя узла. Смотрите лог и версию workflow, а не повторяйте Refresh.