# RenderParcel — Gốm sứ, ba ý đồ ánh sáng

Phiên bản hồ sơ: **1.0.0**. Quy trình gốc để tái tạo một thử nghiệm sáng tạo trên máy khác.

**Những gì được cung cấp:** một JSON giao diện ComfyUI 0.4, 15 nút tích hợp, ba nhánh ánh sáng, một bản kê chính xác về model và các nguồn phần mềm, một trình kiểm tra ngoại tuyến và một bảng so sánh để trống.

**Những gì đã được kiểm tra:** cú pháp JSON, schema chính thức UI 0.4, cấu trúc các nút, kiểu kết nối, đồ thị không có chu trình, các tham số khớp nhau và các giá trị mặc định được đưa vào có chủ đích. **ComfyUI chưa được khởi chạy; không có hình ảnh nào được tạo, không có nhu cầu VRAM hay thời gian tạo nào được đo.** Việc nhập vào một giao diện ComfyUI và chạy trên môi trường của bạn vẫn cần được kiểm tra. Hồ sơ không chứa bất kỳ trọng số nào.

## 1. Kiểm tra hồ sơ mà không cần ComfyUI

Giải nén tệp lưu trữ và mở terminal trong `comfyui-v1`. Với Python 3.10 hoặc mới hơn:

```console
python validate_workflow.py
```

Trình kiểm tra chỉ dùng thư viện chuẩn, không liên hệ với máy chủ nào và không chạy bất kỳ tính toán AI nào. Kết quả mong đợi cho hồ sơ nguyên vẹn chứa `ok: true`, `nodes: 15`, `links: 25`, `checkpoint_verified: false`, `comfyui_executed: false` và `image_generated: false`. Một thất bại trả về mã thoát 1 và một lời giải thích. Trình kiểm tra này kiểm soát đúng hồ sơ cụ thể này, không phải mọi quy trình ComfyUI có thể có.

## 2. Tập hợp các phụ thuộc trên máy đích

Đồ thị được xây dựng từ các định nghĩa của **ComfyUI 0.37.0**, commit `73c9bad4d21e7addbe1d13bc92eee0f1431b017d`. Các phụ thuộc của phiên bản này chỉ định **comfyui-frontend-package 1.52.7**, commit frontend `1a7a6b82514874545dc5e8203d0bd2188c2d9b18`. Đây là những tham chiếu tài liệu chính xác, không phải một môi trường đã cài đặt và chạy trong bản cung cấp này. Một phiên bản mới hơn có thể nhập định dạng này; khả năng đó không đồng nghĩa với việc xác nhận hành vi của nó.

