用状态检查定位问题
排障先确认环境,再检查健康,不要看到一项警告就立即重启:
anyy status
anyy doctor
anyy config
这些命令用于查看和诊断,不修改产品配置。doctor 的部分 MCP 检查会探测外部连接;它不是修复命令。
三个命令分别回答什么
| 命令 | 主要内容 |
|---|---|
status | Profile、默认 Role、Home、时区及来源、Gateway 状态与监听、Cron、Heartbeat、存储、MCP、Prompt Program 状态 |
doctor | Home/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 的遮蔽并不等于整份报告都适合公开。