Как восстановить сломанный workflow ComfyUI с помощью Claude

Не просите Claude сразу переписать весь workflow. Сначала сохраните исходный JSON в обычном Save-формате и точные тексты ошибок, затем убедитесь, что актуальный стандартный workflow работает при отключённых custom nodes. После этого Claude может классифицировать только те факты, которые вы ему дали. Меняйте по одной зависимости, соберите минимальный рабочий граф, запустите одно изображение и лично проверьте, что результат появился в Save Image, сохранился и снова открывается.

Так расплывчатое «ComfyUI сильно изменился» превращается в проверку конкретных слоёв: ядро ComfyUI, frontend extensions, custom nodes, файлы моделей или сам старый граф. Официальный раздел ComfyUI по диагностике также советует протестировать стандартный workflow, отключить custom nodes и читать точную ошибку из терминала, прежде чем применять исправление.

Короткая схема восстановления

1. Оставьте исходный workflow в обычном Save-формате и никогда его не перезаписывайте.
2. Сохраните полный отчёт об ошибке, стартовый лог, тип установки, версии и недавние изменения.
3. Отключите все custom nodes и запустите текущий стандартный workflow генерации изображения.
4. Передайте Claude ограниченный набор доказательств; сначала анализ, потом правки и установки.
5. Отнесите сбой к core, frontend, custom node, model или категории unknown.
6. Обновите либо замените один несовместимый узел или соберите минимальный актуальный граф.
7. Запустите одно небольшое изображение и проверьте реальный сохранённый файл.

1. Зафиксируйте workflow и доказательства до любых изменений

Сохраните старый workflow как обычный JSON и создайте отдельную рабочую копию. Удобно собрать всё дело в одном каталоге:

comfyui-repair-case/
  workflow-original.json
  workflow-working.json
  error-report.txt
  startup-log.txt
  environment.md

Считайте workflow-original.json файлом только для чтения. В error-report.txt поместите весь текст из Show report, а не пересказ вроде «сломался узел». В startup-log.txt сохраните ошибки импорта, конфликты зависимостей и traceback из терминала запуска. В environment.md укажите Desktop, Portable или manual install, версию ComfyUI, ОС, GPU и то, что недавно обновлялось: core, frontend, custom nodes либо модели.

Не путайте Save format и API format. Официальная страница Workflow API Format поясняет, что обычный сохранённый workflow содержит позиции, цвета, группы и другие данные визуального редактирования, а API-формат предназначен для программной отправки и не включает часть UI-метаданных. Для ремонта храните исходник в обычном формате. Отдельную API-копию экспортируйте только тогда, когда в задаче действительно есть API.

2. Сначала докажите, что чистая база ComfyUI работает

Старый граф не должен быть первым тестом. Временно отключите сторонние узлы. В Desktop это делается через настройки; manual install обычно можно запустить так:

python main.py --disable-all-custom-nodes

Загрузите актуальный стандартный шаблон Image Generation, выберите совместимый checkpoint, который уже виден в списке моделей, и выполните одну генерацию. Официальное руководство по проблемам custom nodes предлагает простое разделение: если при отключённых custom nodes проблема исчезла, причина связана с одним из них; если осталась, проверяйте core, frontend, модели или окружение.

Дальнейшая ветка зависит от результата:

Результат базового теста	Более вероятный слой	Следующее доказательство
Стандартный workflow не открывается или не запускается	Core, frontend, модель или железо	Сначала исправить базу, старый граф не трогать
Стандартный workflow работает, старый показывает missing nodes	Отсутствующие, переименованные или не загруженные custom nodes	Сопоставить типы узлов из JSON с их пакетами
Старый граф загружается, но падает на одном узле	Архитектура модели, связи, зависимости или память	Сохранить первый ошибочный узел и полный отчёт
После отключения frontend extensions интерфейс оживает	Несовместимое стороннее frontend-расширение	Включать расширения половинами и локализовать одно

Если не работает даже стандартный граф, переписанный JSON старого workflow ничего не докажет.

3. Дайте Claude ограниченный пакет доказательств

По официальному описанию Claude Code умеет читать кодовую базу, редактировать файлы и запускать команды. Поэтому первый проход должен быть только аналитическим. Запустите Claude в каталоге дела или приложите те же файлы в чате и задайте жёсткие границы:

