常见问题排查
安装问题
桌面应用问题
配置问题
运行时问题
日志与诊断
查看 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:
node --version输出~/.pilotdeck/pilotdeck.yaml内容(脱敏 API Key)- Server 启动日志
- 操作系统版本