ComfyUI 模型库备份:保留工作流程,回收磁盘空间
有用的 ComfyUI 备份始于正在运行的安装实际加载的路径。盘点原生文件夹和每个额外模型路径,把已知工作流程所需的检查点与配套模型归为一个系列,将该系列归档,再恢复到单独测试位置。只有工作流程成功运行后,你才可以选择删除冗余副本。

从 ComfyUI 的活动模型路径开始
原生 ComfyUI 模型文件夹按类型组织:检查点、扩散模型、LoRAs、VAEs、文本编码器、ControlNets 等。extra_model_paths.yaml 或 Desktop 的 extra_models_config.yaml 可以把这些类型指向其他模型库。自定义节点可能会注册额外位置。
这意味着仅复制 ComfyUI/models 可能会产生一个看似可信但并不完整的备份。打开活动模型文件夹,检查额外路径配置,并记录你关心的工作流程所使用的自定义节点存储。
ComfyUI/models/ # 原生类型文件夹
/Volumes/AI-Library/models/ # 一个可能的额外路径
custom_nodes/... # 仅当某个节点软件包在此拥有资产时
先备份一个工作流程系列,而不是整个硬盘
选择一个重要工作流程。查看其加载器节点,确定它引用的确切检查点或扩散模型、VAE、文本编码器、LoRAs、ControlNets 及其他模型资产。保存工作流程 JSON 或包含工作流程元数据的图像,但不要把该图误认为权重本身。
模型系列边界让首次恢复测试易于理解。如果恢复后的工作流程失败,你可以看出遗漏了哪项依赖。未经筛选的数 TB 副本会让遗漏更难诊断,并推迟你确认任何内容可恢复的时点。
查找副本时,不要假定名称能证明文件相同
同一个检查点可能以不同名称同时存在于原生和额外文件夹中。两个相同文件名也可能包含不同字节。在把候选文件称作副本前先进行哈希,并记录哪些活动路径和工作流程引用每份副本。
共享额外路径可以消除多个 ComfyUI 安装之间的冗余工作副本,但也会形成共享故障域。从该模型库中删除内容会影响所有指向它的安装。共享路径是组织方式,不是备份。
创建并验证归档
- 停止对所选模型系列进行中的下载、训练和写入。
- 记录源路径、大小和校验和。
- 在不改变张量精度或格式的情况下归档完整的相关模型系列。
- 接触工作文件前先运行归档验证。
- 恢复到有足够空间进行真实测试的新目录。
- 逐字节比较恢复内容和源文件。
Tensor Archive 专为这个本地精确保留步骤设计:选择相关本地张量,将其归档并验证,然后恢复原始字节以作证明。它不会编辑 ComfyUI 的 YAML、自动删除源文件,也不会认定两个视觉相似的输出来自可互换模型。
让 ComfyUI 加载恢复后的模型系列
将测试目录添加为额外模型路径,或把恢复后的文件放入隔离的 ComfyUI 测试安装。重新启动 ComfyUI,使路径状态的变化毫无歧义。打开已保存工作流程,并在加入队列前检查每个模型加载器。
运行适合该工作流程的小型确定性测试或其他可识别测试。目标不是证明生成输出在每种硬件和软件环境中都能达到位级一致,而是证明模型文件已逐字节恢复,并且预期工作流程能够加载它们。
不要意外地用原件进行测试。 在隔离的测试配置中暂时删除或禁用原来的额外路径,防止 ComfyUI 静默回退到工作副本。
按最安全的顺序回收空间
- 删除已重定向引用的字节级相同冗余工作副本。
- 只有在记录来源后,才审查过时的实验性 LoRAs 和检查点。
- 当派生的量化或合并副本无法重建源工件时,请保留源工件。
- 在恢复后的模型系列经受一次重启和真实工作流程加载前,不要改动活动路径。
对于适配器密集的安装,请遵循专门的LoRA 模型库磁盘空间释放指南。对于更广泛的梳理,请使用模型库保留清单。
此备份本身不会保留的内容
模型权重只是可重现 ComfyUI 环境的一部分。请使用适合相应资产的工具,保留 ComfyUI 和自定义节点版本、工作流程文件、相关 Python 或软件包状态、提示词、随机种子和许可证。Tensor Archive 专注于张量保留;源代码控制和环境清单仍各有职责。
来源
- ComfyUI 文档:模型 — 原生文件夹类型、Desktop 位置、额外路径和故障排除。
- ComfyUI extra model paths example(额外模型路径示例) — 当前外部模型库配置键。
- ComfyUI folder_paths.py — 当前默认注册和运行时路径处理。