数据备份
备份应同时覆盖 Alice 桌面数据、Minecraft Adapter 数据和可选 QQ 数据,而不是只复制单个配置文件。
需求
- 可停止 Alice、Minecraft/BDS 与托管 NapCat 的维护窗口。
- 一个不与源数据共盘的受保护备份位置。
- 足够空间保存 SQLite 数据库、WAL/SHM 伴随文件、Java
Alice/目录和必要的 QQ 数据。 - 备份不得公开分享,因其中可能包含 API Key、Token、对话、世界身份与登录态。
架构
| 数据域 | 当前内容 | 备份原则 |
|---|---|---|
| Alice 本地数据 | SQLite 中的模型、API Key、智能体、记忆、任务等 | 停止写入后整体备份数据库及伴随文件 |
| Java Adapter | 游戏根目录 Alice/,含实例、配置、日志及世界 SQLite | 按实例整体复制 Alice/ |
| Bedrock Adapter | 插件编译产物、manifest 与插件运行数据 | 与 BDS 世界备份一起保存 |
| QQ/NapCat | 账号配置、Token、登录态、媒体与日志 | 按“机器人”页面显示的数据目录单独保存 |
| Chroma | 可选语义索引 | 需要快速恢复时备份;否则可重建 |
模型配置由 UI 写入 SQLite,不存在应当单独维护的旧版模型配置文件。
执行
创建一致性备份
- 记录 Alice、Adapter、Minecraft/BDS 与 NapCat 版本。
- 停止定时任务和自动触发,退出 Alice,并停止 Minecraft/BDS 与 Alice 托管的 NapCat。
- 确认相关进程不再写入后,复制 Alice 数据目录中的 SQLite 数据库及同名
-wal、-shm文件。 - Java 实例整体复制游戏根目录的
Alice/;同时按服务器策略备份世界存档。 - Bedrock 保存完整插件目录、BDS 世界与运行环境版本信息。
- 需要保留 QQ 登录态时,复制 NapCat 数据目录;将其视为高敏感凭据。
- 将备份写入受保护位置,并校验文件大小、数量及可读性。
恢复验证
- 在隔离副本中恢复,不直接覆盖唯一生产数据。
- 使用与备份匹配的应用和 Adapter 版本启动。
- 依次验证 Alice 启动、模型记录、智能体、工作区、记忆与 QQ 账号。
- Java 执行
/alice status;Bedrock 检查 LSE Node.js 加载日志。 - 恢复成功后再清理旧副本。