跳到主要内容

状态检查与 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 doctoranyy channel doctor CHANNEL

检查另一 Profile 或配置文件

anyy --profile work status
anyy --profile work doctor
anyy doctor --config /path/to/config.yaml

明确指定 Config 只是进行诊断,不会改变当前 Profile,也不会安装这份文件。

推荐排障顺序

  1. anyy status 核对 Profile 和路径;
  2. 阅读 anyy doctor 的所有失败与警告;
  3. 回到对应 Dashboard 页面修复凭据或设置;
  4. 运行对应功能的 Doctor;
  5. 只有修复建议要求时才重启 Gateway;
  6. 再跑一遍两个综合检查,仍有问题就保存 JSON 结果。

常见结果

诊断结果处理方法
Gateway 不可达查看 anyy gateway status,再启动或重启
凭据引用无法解析从 Models、Tools 或 Channels 替换 Key
Listener 暴露方式有警告使用推荐的本地监听,或保护远程访问路径
渠道处于降级状态打开 Dashboard → Channels,并运行渠道 Doctor
存储压力先备份,检查 Profile 占用,再使用支持的维护命令
版本不一致完成更新并重启已安装的 Gateway 服务

诊断会遮蔽已知 Secret,但文件里仍可能包含用户内容和环境信息。对外发送前应人工检查。