Doctor 是 cloddsbot 提供的系统健康诊断与故障排查工具,用于运行系统诊断、查看健康状态并定位问题。
用途:对运行环境做整体或分项体检,帮助判断服务是否健康、是否存在警告或严重故障。
主要能力:支持聊天命令 /doctor(全部诊断)、/doctor quick(快速检查)、/doctor full(完整扫描)、/doctor <component>(指定组件),以及 /health、/status、/status verbose 状态查询。可检查的组件包括 system(操作系统、内存、磁盘)、node(Node.js 版本与内存)、network(连通性)、api(API 密钥校验)、database(数据库连接)、channels(频道健康),文档还列出 mcp 与 dependencies 检查项。
使用方式:可通过 TypeScript API 调用 createDoctorService 创建服务,配置 checks、thresholds(内存、磁盘、延迟的警告与严重阈值)和 timeoutMs,然后调用 runDiagnostics 或 checkSystem、checkNode、checkNetwork、checkApiKeys、checkDatabase、checkChannels 等单项检查,并用 formatReport 格式化报告。CLI 命令包括 clodds doctor、clodds doctor --quick、clodds doctor --check system、clodds doctor --json。
结果与状态:整体状态分为 healthy、degraded、unhealthy;单项结果为 pass、warn、fail、skip。
适用场景:日常健康巡检、变更后验证、部署前检查、排查内存过高、API 密钥无效、数据库连接失败、频道断开等常见问题。
限制:资料未提供安装方式、依赖要求、支持的平台范围及收费信息;具体阈值与超时需按实际环境配置。