# RenderParcel — Ceramika, trzy intencje światła

Wersja pakietu: **1.0.0**. Oryginalny workflow do odtworzenia eksperymentu twórczego na innej maszynie.

**Co jest dostarczane:** JSON interfejsu ComfyUI 0.4, 15 wbudowanych węzłów, trzy gałęzie światła, dokładny manifest modelu i źródeł oprogramowania, walidator offline oraz pusty arkusz porównawczy.

**Co zostało sprawdzone:** składnia JSON, oficjalny schemat UI 0.4, struktura węzłów, typy połączeń, graf bez cykli, zgodność parametrów oraz celowo wprowadzone wartości domyślne. **ComfyUI nie zostało uruchomione; nie wygenerowano żadnego obrazu, nie zmierzono zapotrzebowania na VRAM ani czasu generowania.** Import do interfejsu ComfyUI i uruchomienie w Twoim środowisku pozostają do sprawdzenia. Pakiet nie zawiera żadnych wag.

## 1. Weryfikacja pakietu bez ComfyUI

Rozpakuj archiwum i otwórz terminal w `comfyui-v1`. Z Pythonem 3.10 lub nowszym:

```console
python validate_workflow.py
```

Walidator korzysta wyłącznie z biblioteki standardowej, nie łączy się z żadnym serwerem i nie uruchamia żadnych obliczeń AI. Oczekiwany wynik dla nienaruszonego pakietu zawiera `ok: true`, `nodes: 15`, `links: 25`, `checkpoint_verified: false`, `comfyui_executed: false` oraz `image_generated: false`. Niepowodzenie zwraca kod wyjścia 1 i wyjaśnienie. Ten walidator sprawdza konkretny profil tego pakietu, a nie dowolny możliwy workflow ComfyUI.

## 2. Zebranie zależności na maszynie docelowej

Graf został zbudowany na podstawie definicji **ComfyUI 0.37.0**, commit `73c9bad4d21e7addbe1d13bc92eee0f1431b017d`. Zależności tej wersji wskazują na **comfyui-frontend-package 1.52.7**, commit frontendu `1a7a6b82514874545dc5e8203d0bd2188c2d9b18`. To dokładne odniesienia dokumentacyjne, a nie środowisko zainstalowane i uruchomione w ramach tej dostawy. Nowsza wersja może zaimportować ten format; taka możliwość nie jest równoznaczna z walidacją jej działania.

