# RenderParcel — Кераміка, три задуми світла

Версія комплекту: **1.0.0**. Оригінальний робочий процес для відтворення творчого експерименту на іншій машині.

**Що надається:** 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 та пояснення. Цей валідатор перевіряє конкретний профіль цього комплекту, а не будь-який можливий робочий процес 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` у інтерфейс — через відкриття робочого процесу або перетягуванням JSON на полотно. **Не надсилайте цей файл на точку входу API `/prompt`: він описує інтерфейс, а не payload виконання API.**

Перевірте вибір checkpoint у вузлі 1. Якщо файл розміщено в підпапці, виберіть його фактичний шлях і збережіть цю зміну у своїй копії маніфесту. Якщо меню його не пропонує, спершу перевірте його розташування та додаткові шляхи вашого встановлення, а потім оновіть моделі або перезапустіть згідно з процедурою вашої версії.

Гілки A, B і C використовують той самий вигаданий об'єкт: матова слонової кістки ваза на кобальтово-синьому постаменті, із вільною зоною, призначеною для заголовка, який додають згодом у програмі для верстки. Промпти в цьому прикладі SDXL подані англійською; dossier пояснює їхню роль французькою. Варіюється лише останнє речення позитивного промпту: м'яке фронтальне, ліве бічне, контрове.

Три 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 не фіксує реальний об'єкт. Для точної передачі продукту цей dossier text-to-image є лише дослідженням напряму, а не способом контрольованого відтворення.

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

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

`reconstruction.md` детально описує кожне з'єднання та порядок віджетів. Щоб змінити випадок, дублюйте dossier, змінюйте одну змінну за раз і оновлюйте маніфест. Валідатор профілю v1 може відхилити навмисне розширення: це не доводить, що воно недійсне для ComfyUI, лише те, що воно виходить за межі контрольованого dossier.

Зберігайте 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).

Оригінальні ресурси dossier підпадають під `LICENSE.md`. Програмне забезпечення та модель зберігають власні ліцензії. Жоден файл акаунта, платежу, ідентичності, cookie чи секрету не потрібен для цього проєкту.

## Сумісність вихідних даних v1

Нові зображення використовують префікс `RenderParcel/ceramique-v1/`. Жоден наявний каталог вихідних даних не переміщується й не видаляється. Ідентифікатори п'ятнадцяти вузлів, зв'язки та налаштування залишаються незмінними.

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