Зачем нужна нода DownloadAndLoadFlorenceModel
Как работает DownloadAndLoadFlorenceModel: определите пакет ноды, проверьте сеть, каталог кэша и совместимость модели перед captioning.
Короткий ответ. Нода с названием вроде DownloadAndLoadFlorenceModel или DownloadAndLoadFlorence2Model совмещает выбор, скачивание и загрузку модели Florence для следующей ноды captioning. Точное имя и функции зависят от расширения: в чужом workflow это не обязательно стандартная нода ComfyUI. Она не пишет TXT сама по себе и не заменяет ноду, которая обрабатывает изображение. Прежде чем менять её, выясните пакет и версию по JSON или Manager. Для популярного пакета смотрите репозиторий ComfyUI-Florence2.
Где она стоит в схеме
Типовая цепочка captioning состоит из загрузки фото, загрузки Florence-модели, запуска модели на фото и сохранения текста. Loader предоставляет модель в следующий блок, который выполняет задачу описания изображения. Сохранение TXT — отдельный шаг, иногда реализованный сторонней пакетной нодой. Поэтому сообщение «loader работает» означает только, что модель получена; проверьте, дошёл ли текст до выходной ноды и какой путь выбран для сохранения.
Варианты Florence-2 могут отличаться по назначению и набору файлов. Некоторые workflow выбирают базовую модель Microsoft, другие — дообученный captioner. Если автор графа использовал определённый вариант, не заменяйте его на первый попавшийся только из-за одинакового слова Florence в названии. Сверьте README и карточку модели. Официальная карточка Microsoft Florence-2-base показывает один из исходных вариантов, но не гарантирует совместимость с каждой сторонней нодой.
Что происходит при первом запуске
Если нода скачивает веса автоматически, первый запуск может занять больше времени: модель должна загрузиться и попасть в кэш или указанную папку. Дождитесь завершения и проверьте свободное место. На облачном pod важно, где лежит кэш: временный контейнерный диск может исчезнуть после остановки, и следующее включение снова потратит время на загрузку. Для Runpod жизненный цикл хранилища описан в Storage Types.
Если веса уже скачаны вручную, нода может предложить выбрать локальную модель. Но формат папки и список необходимых файлов определяет её код. Не нужно переносить один model.safetensors в случайный каталог. Проверьте, какие файлы ожидает loader: конфигурация, tokenizer и веса должны относиться к одному репозиторию.
Как отличить ошибку loader от ошибки captioning
| Симптом | Что проверять |
|---|---|
| Нода красная | Установлен ли пакет и нет ли ошибки импорта |
| Не видит модель | Путь, имя и комплект файлов |
| Загрузка зависла | Сеть, кэш, место и журнал скачивания |
| Модель есть, текста нет | Связь с нодой выполнения и выходным сохранением |
| Текст есть, TXT не создан | Путь и настройки ноды сохранения |
Если после обновления пакета старое имя ноды стало красным, проверьте историю версий. Авторы могут переименовать класс или изменить входы. Найдите документированную замену и перенесите соединения в копии workflow. Не удаляйте старую схему до контрольного запуска.
Проверка на одном снимке
- Сохраните исходный JSON графа.
- Убедитесь, что пакет ноды загрузился без ошибки в стартовом логе.
- Выберите одну модель и подайте одно изображение.
- Посмотрите текст в промежуточной ноде просмотра, если она есть.
- Проверьте сохранённый TXT и сравните его с фото.
- Только после этого запускайте пакетный Dataset Captioner.
Такой тест разделяет проблемы модели, изображения и пакетного чтения папок. Если список директорий пуст, loader Florence обычно ни при чём: путь к фото на pod проверяется отдельно. Если при загрузке Florence появляется ModuleNotFoundError, используйте Python именно активной установки ComfyUI и требования пакета из README ComfyUI-Florence2.
Частые вопросы
Нода сама создаёт подписи для всего датасета?
Обычно нет. Она предоставляет модель; пакетное чтение фото, запуск captioning и сохранение TXT выполняются другими блоками workflow.
Почему имя ноды не совпадает с уроком?
У разных пакетов и версий разные типы. Ориентируйтесь на источник JSON и README расширения, а не только на похожий текст названия.