从快照恢复

环境快照记录 WebUI 类型、Python、软件包、Core 提交和扩展等可恢复信息。它适合重新创建环境或迁移配置，但不是模型、输出和全部用户文件的完整备份。

获取快照文件

在原实例中打开“实例管理 → 快照”，点击“创建快照”。创建的 JSON 位于：

<原实例根目录>/snapshots/<快照 ID>.json

创建完成后可以展开详情，确认 WebUI 类型、Python 版本、软件包、扩展和 Core 提交。迁移到另一台设备时，需要自行复制这个 JSON，以及模型、输出、配置和自定义文件。

新实例恢复会在创建记录前验证快照：

检查	要求
文件	有效 JSON 文件，大小不超过 64 MiB
快照格式	当前支持的环境快照格式版本
WebUI 类型	必须与创建页面中选择的类型一致
Python	CPython，且主次版本属于应用支持范围
平台	Windows、macOS 或 Linux 平台必须与当前系统兼容

快照不会自动跨平台转换 Python 环境，也不会替换成另一种 WebUI。

在首页点击“添加实例”，将来源切换为“从快照恢复”。

选择快照原本所属的 WebUI。类型不匹配时会在提交后被拒绝，不会创建错误类型的实例。

名称可以留空。推荐将安装根目录留空或选择一个新的专用目录；手动选择的目录就是最终实例根目录。

标准恢复保留默认的 <实例根目录>/python 和 <实例根目录>/core。不要把包含重要未备份修改的现有 Core 作为恢复目标。

在“快照 JSON 文件”中选择原实例 snapshots 目录里的文件。原始文件在实例创建时会被读取并保存为当前实例的受管恢复数据。

点击“恢复并安装”。应用会按快照记录的 Python 版本准备运行时，然后恢复 WebUI Core、软件包和扩展。

完成后检查版本、扩展和组件路径，再确认 WebUI 能够启动。最后单独复制或重新配置未包含在快照中的模型、输出、工作流和自定义文件。

新实例恢复会对目标做严格同步

恢复会清理快照中不存在的软件包和扩展，并强制重置目标 WebUI 与扩展 Git 仓库。目标目录中的未提交代码修改可能丢失，因此应优先使用空目录。

如果只想把当前实例恢复到同一实例里的旧状态，应使用“实例管理 → 快照 → 恢复”，那里会先预览变更；本页描述的是用 JSON 创建一个新实例。

出现类型、平台或安装错误时，继续阅读安装进度与故障处理。