# RenderParcel — Керамика, три варианта света

Версия пакета: **1.0.0**. Оригинальный workflow для воспроизведения творческого эксперимента на другой машине.

**Что входит в поставку:** JSON интерфейса ComfyUI 0.4, 15 встроенных узлов, три ветви света, точный манифест модели и программных источников, офлайн-валидатор и пустой лист сравнения.

**Что было проверено:** синтаксис JSON, официальная схема UI 0.4, структура узлов, типы соединений, граф без циклов, согласованность параметров и намеренно внесённые значения по умолчанию. **ComfyUI не запускался; ни одно изображение не было сгенерировано, ни потребность в VRAM, ни время генерации не измерялись.** Импорт в интерфейс ComfyUI и запуск в вашей среде ещё предстоит проверить. Пакет не содержит никаких весов.

## 1. Проверка пакета без ComfyUI

Распакуйте архив и откройте терминал в `comfyui-v1`. При наличии Python 3.10 или более новой версии:

```console
python validate_workflow.py
```

Валидатор использует только стандартную библиотеку, не обращается ни к какому серверу и не запускает никаких ИИ-вычислений. Ожидаемый результат для неповреждённого пакета содержит `ok: true`, `nodes: 15`, `links: 25`, `checkpoint_verified: false`, `comfyui_executed: false` и `image_generated: false`. При сбое возвращается код выхода 1 и пояснение. Этот валидатор проверяет конкретный профиль данного пакета, а не любой возможный workflow ComfyUI.

## 2. Сбор зависимостей на целевой машине

Граф был построен на основе определений **ComfyUI 0.37.0**, коммит `73c9bad4d21e7addbe1d13bc92eee0f1431b017d`. Зависимости этой версии указывают на **comfyui-frontend-package 1.52.7**, коммит фронтенда `1a7a6b82514874545dc5e8203d0bd2188c2d9b18`. Это точные документальные ссылки, а не установленная и запущенная в данной поставке среда. Более новая версия может импортировать этот формат; такая возможность не равнозначна подтверждению её поведения.