Ты диагностируешь workflow ComfyUI, который перестал работать после обновления.

Читай только:
- workflow-original.json
- workflow-working.json
- error-report.txt
- startup-log.txt
- environment.md

Пока ничего не устанавливай, не обновляй, не удаляй,
не переименовывай и не редактируй.
Сначала:
1. Составь список типов узлов и используемых файлов моделей.
2. Отнеси каждую проблему к ComfyUI core, frontend extension,
   custom node, model file или unknown.
3. Для каждого вывода процитируй точное поле JSON или строку ошибки.
4. Предложи минимальное обратимое изменение.
5. Дождись подтверждения перед правкой workflow-working.json.

Не объявляй ремонт успешным, пока я сам не запущу одно изображение
и не подтвержу сохранённый файл.

Полезный ответ — это таблица: старый тип узла, пакет-владелец, контракт входов и выходов, возможная замена, перенос параметров, доказательство и риск. Если пакет или замена не установлены точно, Claude должен написать unknown, а не угадывать по похожему имени.

4. Классифицируйте сбой, а не обновляйте всё подряд

Missing node: сначала найдите владельца

В обычном Save JSON проверьте type, заголовок и связи пропавшего узла. Похожие имена не гарантируют совместимость сокетов и widget values, поэтому простая замена строки в JSON не является миграцией. Определите, относится ли узел к core или конкретному репозиторию custom node, затем сравните старые и новые входы, выходы и параметры.

Если расширение поддерживается, обновите только его и повторите тест. Если оно заброшено, найдите поддерживаемую альтернативу или пересоберите эту небольшую функцию на core-узлах. Официальное руководство предлагает те же варианты: обновить, заменить, сообщить автору или удалить/отключить проблемный узел.

Конфликт frontend extension: отключите и выполните bisect

Некоторые custom nodes добавляют собственные frontend extensions. Пустой экран, неработающие связи, исчезнувшие preview или потеря связи между frontend и backend после обновления могут возникнуть на этом уровне. Сначала отключите сторонние frontend extensions. Если симптом исчез, включайте половину списка за раз и повторяйте проверку. Такой binary search сохраняет причинность и безопаснее полной переустановки.

Missing model: проверьте каталоги и пути поиска

Старый граф может ссылаться на удалённый, переименованный или перемещённый checkpoint, VAE, LoRA либо ControlNet. ComfyUI обнаруживает модели в тематических подпапках ComfyUI/models/ и по путям из extra_model_paths.yaml. Если список пуст или показывает null, сначала проверьте реальное расположение, затем обновите список или перезапустите ComfyUI. Не переименовывайте несовместимую модель только ради совпадения со старым именем.

Несовместимая архитектура: проверяйте семейство, а не имя файла

Официальный гайд по проблемам моделей рекомендует держать модели workflow в одном архитектурном семействе. Смешивание checkpoint, VAE, text encoder или ControlNet из разных семейств может проявиться как ошибки форм tensor при sampling или VAE decode. Claude способен связать stack trace с графом, но лучшей базой совместимости остаётся официальный шаблон нужного семейства.

5. Меняйте один узел и только в рабочей копии

Перед правкой потребуйте от Claude план изменения:

Элемент	Обязательный вопрос
Старый узел	Какой точный type записан в JSON?
Владелец	Это core, custom node или frontend extension?
Замена	Совпадают ли типы входов и выходов?
Перенос параметров	Какие widget values сохраняются, а какие нужно настроить заново?
Откат	Как вернуть предыдущий workflow-working.json?

Разрешайте правки только в workflow-working.json и по одной проблеме за раз. После каждого изменения перезагрузите файл и проверьте наличие узла, целостность связей и отсутствие сдвига параметров. Массовое «update all custom nodes» может создать второй конфликт и уничтожает доказательство того, какая правка действительно помогла.

Страницы сообщества годятся для сопоставления симптомов, но не для универсального диагноза. Например, frontend issue #6328 и discussion #14344 — отдельные пользовательские отчёты. Используйте их только при совпадении версии, ошибки и контекста узлов.

6. Соберите минимальный актуальный граф изображения

