Comfy Desktop 快照管理

在 Comfy Desktop 中备份、恢复和分享 ComfyUI 实例快照

快照记录的是实例的软件配置，不是它的文件：

• ComfyUI 版本：安装的 ComfyUI 构建版本
• 自定义节点：所有自定义节点（含版本号或提交哈希）
• pip 包：环境中由 pip freeze 输出的全部 Python 包
• Python 与 PyTorch：Python 版本，以及 Comfy Desktop 能识别时的 PyTorch 组合

快照就是还原点，更新出问题时可以回滚，也可以复制完整的安装配置分享给他人。

Comfy Desktop 会为 Standalone 实例自动创建快照：每次启动和重启、更新前后、以及还原之后。您也可以随时手动创建。

快照不包含什么

快照不是文件备份。模型、工作流、生成的输出、输入文件以及 ComfyUI 设置都不会被记录，还原也不会把它们放回来。

还原重建的是软件栈：切换回记录的 ComfyUI 版本、把自定义节点恢复成记录的那一组、同步 Python 与 PyTorch 包，并运行它改动过的节点的安装脚本。这些脚本可能会写入 ComfyUI 设置。

有两点值得注意：

• 删掉的模型不会回来。 还原旧快照不会恢复已删除的模型。下次打开用到它的工作流时，ComfyUI 会把它报为缺失模型。缺失模型对话框里对该模型给出 Download 时，Comfy Desktop 会帮您下载（参见下载）；没有这个按钮就需要自己把文件放回对应的模型目录。
• 快照存在实例文件夹里。 卸载实例会把快照历史一起删除。Forget 只是把实例从列表里移除，文件夹和快照都会保留。无论哪种情况，想留的先在快照标签页用 Export All 导出，参见分享快照。

访问快照

在任意实例卡片上点击 ⋮ 菜单（1），选择 Restore Snapshot（2）即可直接打开快照标签页。

或者，在实例卡片上打开 Manage 面板，切换到 Snapshots 标签页。

快照标签页总览

Snapshots 标签页是管理所有快照操作的入口。时间线显示该实例的快照记录，按从新到旧排列，并标注每条记录的创建方式：Boot、Manager、Update、Updated、Restored 或 Manual。如果该实例被复制到了其他实例，或本身是从其他实例复制而来的，时间线也会列出这次复制。主要操作如下：

1. 选中实例：当前查看快照的实例。
2. Snapshots 选项卡：当前焦点在快照标签页。
3. Import：导入其他用户或实例导出的快照文件。
4. Export All：导出该实例的全部快照为一个 .json 文件。
5. Create Snapshot：手动创建当前实例状态的快照。
6. Restore：将实例还原到某个快照的状态。
7. Export：导出某个特定快照。
8. Delete：删除单条快照。

创建手动快照

点击 Create Snapshot（5）即可创建。可以添加一个标签（例如"添加 LCM LoRA 前"）方便日后识别。快照将记录：

• 当前 ComfyUI 的 Git 提交哈希
• 所有已启用的自定义节点（git clone URL + commit，或 CNR ID + 版本）
• 所有 pip 包（来自 pip freeze）

手动快照不计入自动快照上限，且可以单独删除。

查看快照详情

点击任意一行即可展开。折叠状态下行内已经显示该快照的创建方式、创建时间、ComfyUI 版本，以及相对上一个快照的节点和包变更数量（新增、移除、变更）。最新的快照还会带 Latest 标记。

展开后会显示该快照的节点和包总数、标签（如果有），以及两个可折叠的差异对比：

• What changed in this snapshot：与该快照紧邻的上一个快照对比。时间线中最旧的一条没有此项。
• What restoring this would change：与实例当前状态对比。时间线中最新的那一条没有此项。

该快照的 Restore、Export 和 Delete 按钮也在展开后的区域中。时间线中最新的那一条没有 Restore 按钮。

从快照还原

