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 数据目录。
执行
安装与初始化
- 打开官方 Releases,下载 Windows
.exe安装程序。 - 退出旧版 Alice 后运行安装程序,按 NSIS 向导完成安装。
- 启动 Alice,确认主窗口可打开。
- 进入“模型”,添加 Provider、模型名称、Base URL 和 API Key,并执行连接测试。
- 创建智能体,选择主模型;需要 QQ 时可另外选择 QQ 模型。
- 需要 Minecraft 时,先保持 Alice 运行,再启动同机 Java 或 Bedrock 执行端。
源码验证
在仓库根目录使用 Node.js 20+ 安装依赖并按项目脚本构建。不要用旧 Node.js 版本推断构建结果;发布安装包仍以官方 Releases 为准。
验收
- Alice 可进入模型、智能体、工作区和机器人页面。
- 模型连接测试成功。
- PowerShell 对
127.0.0.1:27541的测试可达,排查方式见 网络与端口。 - 不把数据库、API Key 或诊断包公开分享。