Если старый workflow содержит множество устаревших веток LoRA, ControlNet, upscale, preview и служебных узлов, чинить их одновременно рискованнее, чем восстановить основу. Соберите её по официальному минимальному примеру в Save format от ComfyUI. Это разветвлённый граф, а не последовательная цепочка: несколько выходов сходятся в KSampler, а VAEDecode отдельно получает VAE от checkpoint.

Выходной порт	Входной порт
CheckpointLoaderSimple.MODEL	KSampler.model
CheckpointLoaderSimple.CLIP	CLIPTextEncode.clip для positive prompt
CheckpointLoaderSimple.CLIP	CLIPTextEncode.clip для negative prompt
CLIPTextEncode.CONDITIONING от positive prompt	KSampler.positive
CLIPTextEncode.CONDITIONING от negative prompt	KSampler.negative
EmptyLatentImage.LATENT	KSampler.latent_image
KSampler.LATENT	VAEDecode.samples
CheckpointLoaderSimple.VAE	VAEDecode.vae
VAEDecode.IMAGE	SaveImage.images

EmptyLatentImage не принимает conditioning. Узлу KSampler нужны четыре независимых входа — model, positive, negative и latent_image; узлу VAEDecode нужны и результат samples, и vae из checkpoint. После соединения этих портов минимальный граф можно действительно поставить в очередь и получить сохранённое изображение.

Используйте эту схему только тогда, когда архитектура выбранного checkpoint соответствует официальному примеру. Для новой модели могут потребоваться другой loader, text encoder, latent node или путь VAE; тогда следуйте официальному workflow этой модели, а не подгоняйте её под таблицу. Для базового теста выберите совместимый checkpoint, уже видимый в Load Checkpoint, поставьте batch size 1 и умеренное разрешение, а дополнительные ветки пока не подключайте. После успешного прогона основы добавляйте по одному LoRA, ControlNet, upscaler или custom post-processing и запускайте тест после каждого шага.

Задача не в том, чтобы новый граф визуально повторял старый. Нужно получить доказанно рабочую современную основу, а затем перенести только необходимые функции. Claude может сравнить два JSON и подготовить карту миграции, но критерием остаётся выполнение.

7. Запустите одно изображение и проверьте сохранённый результат

Workflow, который только открывается, ещё не отремонтирован. Замкните цикл по официальному руководству первой генерации:

1. После установки или перемещения моделей нажмите R, чтобы обновить списки, либо перезапустите ComfyUI.
2. Убедитесь, что в Load Checkpoint выбрана видимая совместимая модель.
3. Нажмите Run или Ctrl + Enter.
4. Дождитесь завершения очереди без missing node, validation error и красного ошибочного узла.
5. Проверьте, что изображение появилось в Save Image.
6. Сохраните его локально через контекстное меню, запишите имя файла и откройте файл в просмотрщике.
7. При желании перетащите созданный ComfyUI PNG обратно в интерфейс и проверьте чтение встроенных данных workflow.
8. Сохраните исправленный обычный граф как workflow-repaired.json, оставив workflow-original.json без изменений.

В акте приёмки запишите имя исправленного workflow, имя изображения, модель, включённые custom nodes, замены узлов и известные ограничения. Только после этого статус «исправлено» подтверждён фактами.

Что делать, если одна ветка всё ещё падает

• Стандартный workflow падает при отключённых custom nodes: прекратите редактировать старый граф и исправьте установку, модель, драйвер или frontend.
• Стандартный работает, но старый всё ещё содержит missing nodes: продолжайте сопоставлять владельцев и замены; не угадывайте переименованием type.
• Граф загружается, но генерация падает: начинайте с первого ошибочного узла в Show report; проверяйте семейство модели и связи до гипотезы о памяти.
• Ошибка возвращается после включения группы расширений: продолжайте bisect, пока не останется один custom node или frontend extension.
• Исходный узел больше не поддерживается: замените или пересоберите его функцию и честно зафиксируйте различия поведения.
• В совете Claude нет цитаты из ошибки или JSON: считайте совет гипотезой и пока не выполняйте.

Вывод

В этой задаче Claude надёжнее всего работает как организатор доказательств и планировщик изменений, а не как кнопка непроверенного авторемонта. Рабочий цикл выглядит так: резервная копия → чистая база → классификация → минимальная правка → одно изображение → проверка сохранённого файла. Сохраняйте исходный граф, меняйте по одной переменной и доверяйте фактическому результату ComfyUI, а не уверенно написанному объяснению.