部署与运维升级与回滚

升级与回滚

Alice 与 Adapter 应按兼容组合升级。任何升级前都应先建立可恢复备份，并保留原安装包与模组/插件产物。

需求

  • 新版本来源可信：Agent Core 仅使用 copper-lamp/Alice-App Releases。
  • 完整备份 Alice SQLite、Java Alice/、世界、Bedrock 插件数据与必要 QQ 数据。
  • 记录当前版本、Minecraft 1.21.4、Java 21、Fabric/Fabric API/Carpet 和 LSE 运行环境。
  • 预留停止 Alice、游戏服务器与 NapCat 的维护窗口。

架构

Agent Core 版本 ↔ 通信协议/SQLite ↔ Adapter 版本 ↔ Minecraft 运行环境

Agent Core 使用 Windows NSIS 安装与更新；Java Adapter 依赖 Minecraft 1.21.4、Java 21、Fabric API 和 Carpet；Bedrock Adapter 依赖 LSE Node.js。升级任一层都可能影响握手、工具注册或数据迁移，因此先备份、再逐层验证。

执行

升级

  1. 阅读发布说明，确认目标版本没有改变运行时或 Adapter 要求。
  2. 按 数据备份 停机并创建一致性备份。
  3. 保存当前 Windows 安装程序、Java JAR 或 Bedrock 完整插件目录作为回滚材料。
  4. 先升级 Agent Core；启动后验证 UI、SQLite 数据与模型记录。
  5. 如发布说明要求，再升级 Adapter：
    • Java：停止实例后替换 Alice Mod JAR，保持 Minecraft 1.21.4、Java 21、Fabric API 与 Carpet 兼容。
    • Bedrock：停止 BDS 后替换完整编译产物，确认 manifest.json 和 index.js 同步。
  6. 启动顺序为 Alice → Minecraft/BDS → NapCat 或 QQ 账号。
  7. 验证实例握手、动态工具注册、模型调用和一次只读请求。

回滚

  1. 验证失败时立即停止自动任务和所有相关进程。
  2. 保存失败现场的日志副本，不要在原数据库上反复试错。
  3. 卸载或替换为已保存的旧版本产物。
  4. 若升级写入了不兼容数据，整体恢复升级前 SQLite、WAL/SHM、Java Alice/ 及相关插件数据。
  5. 按原版本组合启动并完成最小验证。

不要混用新旧 Adapter 文件，也不要从非官方仓库寻找所谓 macOS/Linux 安装包。失败定位见 部署诊断。

数据备份部署诊断