部署与运维数据备份

数据备份

备份应同时覆盖 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,不存在应当单独维护的旧版模型配置文件。

执行

创建一致性备份

  1. 记录 Alice、Adapter、Minecraft/BDS 与 NapCat 版本。
  2. 停止定时任务和自动触发,退出 Alice,并停止 Minecraft/BDS 与 Alice 托管的 NapCat。
  3. 确认相关进程不再写入后,复制 Alice 数据目录中的 SQLite 数据库及同名 -wal、-shm 文件。
  4. Java 实例整体复制游戏根目录的 Alice/;同时按服务器策略备份世界存档。
  5. Bedrock 保存完整插件目录、BDS 世界与运行环境版本信息。
  6. 需要保留 QQ 登录态时,复制 NapCat 数据目录;将其视为高敏感凭据。
  7. 将备份写入受保护位置,并校验文件大小、数量及可读性。

恢复验证

  1. 在隔离副本中恢复,不直接覆盖唯一生产数据。
  2. 使用与备份匹配的应用和 Adapter 版本启动。
  3. 依次验证 Alice 启动、模型记录、智能体、工作区、记忆与 QQ 账号。
  4. Java 执行 /alice status;Bedrock 检查 LSE Node.js 加载日志。
  5. 恢复成功后再清理旧副本。

如果数据库正在写入或已损坏,不要只复制一个 SQLite 主文件。隐私边界详见 数据与隐私,升级前流程见 升级与回滚。