状态检查与 Doctor
status 回答“Anyy 现在在使用什么”,doctor 回答“这些配置和依赖是否健康”。两者都是只读诊断命令。
快速检查
anyy status
anyy doctor
脚本读取或需要保存诊断结果时使用:
anyy status --json
anyy doctor --json
status 可以查看离线 Profile,而且不会为了检查而创建缺失的状态数据库。Gateway 可连接时,它还会补充实时运行状态。
Status 会显示什么
栏目会随安装版本和已启用功能变化,通常包含:
- 当前 Profile、默认 Role,以及 Home、Config、State、Workspace 路径;
- Gateway Listener 与实时 RPC 是否可达;
- provider/model 和凭据引用状态;
- Channels、Cron、Heartbeat、MCP、存储状态;
- 运行时或版本不一致警告。
分析后面的异常前,先确认最上方的 Profile 和路径是自己要检查的那一个。
Doctor 检查什么
Doctor 会探测文件系统、配置、模型服务、Gateway Listener 以及已启用的子系统。每个结果都有状态和安全说明;需要处理时会给出修复方向,不会输出凭据明文。
先全局,再进入单项
先运行 anyy doctor。只有综合结果指向某个功能时,再使用 anyy browser doctor 或 anyy channel doctor CHANNEL。
检查另一 Profile 或配置文件
anyy --profile work status
anyy --profile work doctor
anyy doctor --config /path/to/config.yaml
明确指定 Config 只是进行诊断,不会改变当前 Profile,也不会安装这份文件。
推荐排障顺序
- 用
anyy status核对 Profile 和路径; - 阅读
anyy doctor的所有失败与警告; - 回到对应 Dashboard 页面修复凭据或设置;
- 运行对应功能的 Doctor;
- 只有修复建议要求时才重启 Gateway;
- 再跑一遍两个综合检查,仍有问题就保存 JSON 结果。
常见结果
| 诊断结果 | 处理方法 |
|---|---|
| Gateway 不可达 | 查看 anyy gateway status,再启动或重启 |
| 凭据引用无法解析 | 从 Models、Tools 或 Channels 替换 Key |
| Listener 暴露方式有警告 | 使用推荐的本地监听,或保护远程访问路径 |
| 渠道处于降级状态 | 打开 Dashboard → Channels,并运行渠道 Doctor |
| 存储压力 | 先备份,检查 Profile 占用,再使用支持的维护命令 |
| 版本不一致 | 完成更新并重启已安装的 Gateway 服务 |
诊断会遮蔽已知 Secret,但文件里仍可能包含用户内容和环境信息。对外发送前应人工检查。