同一个项目，另一台机器：重建您的 ComfyUI 工作流。
要复现一个 ComfyUI 工作流，请携带 JSON，找出确切的模型，并记录运行它们的环境。图文件不包含权重。我们的«陶瓷——三种光线意图»资料包为您提供了一份可重建的原创配方：三个可对比的变体、一份清单和一次离线校验。JSON 和图文件均已核对；没有任何图片或 GPU 测量值被声称为本次练习所产生。
陶瓷——三种光线意图
原始工作流、清单、逐步重建、无外部依赖的 Python 验证器以及跟踪表。归档中不包含任何权重或生成结果。
已验证的内容
- JSON 符合 ComfyUI 0.4 界面架构；已校验 15 个核心节点和 25 条连接。
- 三个分支的参数已校验；文件夹内提供离线检查。
- 未执行 ComfyUI 导入和生成：未测量任何图像、时长或 VRAM。
- 模型指纹来自发行方仓库；未下载权重。
一个具体案例：寻找一张海报的光线
该项目是为一件虚构陶瓷所做的方向研究：一只哑光象牙白花瓶、一个钴蓝色底座和一片沙色背景。构图要求左上角留出一块空白区域，以便随后在排版软件中添加标题。目标是比较三种光线意图，然后说明所选方案的理由。这并非要忠实还原一件拍摄的对象。
所提供的工作流包含三个分支，尺寸相同、模型相同、种子相同、设置也相同。唯有正向提示词中的光线语句不同。它不使用任何输入图像、任何自定义节点、任何 refiner 或 LoRA。您得到的项目小到足以理解每一处连接，又足够有条理以便准备一次真正的对比。下载内容提供工作流和参数。本资料包未执行任何生成：请在您自己的环境中生成并对比图片。
准备软件并记录实际使用的版本
该图针对 ComfyUI 0.37.0 的定义及其依赖所指定的前端 1.52.7。清单保留了它们的完整 commit。这些版本是从官方来源查阅的；它们并不描述一次为本文执行的安装。请使用按适合您系统的步骤准备好的安装，然后将其版本与此参考进行比对。
Python、PyTorch、驱动程序和计算精度也属于复现资料的一部分。文件 environnement-a-remplir.json 将这些字段留空，直到您亲自观察后再填写。不要根据您 GPU 的名称照抄一个版本。页面 Environnements 有助于组织这些依赖。下载内容的校验器仅要求 Python 3.10 或更高版本及其标准库；它不需要 ComfyUI。
| 项目 | 参考号 | 本资料包中的状态 |
|---|---|---|
| ComfyUI 核心 | 0.37.0，完整 commit 见清单 | 已查阅的节点定义 |
| ComfyUI 前端 | 1.52.7，完整 commit 见清单 | 已记录的控件顺序 |
| 工作流格式 | 界面 JSON 0.4 | 已核对的 schema 和图 |
| 生成所用的 Python / PyTorch | 需在使用机器上记录 | 此处未执行任何生成 |
| 驱动程序、精度、显存和耗时 | 需在您试运行时观察 | 未测量 |
识别 checkpoint，不要将名称与内容混淆
预期文件是 sd_xl_base_1.0.safetensors，位于 ComfyUI/models/checkpoints/，来自 Stability AI 仓库中清单所固定的 revision。本配方使用完整的 SDXL Base 1.0 checkpoint：加载器向图提供模型、文本编码和 VAE。我们的资源不随附任何权重。请单独获取前查阅模型页面及其许可证。
清单提供了 6 938 078 334 字节的大小和来自发布方仓库元数据的 SHA-256 哈希值。我们未下载权重来重新计算此哈希值。校验器的 --checkpoint 选项会将您已有的文件与此参考进行比对。一个被重命名的文件不一定就是同一个模型；其在磁盘上的大小也不能给出其 GPU 显存使用峰值。
如果您的安装使用中央目录或子文件夹，请选择加载器所提议的路径并记录这一调整。菜单为空时，应先检查文件夹和加载器类型，而不是复制多份模型。
导入 JSON 并按正确顺序阅读节点
解压文件夹，然后在 ComfyUI 界面中打开 workflow-ui.json，或将该文件拖放到其画布上。这是界面格式 0.4，包含位置、控件和连接。此文件不是用于 API 入口点 /prompt 的负载。在启动任何操作之前，请检查所选的检查点以及是否缺少节点。
这 15 个节点仅使用六种内置类型。加载器、空白潜空间和负面文本是共用的。每个分支添加一个正面文本、一个 KSampler、一个 VAE 解码和一个保存。三个分支并不意味着三个 GPU 或同时执行。如果您愿意手动重建图形，reconstruction.md 文件详细说明了这 25 个连接。
| 节点 | 数量 | 本练习中的角色 |
|---|---|---|
| CheckpointLoaderSimple | 1 | 加载检查点；提供 MODEL、CLIP 和 VAE |
| EmptyLatentImage | 1 | 定义 1024 × 1024 像素和批次 1 |
| CLIPTextEncode | 4 | 编码三个正面提示和一个共用负面提示 |
| KSampler | 3 | 使用共用设置计算潜空间 |
| VAEDecode | 3 | 将潜空间解码为图像 |
| SaveImage | 3 | 将变体写入三个不同的前缀 |
Checkpoint.CLIP → Texte positif.clip
Checkpoint.MODEL → KSampler.model
Texte positif.CONDITIONING → KSampler.positive
Texte négatif.CONDITIONING → KSampler.negative
Latent vide.LATENT → KSampler.latent_image
KSampler.LATENT → VAEDecode.samples
Checkpoint.VAE → VAEDecode.vae
VAEDecode.IMAGE → SaveImage.images保持固定设置以比较三种意图
三个 KSampler 使用种子 24092026、24 步、CFG 为 6.5、采样器 euler、调度器 normal，去噪为 1。每个分支中的生成后控制都设置为 fixed。这一选择可以保持相同的试验参数；它并非声称是所有图像的最佳设置。
共用提示描述了花瓶、底座、背景和标题区域。最后一句给出了光线。您可以在清单中找到每个完整文本：重建时请复制整个变体。在此 SDXL 示例中，模型的指令为英文。共用负面提示特别要求避免文本、徽标、重复物体和变形。这些指令仍然只是对模型的要求，不保证它会完全遵守。
| 变体 | 光线指令 | 对输出要问的问题 |
|---|---|---|
| A · 正面 | 宽大、正面且柔和的光源 | 在没有过多阴影的情况下，体积是否仍然清晰可读？ |
| B · 侧面 | 左侧大光源，柔和阴影向右 | 浮雕和质感是否服务于海报？ |
| C · 逆光 | 背光并带轻微正面补光 | 亮边是否足以将花瓶分离出来？ |
在动用 GPU 之前检查文件夹
从解压后的文件夹中，运行下面的验证器。它仅读取工作流和清单，检查标识符、端口、数据类型、相互链接、是否存在循环以及三个变体参数的一致性。它不联系任何服务，也不加载任何模型。错误会指示需要检查的文件夹部分。
交付的工作流也已对照官方 UI 0.4 架构进行验证。公共验证器有意限定于本练习的配置：如果您添加另一个节点或更改其编号，它可能会拒绝您的副本，即使 ComfyUI 可以使用它。因此，在进行调整之前，请保留一份原始文件。
结果 ok: true 证明此 JSON 及其图形的一致性。它并不证明在实际界面中的导入、检查点的可用性或图像的生成。为交付此文件夹，这些后续步骤并未执行。
python validate_workflow.pypython validate_workflow.py --checkpoint "D:/modeles/sd_xl_base_1.0.safetensors"执行、打开输出并记录您的选择
当依赖项齐备后，启动工作流并确认每个分支都到达 SaveImage。前缀 a_frontale、b_laterale 和 c_contrejour 位于 ComfyUI 输出目录下的 RenderParcel/ceramique-v1/ 中。应用会用自身的计数器补全文件名。该配方生成三个独立文件；它不会自动生成对比图版。
打开 PNG，检查尺寸、花瓶边缘、材质的可读性以及标题可用的空间。用你的观察结果和选择理由填写 comparaison.csv。下载的单元格是空的：此处没有任何变体经过视觉评估。如果某次生成失败，请记录这次失败，而不是给它赋予某个耗时或质量。
同一个种子并不能保证在不同版本、硬件和运算之间得到完全相同的像素。调整光照也可能改变轮廓：该工作流探索的是一种意图，而不是锁定某个产品身份。请保留你自己运行的一张对照图像，先对照所公布的标准，只有当你的环境和协议支持时，再去比较像素。
识别阻碍恢复的错误
从第一个可观察到的错误开始。同时改动模型、ComfyUI 版本和采样参数会让诊断变得毫无必要地困难。该表把文件夹本身的缺陷与那些只在加载或生成过程中才暴露的缺陷区分开来。
如果内存不足，请记下相关步骤：加载、采样还是解码。在本练习中，批次已经限制为一张图像。较低的分辨率可以作为诊断手段，但它会引入另一次试验；请更新清单，而不是把它的结果当作来自原始案例来比较。
| 症状 | 初步检查 | 实用工具套装 |
|---|---|---|
| 菜单中缺少 Checkpoint | Checkpoint 名称和目录，或额外路径 | 根据你的安装刷新列表 |
| 导入后节点未知 | 实际使用的技术类型和版本 | 与清单中的六种核心类型对比 |
| 验证器链接错误 | 已标出输入、输出和链接编号 | 从完整副本重新开始，还是重建连接 |
| 难以比较的变体 | Seed、fixed、尺寸以及三分支的参数 | 只修改光照描述句 |
| 计算过程中显存不足 | 具体步骤与实际发起的负载 | 先测量，再准备一次适配的试跑，并使用新的清单文件 |
| PNG 存在但构图不佳 | 选择标准与完整提示词 | 仅重写一条约束；保留上一版本 |
归档一个配方，并根据你的观察选择硬件
最终交接资料汇集了实际使用的 JSON、填写完成的清单、对比结果、环境版本以及你打开过的示例输出。请将 JSON 单独保存：媒体文件的元数据在转换或分享时可能会丢失。导出指南有助于区分视觉交付物与重新运行所需的源文件。
在扩大项目规模之前，请完整观察一次从生成到解码再到保存的过程。我们在此并未测量计算时间或所需的 VRAM 容量。请根据实际观察到的需求、你的环境兼容性以及合适的套餐，考察一块 24 GB 的 RTX 4090 或一块 48 GB 的 RTX 6000 Ada。它们的显存并不构成速度上的承诺；此图不会自动将多块显卡的显存相加。
图像工作坊能帮助你在预订前明确方向与标准。随后你可以准备一套配置，并保留相同的输入用于你自己的硬件测试。该资料包的原始资源采用 MIT 许可；软件与模型仍受各自许可的约束。
推动你的项目前进。
你的疑问。
我可以在没有 SDXL 权重的情况下使用下载内容吗？+
你可以阅读清单、检查 JSON 并重建连接。一次生成需要指定的 checkpoint 以及兼容的 ComfyUI 环境。验证器不能替代这些依赖项，也不会下载它们。
为什么 JSON 使用 UI 0.4 格式？+
这是该文件夹采用并已对照官方架构验证的界面格式。它主要描述节点、节点位置和控件。该格式版本并非 ComfyUI 软件版本，此 JSON 不应与 API payload 混淆。
我只改变光线，能得到完全相同的花瓶吗？+
本配方无法保证这一点。它是在其他参数固定的情况下比较 text-to-image 提示词。模型可能改变细节、轮廓或构图。若要处理形状必须保持一致的实体产品，需要一套不同的参考与控制流程。