快照管理
创建环境快照，预览恢复影响，并安全地恢复或删除快照。
快照记录 WebUI 类型、Core 提交、Python 软件包和扩展状态，用于在版本、依赖或扩展修改后恢复环境。创建快照时默认包含软件包信息。
快照不是完整文件备份
快照通常不包含模型、输出图片、任意用户文件或未提交代码的完整副本。执行高风险操作前，仍需单独备份这些内容。
创建和查看快照
在“资源 → 快照”中点击“创建快照”。
等待右下角状态区或任务中心显示完成，不要在创建期间重装或恢复环境。
刷新列表，展开新快照，核对创建时间、软件包数、扩展数和 Core 提交。
格式错误的快照会显示解析错误，不能直接恢复。删除快照只会永久删除对应的快照文件，不会修改当前环境。
恢复选项
| 选项 | 关闭时 | 开启时 |
|---|---|---|
| 清理额外软件包 | 恢复记录的软件包，保留快照之后新增的软件包 | 卸载快照中没有记录的软件包 |
| 清理额外扩展 | 恢复记录的扩展，保留快照之后新增的扩展 | 删除快照中没有记录的扩展 |
| 强制 Git 重置 | 未提交修改可能成为恢复阻塞项 | 丢弃 WebUI 和扩展仓库的未提交修改后切换到记录提交 |
某些快照会把选项标记为“必需”；不启用必需选项时，恢复不能开始。
预览并恢复
做好恢复准备
建议停止 WebUI，等待版本、扩展、模型和 PyTorch 等管理任务结束，并备份未提交代码与重要文件。
打开恢复窗口
点击目标快照的“恢复”。选择清理和 Git 重置选项后，应用会自动生成与当前实例状态绑定的恢复预览。
阅读阻塞项
类型不匹配、Core 缺失、仓库存在未提交修改或其他无法解析的问题会阻止恢复。按提示处理或启用所需选项，然后等待预览自动重新分析。
核对计划变更
分别查看仓库、Python 软件包和扩展的新增、移除、更新、跳过与无变化项目。不要只看变更总数。
确认恢复
只有当前预览可恢复时才能提交。任务接受后恢复窗口会关闭，后续阶段和输出在右下角状态区及任务中心查看。
完成后验证
刷新版本、扩展和 PyTorch 页面，再启动 WebUI。模型和用户文件需要按独立备份自行核对。
预览会绑定快照、恢复选项、管理 API 状态和实例配置。预览完成后如果修改了路径、启动配置或其他实例设置，旧预览会失效；关闭窗口并重新生成，不要尝试重复提交。
清理和强制重置会删除内容
“清理额外软件包”“清理额外扩展”和“强制 Git 重置”都可能移除当前环境中快照没有保留的内容。只有在预览列表与独立备份都确认无误后再恢复。