用途:wuji doctor 是 Wuji 设备的健康自检工具,会连接每台设备、采样约 100 帧实时数据(数秒内完成),并打印树状检查报告。
主要能力:支持 wuji_glove。EMF 断连检测可定位受影响的手指,并区分 RX(接收)与 TX(发送)故障;触觉传感器可检测坏点、坏行、坏列,注意检测时需保持手套静止,不要佩戴或按压,否则可能误报。
使用方式: wuji doctor 诊断全部设备 wuji doctor --sn <SN> 只诊断一台设备 wuji doctor -v 显示全部检查项(默认隐藏通过项) wuji doctor --json 以结构化 JSON 输出与树状报告相同的信息
报告状态:✔ 通过 / ! 警告(信息性异常)/ ✘ 失败(确认故障)/ ~ 跳过(不适用或无法执行);Tip 行是修复建议。退出码 0 表示无失败(允许警告),1 表示存在失败或诊断无法完成,可直接用于脚本。未连接设备不算错误,主机环境与发现检查仍会运行并决定退出码。触觉检查结果仅供参考(最高只到 warn),需在 Wuji Studio 中用触觉热力图复核。重复设备 IP 与主机子网检查仅在发现 UDP 设备时运行;若设备均走 USB 或 Zenoh,两项显示 ~ 未尝试,且不会导致退出码 1。无诊断配方的设备显示 ~ connect & diagnose 节点,同样不导致退出码 1;连接或数据采集失败仍显示 ✘ 并返回 1。
JSON 输出顶层含 env(软件版本、系统、网络接口)与 device(Generic 发现项及各设备检查树)两个数组,仅在有内容时输出。
限制:当前支持的设备与故障类型、可用平台等信息以资料所述为准,其余暂未提供。