跳到主要内容

用状态检查定位问题

排障先确认环境,再检查健康,不要看到一项警告就立即重启:

anyy status
anyy doctor
anyy config

这些命令用于查看和诊断,不修改产品配置。doctor 的部分 MCP 检查会探测外部连接;它不是修复命令。

三个命令分别回答什么​

命令主要内容
statusProfile、默认 Role、Home、时区及来源、Gateway 状态与监听、Cron、Heartbeat、存储、MCP、Prompt Program 状态
doctorHome/Profile、配置和时区有效性、Gateway 监听姿态、Cron、Heartbeat、MCP 和状态库等检查项
config配置文件与相关路径、provider/model、Endpoint、凭据引用等配置概况

status 会尝试补充 Gateway 实时状态;离线也能查看本地信息,而且不会为检查创建缺失的状态数据库。不要把它当作完整模型、凭据或各渠道的在线测试。doctor 的输出为 ok、warn、fail、info 加说明;没有某项失败不等于该模型已成功回答。

先指定正确的 Profile​

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

--config 只选择本次诊断文件,不安装它。CLI 与 Dashboard 结果不同,到 Dashboard About 对照 Home 和运行中的构建。

按故障继续查​

  • Gateway 不可达:先 anyy gateway status,需要时再启动或重启对应 Profile。
  • 模型调用失败:进入 Models 检查选择与凭据,用该页测试;config 只能反映配置。
  • 某个消息渠道异常:运行 anyy channel doctor CHANNEL 并查看对应渠道详情。
  • 存储或状态库异常:先做备份,再选择支持的维护操作。
  • MCP 异常:根据具体 transport、process 或凭据引用检查项处理,再复查。

需要给脚本读取时使用:

anyy status --json
anyy doctor --json

JSON 有助于保存检查结果;对外发送前仍应检查私人路径、用户内容和环境细节,已知 Secret 的遮蔽并不等于整份报告都适合公开。