# 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** 的定义构建，commit 为 `73c9bad4d21e7addbe1d13bc92eee0f1431b017d`。该版本的依赖项指向 **comfyui-frontend-package 1.52.7**，前端 commit 为 `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 中的 checkpoint 选择。如果文件被放入了子文件夹，请选择其真实路径，并在你的清单副本中保留这一修改。如果菜单中没有提供该选项，请先检查它的位置以及你安装中的额外路径，然后根据你所使用版本的流程刷新模型或重启。

分支 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 并不能锁定一个真实物体。对于产品的忠实呈现，这个文生图文件夹只是方向研究，而不是受控复现流程。

当文件存在、能打开、尺寸符合预期并满足你的标准时，在你的机器上的验证就完成了。记录环境，导出所用的 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`。软件和模型保留各自的许可证。本项目不需要任何账户、支付、身份、cookie 或密钥文件。

## v1 输出的兼容性

新图像使用前缀 `RenderParcel/ceramique-v1/`。任何已存在的输出文件夹都不会被移动或删除。十五个节点的标识符、链接和设置保持不变。

验证器也接受历史前缀 `Prismora/ceramique-v1/`，变体名称相同。因此它可以用当前清单读取较早的 v1 工作流；它不接受不同的变体名称。已生成的图像保留其原始路径。