Użyj [oficjalnej instalacji dostosowanej do Twojego systemu](https://docs.comfy.org/installation/manual_install). Nie zastępuj na ślepo swojej instalacji produkcyjnej. Zapisz faktycznie używane wersje w `environnement-a-remplir.json`, w szczególności Python, PyTorch, sterownik, precyzję i opcje uruchomienia. Żaden Python/PyTorch do generowania nie jest tu przedstawiany jako przetestowany.

Jedynym wymaganym modelem jest **Stable Diffusion XL Base 1.0** od Stability AI:

- repozytorium: `stabilityai/stable-diffusion-xl-base-1.0` ;
- rewizja: `462165984030d82259a11f4367a4eed129e94a7b` ;
- plik: `sd_xl_base_1.0.safetensors` ;
- rozmiar referencyjny: `6938078334` bajtów, bez bezpośredniego związku ze szczytowym zużyciem VRAM ;
- referencyjny SHA-256: `31e35c80fc4829d14f90153f4c74cd59c90b779f6afe05a74cd6120b893f7e5b` ;
- przewidywana lokalizacja: `ComfyUI/models/checkpoints/sd_xl_base_1.0.safetensors`.

Zapoznaj się z [plikiem wydawcy w ustalonej rewizji](https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0/blob/462165984030d82259a11f4367a4eed129e94a7b/sd_xl_base_1.0.safetensors) oraz jego [licencją CreativeML Open RAIL++-M](https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0/blob/462165984030d82259a11f4367a4eed129e94a7b/LICENSE.md), zanim pobierzesz go osobno. Pakiet nie wykonuje żadnego pobierania. Skrót pochodzi z metadanych LFS wydawcy; nie został ponownie obliczony na wagach w ramach tej dostawy.

Aby porównać plik, który już posiadasz, bez ładowania go do pamięci GPU:

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

Ta opcja odczytuje plik, aby zweryfikować jego rozmiar i skrót. Może to zająć trochę czasu w zależności od nośnika. Poprawny skrót nie jest dowodem udanego uruchomienia. Ten graf nie wymaga żadnego refinerа, LoRA, ControlNet, obrazu wejściowego ani niestandardowego węzła.

## 3. Import i odczyt trzech gałęzi

Otwórz przygotowaną instalację ComfyUI, a następnie zaimportuj `workflow-ui.json` do interfejsu, otwierając workflow lub przeciągając i upuszczając JSON na kanwę. **Nie wysyłaj tego pliku do punktu końcowego API `/prompt`: opisuje on interfejs, a nie ładunek wykonawczy API.**

Sprawdź wybór checkpointu w węźle 1. Jeśli plik został umieszczony w podfolderze, wybierz jego rzeczywistą ścieżkę i zachowaj tę zmianę w swojej kopii manifestu. Jeśli menu go nie proponuje, sprawdź najpierw jego lokalizację oraz dodatkowe ścieżki swojej instalacji, a następnie odśwież modele lub uruchom ponownie zgodnie z procedurą swojej wersji.

Gałęzie A, B i C dotyczą tego samego fikcyjnego obiektu: matowego, ivory wazonu na kobaltowej podstawce, z wolnym obszarem przewidzianym na tytuł dodany później w programie do składu. Prompty są w języku angielskim w tym przykładzie SDXL; folder wyjaśnia ich rolę po francusku. Zmienia się tylko ostatnie zdanie promptu pozytywnego: frontalne miękkie, lewostronne, pod światło.

Trzy KSampler używają `24092026`, kontrola po generowaniu `fixed`, 24 kroki, CFG 6.5, `euler`, `normal`, denoise 1. Wspólny latent ma 1024 × 1024 pikseli z partią 1. Te liczby definiują ćwiczenie; nie są ani uniwersalnym optymalnym ustawieniem, ani miarą wydajności. Przepis nie steruje trzema GPU i nie składa tryptyku w jeden obraz.

## 4. Uruchom i oceń swój wynik

Uruchom przebieg, gdy zależności są dostępne. Każda gałąź musi osiągnąć swój węzeł SaveImage. Prefiksy to `RenderParcel/ceramique-v1/a_frontale`, `b_laterale` i `c_contrejour` w katalogu wyjściowym ComfyUI; ComfyUI dodaje swoje liczniki plików. Trzy gałęzie nie gwarantują jednoczesnego wykonania.

Otwórz trzy pliki PNG. Wypełnij `comparaison.csv`: czytelna krawędź, czytelny materiał, miejsce na tytuł, zniekształcenie, wybrany wariant i komentarz. Komórki są celowo puste. Światło może też zmienić sylwetkę lub kompozycję: wspólny seed nie blokuje rzeczywistego obiektu. Do wiernego przedstawienia produktu ten folder text-to-image jest tylko studium kierunku, nie procedurą kontrolowanej reprodukcji.

Walidacja na twojej maszynie jest zakończona, gdy pliki istnieją, otwierają się, mają przewidziane wymiary i spełniają twoje kryteria. Zanotuj środowisko, wyeksportuj użyty JSON i zachowaj obraz kontrolny wygenerowany przez swój przebieg. Nie wymyślaj czasu trwania ani VRAM, jeśli ich nie zmierzyłeś.

## 5. Odbuduj, zmodyfikuj, przekaż dalej

`reconstruction.md` szczegółowo opisuje każde połączenie i kolejność widgetów. Aby zmodyfikować przypadek, zduplikuj folder, zmieniaj jedną zmienną naraz i aktualizuj manifest. Walidator profilu v1 może odrzucić celowe rozszerzenie: nie dowodzi to, że jest ono nieprawidłowe dla ComfyUI, a jedynie, że wykracza poza kontrolowany folder.

Zachowaj JSON niezależnie od plików PNG. Wbudowane metadane mogą zostać usunięte przez konwersję lub udostępnienie. Zarchiwizuj także swój uzupełniony manifest, porównanie i wybrane wyniki. Biblioteki, wagi i sterowniki pozostają odrębnymi zależnościami.

## Źródła techniczne

- [Format UI ComfyUI 0.4](https://docs.comfy.org/specs/workflow_json_0.4).
- [Węzły wbudowane, źródło ComfyUI 0.37.0](https://github.com/Comfy-Org/ComfyUI/blob/73c9bad4d21e7addbe1d13bc92eee0f1431b017d/nodes.py).
- [Zależności tej wersji](https://github.com/Comfy-Org/ComfyUI/blob/73c9bad4d21e7addbe1d13bc92eee0f1431b017d/requirements.txt).
- [Lokalizacja modeli](https://docs.comfy.org/basic-concepts/models).
- [SDXL w ComfyUI, przykłady autora](https://comfyanonymous.github.io/ComfyUI_examples/sdxl/).
- [Granice odtwarzalności PyTorch](https://docs.pytorch.org/docs/2.14/notes/randomness.html).

Oryginalne zasoby folderu podlegają `LICENSE.md`. Oprogramowanie i model zachowują własne licencje. Żaden plik konta, płatności, tożsamości, cookie ani sekret nie jest potrzebny do tego projektu.

## Zgodność wyników v1

Nowe obrazy używają prefiksu `RenderParcel/ceramique-v1/`. Żaden już istniejący katalog wyjściowy nie jest przenoszony ani usuwany. Identyfikatory piętnastu węzłów, połączenia i ustawienia pozostają identyczne.

Walidator akceptuje także historyczny prefiks `Prismora/ceramique-v1/`, z tymi samymi nazwami wariantów. Może więc odczytać wcześniejszy workflow v1 z aktualnym manifestem; nie akceptuje innej nazwy wariantu. Już wygenerowane obrazy zachowują swoją oryginalną ścieżkę.