工作区与游戏实例
工作区把 Alice 中的配置、工具注册表和智能体关联到一个 Minecraft Java 或 Bedrock 实例。它是连接上下文，不是世界存档的副本。
支持状态：已支持
本页只说明应用内日常管理；Adapter 安装、端口和跨主机限制属于部署文档。
需求
开始前需要启动已安装 Alice Adapter 的游戏实例，使其生成实例描述文件并连接 Agent Core。工作区列表会展示：
- 名称、Java/Bedrock 版本；
online、connecting或offline状态；- 当前动态注册工具数；
- 可选图标、描述和最近活动时间。
同一个工作区可关联多个智能体。智能体执行游戏工具时，Alice 根据其 workspaceId 选择 TCP 连接。
架构
实例描述文件提供身份、版本和连接元数据；Alice 验证后建立工作区记录。工作区在线时，Adapter 动态注册其可用工具并持续更新连接状态。
Minecraft Java / Bedrock 实例
→ Adapter 连接 Agent Core
→ Alice 工作区变为在线
→ 工具注册表更新
→ 智能体通过 workspaceId 调度工具Java 和 Bedrock Adapter 当前实际连接目标以部署文档为准；不要在用户界面中把修改未生效的 host/port 当作跨主机方案。
执行
添加和选择
- 启动 Minecraft 实例及 Adapter。
- 打开 Alice 顶部工作区切换器。
- 若实例未自动出现，使用添加入口选择实例描述文件。
- 在确认弹窗核对版本、类型和路径，可修改显示名称及图标。
- 选择工作区，等待状态变为在线。
成功标志：工作区显示绿色在线状态，版本信息正确，创建向导的工具列表能加载当前 Adapter 工具。
日常管理
在工作区菜单中可：
- 切换当前工作区；
- 重命名显示名称；
- 修改图标；
- 在资源管理器打开实例文件位置；
- 移除 Alice 中的工作区记录。
移除工作区不会删除 Minecraft 世界。在线状态下移除可能要求先断开或再次确认；关联智能体的 workspaceId 不会自动变成另一个世界，请在移除前检查依赖。
实例与智能体控制
- 选择左侧智能体；
- 查看标题栏的智能体状态、QQ 状态与
假人状态； - 用启用开关决定智能体是否处理请求；
- 用
上线/下线控制游戏假人； - 切换工作区后刷新工具，避免沿用其他实例的能力预期。
失败处理
- 一直离线：确认游戏实例和 Adapter 已启动，并查看部署诊断；
- 一直连接中：检查协议版本、认证和 TCP 状态；
- 版本或类型不对：重新选择正确的实例描述文件；
- 在线但工具为空：等待工具注册事件后刷新；
- 假人控制失败：确认智能体归属当前在线工作区，并检查 Adapter 端是否接受该智能体配置。