Hãy dùng [bản cài đặt chính thức phù hợp với hệ thống của bạn](https://docs.comfy.org/installation/manual_install). Đừng thay thế một cách mù quáng bản cài đặt sản xuất của bạn. Ghi lại các phiên bản bạn thực sự dùng trong `environnement-a-remplir.json`, đặc biệt là Python, PyTorch, trình điều khiển, độ chính xác và các tùy chọn khởi chạy. Không có Python/PyTorch tạo sinh nào được trình bày là đã kiểm thử ở đây.

Model duy nhất được yêu cầu là **Stable Diffusion XL Base 1.0** của Stability AI:

- kho: `stabilityai/stable-diffusion-xl-base-1.0`;
- revision: `462165984030d82259a11f4367a4eed129e94a7b`;
- tệp: `sd_xl_base_1.0.safetensors`;
- kích thước tham chiếu: `6938078334` byte, không liên quan trực tiếp đến mức đỉnh VRAM;
- SHA-256 tham chiếu: `31e35c80fc4829d14f90153f4c74cd59c90b779f6afe05a74cd6120b893f7e5b`;
- vị trí dự kiến: `ComfyUI/models/checkpoints/sd_xl_base_1.0.safetensors`.

Hãy xem [tệp của nhà phát hành ở revision đã cố định](https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0/blob/462165984030d82259a11f4367a4eed129e94a7b/sd_xl_base_1.0.safetensors) và [giấy phép CreativeML Open RAIL++-M](https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0/blob/462165984030d82259a11f4367a4eed129e94a7b/LICENSE.md) của nó trước khi tự tải về. Hồ sơ không thực hiện bất kỳ tải xuống nào. Mã băm đến từ siêu dữ liệu LFS của nhà phát hành; nó chưa được tính lại trên các trọng số trong bản cung cấp này.

Để so sánh tệp bạn đã có, mà không nạp nó vào bộ nhớ GPU:

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

Tùy chọn này đọc tệp để kiểm tra kích thước và mã băm của nó. Nó có thể mất thời gian tùy theo thiết bị lưu trữ. Một mã băm đúng không phải là bằng chứng chạy thành công. Không có refiner, LoRA, ControlNet, ảnh đầu vào hay nút tùy chỉnh nào được đồ thị này yêu cầu.

## 3. Nhập và đọc ba nhánh

Mở một bản cài đặt ComfyUI đã chuẩn bị, rồi nhập `workflow-ui.json` vào giao diện, bằng cách mở workflow hoặc kéo thả JSON lên canvas. **Đừng gửi tệp này đến điểm cuối API `/prompt`: nó mô tả giao diện, không phải payload thực thi API.**

Kiểm tra lựa chọn checkpoint trong nút 1. Nếu tệp đã được đặt trong thư mục con, hãy chọn đường dẫn thực tế của nó và giữ nguyên thay đổi đó trong bản sao manifest của bạn. Nếu menu không hiển thị nó, trước tiên hãy kiểm tra vị trí của nó và các đường dẫn bổ sung trong bản cài đặt của bạn, sau đó làm mới các mô hình hoặc khởi động lại theo quy trình của phiên bản bạn dùng.

Các nhánh A, B và C sử dụng cùng một đối tượng hư cấu: một chiếc bình ngà mờ trên đế xanh coban, với một vùng trống dành cho tiêu đề sẽ được thêm sau bằng phần mềm dàn trang. Các prompt bằng tiếng Anh cho ví dụ SDXL này; tài liệu giải thích vai trò của chúng bằng tiếng Pháp. Chỉ câu cuối cùng của prompt khẳng định thay đổi: chính diện dịu, bên trái, ngược sáng.

Ba KSampler dùng `24092026`, kiểm tra sau khi tạo `fixed`, 24 bước, CFG 6.5, `euler`, `normal`, denoise 1. Latent chung là 1024 × 1024 pixel với batch 1. Những con số này xác định bài tập; chúng không phải là một thiết lập tối ưu phổ quát cũng không phải là một thước đo hiệu năng. Công thức này không điều khiển ba GPU và không ghép một triptych thành một hình ảnh duy nhất.

## 4. Chạy và đánh giá kết quả của bạn

Khởi chạy một lần chạy khi các phụ thuộc đã sẵn sàng. Mỗi nhánh phải đạt tới nút SaveImage của nó. Các tiền tố là `RenderParcel/ceramique-v1/a_frontale`, `b_laterale` và `c_contrejour` trong thư mục đầu ra của ComfyUI; ComfyUI thêm các bộ đếm tệp của nó. Ba nhánh không đảm bảo một lần chạy đồng thời.

Mở ba tệp PNG. Điền vào `comparaison.csv`: cạnh rõ ràng, chất liệu rõ ràng, chỗ cho tiêu đề, biến dạng, biến thể được chọn và nhận xét. Các ô được để trống có chủ đích. Ánh sáng cũng có thể thay đổi hình dáng hoặc bố cục: một seed chung không khóa được một đối tượng thực. Để có một biểu diễn trung thực của một sản phẩm, tài liệu text-to-image này chỉ là một nghiên cứu về hướng đi, không phải là một quy trình tái tạo được kiểm soát.

Việc xác thực trên máy của bạn hoàn tất khi các tệp tồn tại, mở được, có kích thước dự kiến và đáp ứng các tiêu chí của bạn. Ghi lại môi trường, xuất JSON đã dùng và giữ một hình ảnh đối chứng do lần chạy của bạn tạo ra. Đừng bịa ra một khoảng thời gian hay VRAM nếu bạn chưa đo nó.

## 5. Tái tạo, sửa đổi, truyền đạt

`reconstruction.md` trình bày chi tiết từng kết nối và thứ tự các widget. Để sửa đổi trường hợp, hãy nhân bản tài liệu, thay đổi từng biến một và cập nhật manifest. Trình xác thực của hồ sơ v1 có thể từ chối một phần mở rộng có chủ đích: điều đó không chứng minh rằng nó không hợp lệ với ComfyUI, chỉ chứng minh rằng nó nằm ngoài tài liệu được kiểm soát.

Giữ JSON độc lập với các tệp PNG. Siêu dữ liệu được nhúng có thể bị loại bỏ qua một lần chuyển đổi hoặc chia sẻ. Lưu trữ cả manifest đã điền của bạn, bảng so sánh và các đầu ra được chọn. Các thư viện, trọng số và trình điều khiển vẫn là những phụ thuộc riêng biệt.

## Nguồn kỹ thuật

- [Định dạng UI ComfyUI 0.4](https://docs.comfy.org/specs/workflow_json_0.4).
- [Các nút tích hợp, mã nguồn ComfyUI 0.37.0](https://github.com/Comfy-Org/ComfyUI/blob/73c9bad4d21e7addbe1d13bc92eee0f1431b017d/nodes.py).
- [Các phụ thuộc của phiên bản này](https://github.com/Comfy-Org/ComfyUI/blob/73c9bad4d21e7addbe1d13bc92eee0f1431b017d/requirements.txt).
- [Vị trí các mô hình](https://docs.comfy.org/basic-concepts/models).
- [SDXL trong ComfyUI, các ví dụ của tác giả](https://comfyanonymous.github.io/ComfyUI_examples/sdxl/).
- [Giới hạn khả năng tái lập của PyTorch](https://docs.pytorch.org/docs/2.14/notes/randomness.html).

Các tài nguyên gốc của tài liệu thuộc `LICENSE.md`. Các phần mềm và mô hình giữ giấy phép riêng của chúng. Không cần tệp tài khoản, thanh toán, danh tính, cookie hay bí mật nào cho dự án này.

## Khả năng tương thích của các đầu ra v1

Các hình ảnh mới dùng tiền tố `RenderParcel/ceramique-v1/`. Không có thư mục đầu ra nào đã tồn tại bị di chuyển hay xóa. Các định danh của mười lăm nút, các liên kết và thiết lập vẫn giữ nguyên.

Trình xác thực cũng chấp nhận tiền tố lịch sử `Prismora/ceramique-v1/`, với cùng các tên biến thể. Nhờ đó nó có thể đọc một workflow v1 trước đó với manifest hiện tại; nó không chấp nhận một tên biến thể khác. Các hình ảnh đã tạo giữ nguyên đường dẫn gốc của chúng.