兼容矩阵
需求
版本和平台事实集中在本页维护，其他页面只引用，避免多个版本口径漂移。核对基线：2026-07-28 当前源码。
架构
| 组件 | 当前源码基线 | 平台/运行时 | 连接边界 |
|---|---|---|---|
| Alice / Agent Core | package 0.0.17 | Windows，Electron 37；构建目标 NSIS | TCP 监听 0.0.0.0:27541 |
| Java Adapter | Minecraft 1.21.4 | Java 21；Fabric Loader 0.16.10；Fabric API 0.119.4+1.21.4；Carpet 1.21.4-1.4.161+v241203 | 实际目标 127.0.0.1:27541 |
| Bedrock Adapter | package 1.0.0 | BDS + Legacy Script Engine Node.js 兼容环境 | 当前按同机 127.0.0.1:27541 使用 |
| Agent Core 内置 | NapCat / OneBot WebSocket；desktop 为默认模式 | 默认 ws://127.0.0.1:3001 | |
| Wire protocol | 1.0.0 | JSON-RPC 2.0 over TCP | 换行分帧、令牌握手 |
| 仓库开发环境 | 根项目要求 | Node.js 20+ | 使用项目声明的包管理命令 |
Carpet 是 Java Adapter 必需依赖，不是可选增强。Windows 之外没有在当前构建配置中确认正式安装包。
执行
安装或升级前逐项对齐矩阵；不要只对齐 Minecraft 大版本。实例无法连接时，先确认 Agent Core 与 Adapter 同机、端口未占用、版本字段及令牌一致，然后查看 连接问题。