# RenderParcel — 도자기, 세 가지 빛의 의도

파일 버전: **1.0.0**. 다른 머신에서 창작 실험을 재현하기 위한 원본 워크플로우입니다.

**제공되는 것:** ComfyUI 0.4 인터페이스 JSON, 내장 노드 15개, 세 개의 빛 분기, 모델과 소프트웨어 소스의 정확한 매니페스트, 오프라인 검증기, 그리고 빈 비교 시트.

**검증된 것:** JSON 구문, 공식 UI 0.4 스키마, 노드 구조, 연결 유형, 순환 없는 그래프, 일치하는 파라미터, 의도적으로 삽입된 기본값. **ComfyUI는 실행되지 않았으며, 이미지도 생성되지 않았고, VRAM 요구량이나 생성 시간도 측정되지 않았습니다.** ComfyUI 인터페이스로의 가져오기와 사용자 환경에서의 실행은 아직 확인해야 합니다. 이 파일에는 어떤 가중치도 포함되어 있지 않습니다.

## 1. ComfyUI 없이 파일 검증하기

압축을 풀고 `comfyui-v1`에서 터미널을 여세요. Python 3.10 이상 기준:

```console
python validate_workflow.py
```

검증기는 표준 라이브러리만 사용하며, 어떤 서버에도 접속하지 않고 어떤 AI 연산도 실행하지 않습니다. 온전한 파일에 대해 예상되는 결과는 `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는 없습니다.

필요한 모델은 Stability AI의 **Stable Diffusion XL Base 1.0** 하나뿐입니다:

- 저장소: `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 설치를 열고, 워크플로우를 열거나 JSON을 캔버스에 끌어다 놓아 `workflow-ui.json`을 인터페이스로 가져오세요. **이 파일을 API 진입점 `/prompt`로 보내지 마세요: 이 파일은 API 실행 페이로드가 아니라 인터페이스를 설명합니다.**

노드 1에서 체크포인트 선택을 확인하세요. 파일이 하위 폴더에 들어 있다면 실제 경로를 선택하고, 이 변경 사항을 매니페스트 사본에 유지하세요. 메뉴에 해당 항목이 없다면 먼저 파일 위치와 설치의 추가 경로를 확인한 다음, 사용 중인 버전의 절차에 따라 모델을 새로 고치거나 재시작하세요.

A, B, C 분기는 동일한 가상 오브젝트를 사용합니다. 코발트 블루 받침 위의 무광 아이보리 화병으로, 이후 레이아웃 소프트웨어에서 추가할 제목을 위한 빈 영역이 마련되어 있습니다. 이 SDXL 예시의 프롬프트는 영어로 되어 있으며, 파일은 그 역할을 프랑스어로 설명합니다. 긍정 프롬프트의 마지막 문장만 달라집니다. 부드러운 정면광, 왼쪽 측면광, 역광입니다.

세 개의 KSampler는 `24092026`, 생성 후 확인 `fixed`, 24 스텝, CFG 6.5, `euler`, `normal`, denoise 1을 사용합니다. 공통 latent는 1024 × 1024 픽셀이며 배치는 1입니다. 이 숫자들은 이 연습을 정의할 뿐, 보편적으로 최적인 설정도 성능 측정값도 아닙니다. 이 레시피는 GPU 세 개를 제어하지 않으며 삼면화를 하나의 이미지로 조립하지도 않습니다.

## 4. 실행하고 결과 판단하기

의존성을 사용할 수 있을 때 실행하세요. 각 분기는 반드시 자신의 SaveImage 노드에 도달해야 합니다. 접두사는 ComfyUI 출력 디렉터리에서 `RenderParcel/ceramique-v1/a_frontale`, `b_laterale`, `c_contrejour`입니다. ComfyUI가 자체 파일 카운터를 추가합니다. 분기가 세 개라고 해서 동시 실행이 보장되는 것은 아닙니다.

세 개의 PNG를 여세요. `comparaison.csv`를 채우세요. 읽을 수 있는 윤곽, 읽을 수 있는 재질, 제목을 넣을 공간, 변형, 선택한 변형, 코멘트입니다. 셀은 의도적으로 비어 있습니다. 빛은 실루엣이나 구도도 바꿀 수 있습니다. 공통 seed가 실제 오브젝트를 고정하지는 않습니다. 제품을 충실하게 표현하려면 이 text-to-image 파일은 방향성 연구일 뿐이며, 통제된 재현 절차가 아닙니다.

파일이 존재하고, 열리고, 예정된 크기를 가지며, 기준을 충족하면 여러분의 컴퓨터에서의 검증이 끝난 것입니다. 환경을 기록하고, 사용한 JSON을 내보내고, 여러분의 실행으로 생성된 기준 이미지를 보관하세요. 측정하지 않았다면 소요 시간이나 VRAM을 지어내지 마세요.

## 5. 재구성, 수정, 전달

`reconstruction.md`는 각 연결과 위젯 순서를 자세히 설명합니다. 사례를 수정하려면 폴더를 복제하고, 한 번에 변수 하나만 바꾸고, 매니페스트를 업데이트하세요. 프로필 v1의 검증기는 의도적인 확장을 거부할 수 있습니다. 그것이 ComfyUI에서 유효하지 않다는 증거는 아니며, 단지 통제된 파일 범위를 벗어났다는 것뿐입니다.

JSON은 PNG와 별개로 보관하세요. 삽입된 메타데이터는 변환이나 공유 과정에서 제거될 수 있습니다. 작성 완료한 매니페스트, 비교 결과, 선택한 출력도 함께 아카이브하세요. 라이브러리, 가중치, 드라이버는 별도의 의존성으로 남습니다.

## 기술 자료

- [ComfyUI 0.4 UI 형식](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).
- [ComfyUI의 SDXL, 작성자 예시](https://comfyanonymous.github.io/ComfyUI_examples/sdxl/).
- [PyTorch 재현성 한계](https://docs.pytorch.org/docs/2.14/notes/randomness.html).

파일의 원본 리소스는 `LICENSE.md`를 따릅니다. 소프트웨어와 모델은 각자의 라이선스를 유지합니다. 이 프로젝트에는 계정, 결제, 신원, 쿠키, 시크릿 파일이 전혀 필요하지 않습니다.

## v1 출력 호환성

새 이미지는 `RenderParcel/ceramique-v1/` 접두사를 사용합니다. 이미 존재하는 출력 폴더는 이동되거나 삭제되지 않습니다. 열다섯 개 노드의 식별자, 링크, 설정은 동일하게 유지됩니다.

검증기는 역사적 접두사 `Prismora/ceramique-v1/`도 동일한 변형 이름으로 허용합니다. 따라서 현재 매니페스트로 이전 v1 워크플로를 읽을 수 있습니다. 다른 변형 이름은 허용하지 않습니다. 이미 생성된 이미지는 원래 경로를 유지합니다.