Используйте [официальную установку, подходящую для вашей системы](https://docs.comfy.org/installation/manual_install). Не заменяйте вслепую вашу рабочую установку. Зафиксируйте фактически используемые вами версии в `environnement-a-remplir.json`, в частности Python, PyTorch, драйвер, точность и параметры запуска. Никакой Python/PyTorch для генерации здесь не представлен как протестированный.

Единственная требуемая модель — **Stable Diffusion XL Base 1.0** от Stability AI:

- репозиторий: `stabilityai/stable-diffusion-xl-base-1.0`;
- ревизия: `462165984030d82259a11f4367a4eed129e94a7b`;
- файл: `sd_xl_base_1.0.safetensors`;
- эталонный размер: `6938078334` байт, без прямой связи с пиковым потреблением VRAM;
- эталонный SHA-256: `31e35c80fc4829d14f90153f4c74cd59c90b779f6afe05a74cd6120b893f7e5b`;
- предполагаемое расположение: `ComfyUI/models/checkpoints/sd_xl_base_1.0.safetensors`.

Ознакомьтесь с [файлом издателя по фиксированной ревизии](https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0/blob/462165984030d82259a11f4367a4eed129e94a7b/sd_xl_base_1.0.safetensors) и его [лицензией CreativeML Open RAIL++-M](https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0/blob/462165984030d82259a11f4367a4eed129e94a7b/LICENSE.md) прежде чем получать его отдельно. Пакет не выполняет никаких загрузок. Отпечаток взят из метаданных LFS издателя; он не был пересчитан по весам в данной поставке.

Чтобы сравнить файл, который у вас уже есть, не загружая его в память GPU:

```console
python validate_workflow.py --checkpoint "D:/modeles/sd_xl_base_1.0.safetensors"
```

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

## 3. Импорт и чтение трёх ветвей

Откройте подготовленную установку ComfyUI, затем импортируйте `workflow-ui.json` в интерфейс — через открытие workflow или перетаскиванием JSON на холст. **Не отправляйте этот файл в точку входа API `/prompt`: он описывает интерфейс, а не полезную нагрузку для выполнения через API.**

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

Ветки A, B и C используют один и тот же вымышленный объект: матовая цвета слоновой кости ваза на кобальтово-синем постаменте, со свободной зоной, предусмотренной для заголовка, добавляемого позже в программе вёрстки. Промпты в этом примере SDXL на английском; папка объясняет их роль по-французски. Меняется только последняя фраза положительного промпта: мягкий фронтальный свет, левая боковая, контровой свет.

Все три KSampler используют `24092026`, контроль после генерации `fixed`, 24 шага, CFG 6.5, `euler`, `normal`, denoise 1. Общий latent — 1024 × 1024 пикселей с размером пакета 1. Эти числа определяют упражнение; они не являются ни универсальной оптимальной настройкой, ни измерением производительности. Рецепт не управляет тремя GPU и не собирает триптих в одно изображение.

## 4. Запуск и оценка результата

Запустите выполнение, когда зависимости доступны. Каждая ветка должна достичь своего узла SaveImage. Префиксы — `RenderParcel/ceramique-v1/a_frontale`, `b_laterale` и `c_contrejour` в выходном каталоге ComfyUI; ComfyUI добавляет свои счётчики файлов. Три ветки не гарантируют одновременного выполнения.

Откройте три PNG. Заполните `comparaison.csv`: читаемый край, читаемая материя, место для заголовка, деформация, выбранный вариант и комментарий. Ячейки намеренно оставлены пустыми. Свет также может изменить силуэт или композицию: общий seed не фиксирует реальный объект. Для точного представления продукта эта папка text-to-image — лишь исследование направления, а не метод контролируемого воспроизведения.

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

## 5. Восстановление, изменение, передача

`reconstruction.md` подробно описывает каждое соединение и порядок виджетов. Чтобы изменить случай, дублируйте папку, меняйте по одной переменной за раз и обновляйте манифест. Валидатор профиля v1 может отклонить намеренное расширение: это не доказывает, что оно недопустимо для ComfyUI, а лишь то, что оно выходит за пределы контролируемой папки.

Храните JSON отдельно от PNG. Встроенные метаданные могут быть удалены при конвертации или передаче. Архивируйте также ваш заполненный манифест, сравнение и выбранные выходные файлы. Библиотеки, веса и драйверы остаются отдельными зависимостями.

## Технические источники

- [Формат UI ComfyUI 0.4](https://docs.comfy.org/specs/workflow_json_0.4).
- [Встроенные узлы, исходный код ComfyUI 0.37.0](https://github.com/Comfy-Org/ComfyUI/blob/73c9bad4d21e7addbe1d13bc92eee0f1431b017d/nodes.py).
- [Зависимости этой версии](https://github.com/Comfy-Org/ComfyUI/blob/73c9bad4d21e7addbe1d13bc92eee0f1431b017d/requirements.txt).
- [Расположение моделей](https://docs.comfy.org/basic-concepts/models).
- [SDXL в ComfyUI, примеры автора](https://comfyanonymous.github.io/ComfyUI_examples/sdxl/).
- [Ограничения воспроизводимости PyTorch](https://docs.pytorch.org/docs/2.14/notes/randomness.html).

Оригинальные ресурсы папки регулируются `LICENSE.md`. Программы и модель сохраняют свои собственные лицензии. Для этого проекта не требуется ни один файл аккаунта, платежа, удостоверения личности, cookie или секрета.

## Совместимость выходных данных v1

Новые изображения используют префикс `RenderParcel/ceramique-v1/`. Ни одна уже существующая выходная папка не перемещается и не удаляется. Идентификаторы пятнадцати узлов, связи и настройки остаются неизменными.

Валидатор также принимает исторический префикс `Prismora/ceramique-v1/` с теми же именами вариантов. Так он может прочитать более ранний workflow v1 с текущим манифестом; он не принимает другое имя варианта. Уже созданные изображения сохраняют свой исходный путь.