排障

先从这里开始

aegis status
aegis logs core
aegis diagnostics deployment-readiness
aegis diagnostics native-readiness

常见问题

症状	可能原因	第一项检查
Core 无法访问	Core 未启动、profile 错误、端口冲突	aegis status
Chat 无法规划工具	provider 缺失或无效	provider 环境变量与 provider 状态
Worker 说无法执行	Local Gateway 未连接或工具未声明	aegis worker tools --no-exec
移动应用无法连接	Core URL 错误、没有 LAN/private/tunnel 路由、token 未配对	Core URL 与 pairing state
Channel 收到消息但不执行	handler 应将普通 prose 路由给 Manager，而不是解析关键词	gateway logs 与 provider trace
原生应用显示权限缺失	OS-level permission 未授权	平台 Settings / privacy permissions

移动配对

移动设备使用受限 native node token。它们不应保存长期 owner token。

如果配对失败：

1. 确认手机可以访问 Core URL。
2. 确认设备在同一个可信网络、VPN、Tailscale 或 tunnel 中。
3. 从桌面应用生成新的 setup link 或二维码。
4. 在 Core 中批准该设备。
5. 必要时撤销过期 device token。

何时看日志

日志用于检查运行时行为，而不是绕过产品状态：

aegis logs core

AI tool-use 问题应优先查看 provider trace 和 tool ledger 证据，而不是只从 raw logs 猜测。