部署与运维Agent Core

Agent Core 部署

Agent Core 是 Alice 的 Windows 桌面控制中心,负责模型调度、智能体、工作区、记忆、QQ 与本地数据持久化。

需求

使用安装包

  • 64 位 Windows 环境。
  • 安装程序只从 copper-lamp/Alice-App Releases 下载。
  • 当前只确认 Windows NSIS 产物;没有经源码确认的 macOS 或 Linux 安装包。

从源码运行

  • Node.js 20 或更高版本。
  • pnpm 8 或更高版本。
  • 项目源码及构建所需的 Windows 环境。

架构

Alice UI
  ├─ 模型、智能体、工作区与 QQ 配置
  ├─ SQLite:模型配置、API Key、智能体、记忆与任务等
  ├─ TCP 服务:接收同机 Adapter 连接
  └─ 更新器:读取 copper-lamp/Alice-App Releases

模型配置的有效入口是 UI,数据保存到 SQLite。不要手工创建或修改旧版模型、应用设置文件。API Key 当前保存在本地数据库中,应保护 Windows 账户及 Alice 数据目录。

执行

安装与初始化

  1. 打开官方 Releases,下载 Windows .exe 安装程序。
  2. 退出旧版 Alice 后运行安装程序,按 NSIS 向导完成安装。
  3. 启动 Alice,确认主窗口可打开。
  4. 进入“模型”,添加 Provider、模型名称、Base URL 和 API Key,并执行连接测试。
  5. 创建智能体,选择主模型;需要 QQ 时可另外选择 QQ 模型。
  6. 需要 Minecraft 时,先保持 Alice 运行,再启动同机 Java 或 Bedrock 执行端。

源码验证

在仓库根目录使用 Node.js 20+ 安装依赖并按项目脚本构建。不要用旧 Node.js 版本推断构建结果;发布安装包仍以官方 Releases 为准。

验收

  • Alice 可进入模型、智能体、工作区和机器人页面。
  • 模型连接测试成功。
  • PowerShell 对 127.0.0.1:27541 的测试可达,排查方式见 网络与端口。
  • 不把数据库、API Key 或诊断包公开分享。

继续阅读:模型管理 · 安装验证 · 数据与隐私