开始使用下载与支持平台

下载与支持平台

适用对象

准备安装 Alice 桌面应用或 Minecraft 执行端的用户。

支持状态与验证版本

项目当前状态事实基线
Alice 桌面安装包已支持Windows NSIS;当前源码版本 0.0.17
macOS 安装包未提供当前构建配置没有 macOS 产物
Linux 安装包未提供当前构建配置没有 Linux 产物
Java Adapter已支持Minecraft 1.21.4、Java 21、Fabric Loader 0.16.10、Fabric API 0.119.4+1.21.4、Carpet 1.4.161
Bedrock Adapter实验性BDS 的 Legacy Script Engine(LSE)Node.js 插件
QQ 接入已支持Alice 应用内桌面版 NapCat 向导为默认路径

前置条件

  • 64 位 Windows 环境,用于安装并运行 Alice 桌面应用。
  • 若使用 Java:准备 Minecraft 1.21.4 与 Java 21。
  • 若使用 Bedrock:准备可运行 LSE Node.js 插件的 BDS 环境。
  • 若使用 QQ:准备一个用于机器人的 QQ 账号,并理解第三方协议接入可能带来的账号风控风险。

步骤

  1. 从 Alice 桌面应用的 GitHub Releases 获取 Windows 安装程序。
  2. 运行 .exe 安装程序,并按向导选择安装目录。
  3. 根据使用方式准备对应执行端:
    • Java:必须同时安装 Fabric Loader、Fabric API、Carpet 与 Alice Mod,不能省略 Carpet。
    • Bedrock:安装项目提供的 Bedrock Adapter 编译产物及其 manifest.json,插件类型应为 lse-nodejs,依赖 legacy-script-engine-nodejs。
    • 纯 QQ:无需安装 Minecraft 执行端,后续直接使用 Alice 内的 NapCat 向导。
  4. 继续所选的快速开始页面,不要使用旧文档中的 macOS、Linux、现代 LeviLamina 原生插件或手工 TCP 地址流程。

成功标志

  • Windows 开始菜单或安装目录中可以启动 Alice。
  • Alice 主窗口正常显示,且可以进入模型、智能体和 QQ 等页面。
  • 所选执行端依赖与上表版本、运行时类型一致。

常见失败

  • 找不到 macOS/Linux 安装包:当前没有这两类正式安装包,不要下载第三方冒充产物。
  • Windows 阻止运行:确认文件来自上述发布仓库,再在 Windows 安全提示中查看详细信息;无法确认来源时不要继续。
  • Java 启动时报缺少依赖:检查 Fabric API 与 Carpet 是否都已放入同一游戏实例或服务端的 mods 目录。
  • Bedrock 插件不加载:确认使用的是 LSE Node.js 环境,且插件目录包含编译后的 index.js 与 manifest.json。

下一步