部署与运维部署概览

部署概览

Alice 以 Windows 桌面应用为控制中心，可按需连接 Java、Bedrock 或 QQ。本文只描述当前源码确认的部署路径。

需求

  • Agent Core：64 位 Windows；正式安装产物仅确认 Windows NSIS。
  • 从 copper-lamp/Alice-App Releases 获取安装程序。
  • 从源码构建时使用 Node.js 20 或更高版本及 pnpm 8 或更高版本。
  • Java：Minecraft 1.21.4、Java 21、Fabric Loader、Fabric API、Carpet 与 Alice Mod，Carpet 是必需依赖。
  • Bedrock：能够加载 Legacy Script Engine Node.js 插件的 BDS 环境。
  • QQ：一个专用 QQ 账号；默认使用 Alice 内置的 NapCat desktop 向导。
  • 模型：在 Alice UI 的“模型”页面准备 Provider、模型名称、Base URL 与 API Key。

架构

模型服务 ← Alice Agent Core（Windows / SQLite）
                     ├─ TCP 127.0.0.1:27541 ← Java Fabric Adapter
                     ├─ TCP 127.0.0.1:27541 ← Bedrock LSE Node.js Adapter
                     └─ OneBot WebSocket ↔ NapCat ↔ QQ

当前 Java 与 Bedrock Adapter 的连接目标固定为 127.0.0.1:27541，因此游戏执行端必须与 Alice 同机。模型、智能体、记忆与运行数据由 UI 管理并持久化到 SQLite；不要使用旧版文件配置教程。

执行

  1. 按 下载与支持平台 安装 Windows Agent Core。
  2. 在 Alice“模型”页面添加并测试模型，详见 模型管理。
  3. 选择执行端：
  4. 按 网络与端口 确认同机链路。
  5. 创建智能体并绑定工作区或 QQ 账号，流程见 五步创建智能体。
  6. 完成一次只读请求，再按 部署诊断 检查状态。
  7. 上线前配置 数据备份 与 升级和回滚。

成功标志：Alice 正常启动、模型测试通过、目标实例或 QQ 账号在线，并完成一次最小请求。

Agent Core