部署与运维部署诊断

部署诊断

本页用于在部署后快速定位 Agent Core、模型、Adapter、QQ 或数据层故障。

需求

  • 记录故障发生时间、组件版本、完整错误文本与最小复现步骤。
  • 准备 Alice、Minecraft/BDS、Fabric/LSE 与 NapCat 日志。
  • 分享前删除 API Key、Token、二维码、QQ 登录态、私人消息与实例认证信息。
  • Java 可执行 /alice status；Bedrock 可查看 BDS 控制台。

架构

用户请求 → Alice UI / SQLite → 模型服务
                         ├─ TCP → Java / Bedrock → Minecraft
                         └─ OneBot → NapCat → QQ

按层排查比重复重装更可靠：应用启动 → 数据库 → 模型 → 本机 TCP → Adapter 握手与工具注册 → 智能体绑定 → 具体工具或 QQ 权限。

执行

  1. 应用层：确认 Alice 能打开模型、智能体、工作区和机器人页面。安装问题参见 下载与支持平台。
  2. 模型层：在 UI 重新测试模型。401/403 检查凭据，404 检查 Base URL 和模型名，超时检查网络；参见 模型问题。
  3. 端口层：运行：
Test-NetConnection -ComputerName 127.0.0.1 -Port 27541
  1. Java 层：确认 Minecraft 1.21.4、Java 21、Fabric API、Carpet、Alice Mod 均加载，再执行 /alice status。不要使用旧命令。
  2. Bedrock 层：确认 LSE Node.js 加载 manifest.json 与编译后的 index.js，且入口连接同机 127.0.0.1:27541。
  3. 工作区层：实例在线但无工具时检查握手与动态注册日志，不按固定工具数量判断。
  4. QQ 层：默认 desktop 先检查 NapCat 进程、账号在线、智能体绑定、白名单与 @ 规则；docker/external 再检查容器或 WebSocket Token。
  5. 数据层：出现 SQLite 错误时停止写入并保留数据库、WAL、SHM 的现场副本，再从一致性备份恢复。
  6. 最小验证：只读查询或普通 QQ 问候成功后，再启用写世界、群管理或自动任务。
  7. 提交反馈：只提供脱敏日志、版本组合和复现步骤，按 FAQ 与反馈 操作。

成功标志：能够明确故障层级，并在 快速诊断 与对应支持页完成最小链路验证。

升级与回滚