Skip to main content

常见问题排查

安装问题

桌面应用问题

配置问题

运行时问题

日志与诊断

查看 Server 日志

Server 日志直接输出到标准输出。常见的日志前缀:

前缀来源
[always-on]Always-On Discovery 模块
[cron]Cron 定时任务模块
[PilotDeck]Router 重试 / 回退信息
[runtime]关闭流程信息

配置诊断

启动时的配置问题会以诊断信息输出:

[config] warning: deprecated field "agent.fallbackModel", migrate to "router.fallback.default"
[config] error: missing_provider "nonexistent" referenced by agent.model
提示 · Tip

如果遇到无法解决的问题,建议收集以下信息后提交 Issue:

  1. node --version 输出
  2. ~/.pilotdeck/pilotdeck.yaml 内容(脱敏 API Key)
  3. Server 启动日志
  4. 操作系统版本