Ноды, входы, выходы, связи и типы

Как граф складывается из нод и связей и почему связь соединяет только одинаковые типы.

#Простыми словами

Нода это блок, который делает одно дело: загружает файл, кодирует промпт, убирает шум, сохраняет картинку. Её входы это точки на левом краю: что ей нужно от других нод. Её выходы это точки на правом краю: что она отдаёт. Её поля (в ComfyUI их зовут виджетами, widgets) это настройки на самой ноде: имя файла, число, текст.

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

У каждого входа и выхода есть тип, он пишется заглавными буквами: MODEL, CLIP, VAE, CONDITIONING, LATENT, IMAGE, MASK и многие другие. Связь соединяет только выход и вход одного типа. В ComfyUI у связей ещё и цвет по типу, так что линию MODEL легко отличить от линии CLIP.

<!-- diagram: одна крупная нода; входы слева «model», «positive», «negative», «latent_image»; поля посередине «seed», «steps», «cfg»; выход справа «LATENT»; связь входит слева и выходит справа -->

#Где встречается в графе

• Класс и заголовок. У ноды есть класс (её служебное имя, например KSampler) и заголовок на экране (например «KSampler» или «Load Checkpoint»). Заголовок люди переименовывают, класс остаётся.
• Необязательные входы. Некоторые входы можно оставить пустыми (например end_image у ноды начала видео). Обязательные входы должны быть подключены, иначе ComfyUI не запустит граф.
• Поле, ставшее входом. Любое поле с числом, текстом или выбором может получать связь вместо набранного значения. Так одно значение (seed, размер) управляет несколькими нодами. В нынешнем ComfyUI у каждого поля уже есть маленькая точка входа, к которой можно протянуть связь.
• Типы значений. INT, FLOAT, STRING, BOOLEAN и COMBO (выбор из списка) это типы значений полей.

Полный список частых типов и того, что они несут, на странице Типы связей.

#Частые ошибки

• Связь не цепляется: типы разные. LATENT не идёт во вход IMAGE, между ними нужна VAE Decode.
• Две связи в один вход: так нельзя, новая заменяет старую.
• Пустой вход: в ComfyUI «Required input is missing».
• Ноды пака встречают встроенные: у некоторых паков свои типы (например WANVIDEOMODEL у WanVideoWrapper), и они не подключаются ко встроенным входам, даже если имена похожи.

#Как помогает приложение

• Выделите ноду, вход или связь, и вкладка Объяснение скажет, что это, зачем это и что входит и выходит. Тексты встроены в приложение и написаны для новичков.
• Проверка перечисляет связи не того типа и пустые обязательные входы.

#См. также

• Типы связей
• Что такое ComfyUI
• Заметки, reroute и primitive
• Как читать чужой workflow
• Холст
• Вкладка «Объяснение»
• Проверка перед сохранением