Troubleshooting
先运行 evoai doctor，再对症下药。
诊断
evoai doctor # 检查 配置/Home/API/Console/端口/数据库/模型
evoai doctor --fix # 自动修复安全、明确、可逆的问题
常见问题
Chat 返回「执行失败」
原因：未配置模型密钥或本地模型未启动。解决：export DEEPSEEK_API_KEY=sk-xxx 或启动 Ollama 后重启 API。这是诚实降级，不是故障。
Web Console 打不开
检查 evoai status 中地址；API 在 3000、Console 在 5173。LAN 访问需同网段。
重启后数据丢失
原因：未配置 DATABASE_URL，使用 InMemory。配置 PostgreSQL 并执行迁移。
node join 提示 403
令牌无效/过期/已使用。重新 evoai node add 生成新令牌。
升级失败
系统自动回滚到 backup 版本。也可手动 evoai rollback。
日志
evoai logs # 最近日志（事件+审计）
evoai logs --follow # 持续跟踪
备份与恢复
evoai backup # 备份当前版本（config + binaries）到 backup/<version>
evoai rollback # 回滚到上一个稳定版本