术语表
需求
统一用户文档中容易混淆的产品、组件、执行位置和协议术语。
架构
| 术语 | 含义 |
|---|---|
| Alice | 面向用户的 Windows Electron 桌面应用 |
| McAgent | 仓库和技术系统语境中的项目名 |
| Agent Core | Alice 主进程能力：模型、智能体、TCP、工具调度、记忆、任务和 QQ |
| Adapter | 运行在 Minecraft 侧、向 Agent Core 注册并执行工具的接入端 |
| Java Adapter / Alice Mod | Fabric + Carpet 服务端世界执行端 |
| Bedrock Adapter | BDS Legacy Script Engine Node.js 执行端 |
| 工作区（Workspace） | 关联实例、工具注册和智能体运行上下文的隔离单位 |
| 实例（Instance） | 一个可认证连接的 Minecraft 执行端 |
| 本地工具 | 在 Agent Core 内执行、不是 Adapter 提供的工具 |
| 动态注册 | Adapter 在连接后上报当前工具 Schema，列表可随版本、扩展和工作区变化 |
| Tool Schema | 工具名、说明、参数及可选输出约束 |
| JSON-RPC | Alice 与 Adapter 使用的请求、响应和通知消息格式 |
| OneBot | Agent Core 与 NapCat 交换 QQ 事件和操作的接口 |
| NapCat | Alice QQ 接入所使用的 QQ/OneBot 执行组件 |
| 危险级别 | 文档对只读、可恢复写入、高风险写入和外部副作用的提示，不替代权限控制 |
执行
阅读工具文档时先确认“执行位置”和“工作区”，不要因 Java 与 Bedrock 存在同名工具而假设参数、返回和行为完全相同。协议字段以 协议参考 为准，运行支持范围以 兼容矩阵 为准。