1. 在 Snapshots 标签页找到要还原的快照。
2. 点击 Restore：会显示变更预览（即将发生的变化）。
3. 确认变更后，在确认对话框中点击 Restore 开始还原。

还原需要实例处于停止状态。如果开始还原时 ComfyUI 正在运行，对话框会提示将先停止该实例。Comfy Desktop 会先停止实例并等待其退出，再执行还原，并在还原成功后重新启动它。

还原过程中，Comfy Desktop 会依次：

1. 检出记录的 ComfyUI 版本（Git 提交）
2. 安装缺失的自定义节点、切换版本、启用/禁用节点
3. 恢复 pip 包：安装缺失包、升级/降级到锁定版本、移除多余包
4. 运行后安装脚本：对新安装或版本变更的自定义节点执行

Comfy Desktop 会先还原自定义节点（安装节点可能顺带引入 Python 包），再同步 Python 包。同步之前，它会备份将要覆盖或移除的包。在这一步之后取消或某个包安装失败，它会把这些包放回原处，并把 ComfyUI 退回还原前的提交。如果有包无法放回，还原会如实报告，而不会声称已完整回退。在还原节点阶段取消时，提交会回退，但已经装好的节点目录以及它们引入的包会保留下来。环境已经与快照一致时，还原会提示 No changes needed，并保持环境不变。

自定义节点按尽力而为处理。某个节点安装或切换失败不会中止其余还原：还原会完成并列出失败项，它写入时间线的记录带有 Restore did not complete 标签，同时仍带有 Restored 标记。修复或移除该节点后重新还原即可。

时间线顶部的卡片会显示上一次还原的结果：Snapshot restored 或 Restore failed。取消还原会直接关闭卡片，不留结果。还原成功时还会新增一条带 Restored 标记的记录，记录还原后的状态。

将快照导入实例

在 Snapshots 标签页点击 Import，即可把快照文件导入该实例自己的历史记录。文件中只有最新的那个快照会被应用：如果环境能被精确复现，该快照会加入时间线；否则 Comfy Desktop 会改为保存一份反映导入后状态的快照，文件里更早的快照会被忽略。如果该快照的 PyTorch 构建无法在这台机器上应用，Comfy Desktop 会在应用前提醒您。

删除快照

展开任意快照并点击 Delete 即可删除。Comfy Desktop 会为每个实例保留最新的 200 个未命名的 Boot 和 Manager 快照，写入新快照时自动移除更早的，因此这类快照无需手动清理。手动创建、更新前后以及还原后生成的快照不会被自动移除，不再需要时请自行删除。

分享快照

快照文件便于携带：一个 .json 文件就包含完整配置，可以交给同事，也可以转移到另一台机器。

有两种快捷方式可以在不打开 Snapshots 标签页的情况下导出实例的最新快照：

• 在 Dashboard 的实例卡片上打开 ⋮ 菜单，选择 Export Snapshot。
• 在实例选择器弹窗中打开底部的 More 菜单，选择 Share。

两者都会打开保存对话框，写出一个 .json 文件。如果该实例还没有任何快照，Comfy Desktop 会提示没有可分享的快照。若要导出某个特定快照，或一次性导出全部快照，请使用 Snapshots 标签页中的 Export 和 Export All。

收到文件的人既可以用它创建新实例，也可以导入到已有实例中。

从快照文件创建实例

如果有人分享了一个快照文件给您，您可以用它创建一个全新实例，配置完全一致。

1. 点击 Chooser 视图左上角的 ☰ 菜单（1），选择 Load Snapshot（2）。

1. 浏览文件系统，选择 .json 快照文件。

1. 预览快照内容：源实例名称、ComfyUI 版本、自定义节点和 pip 包。确认无误后，点击 Create Instance 从该快照创建新实例。

这会创建一个全新的独立实例，原实例不受影响。新实例将出现在 Chooser 视图中，与其他实例并列。