健康诊断
设备连不上或数据异常时，先跑 wuji doctor。它连接设备、采样实时数据（约 100 帧，数秒内完成），输出逐项体检的树形报告，把「为什么不工作」从猜测变成结论。
检测范围
当前支持检测的设备与故障类型：
- Wuji Glove
- EMF 断线检测：定位到具体手指，区分 RX（接收）与 TX（发射）故障
- 触觉传感器坏点/坏行/坏列检测
触觉检测需将手套静态放置，勿佩戴或按压，否则可能误报。
用法
wuji doctor # 诊断全部设备
wuji doctor --sn <SN> # 只诊断指定设备
wuji doctor -v # 显示全部检查项（默认隐藏通过项）
wuji doctor --json # 与树形报告同等信息的结构化输出读懂报告
$ wuji doctor
══════ Wuji Glove: WG1KXXXXXXXXXXX ══════
├─ ✔ EMF disconnect check: all 5 fingers normal
└─ ! tactile dead-pixel check: 0 dead pixels, 2 bad rows, 2 bad cols
├─ ! Bad rows: 2 bad row(s)
└─ ! Bad cols: 2 bad col(s)
Tip: Tactile check result is for reference only; verify via tactile heatmap in Wuji Studio- 状态标记：✔ 通过、! 警告（参考性提示）、✘ 失败（确定故障）、~ 跳过（检查无法执行，如采样数据无效）
- Tip: 行是修复建议
- 退出码：0 表示无失败项（警告不算失败），1 表示存在失败项或诊断无法完成，脚本可直接判定
- 触觉检查结果仅供参考（最高只到警告级），需要通过 Wuji Studio 中的触觉矩阵热力图验证
展开全部检查项
默认只显示异常项，-v 展开全部检查项（含通过项），看清到底查了什么：
$ wuji doctor -v
══════ Wuji Glove: WG1KXXXXXXXXXXX ══════
├─ ✔ EMF disconnect check: all 5 fingers normal
│ ├─ ✔ Thumb
│ ├─ ✔ Index
│ ├─ ✔ Middle
│ ├─ ✔ Ring
│ └─ ✔ Pinky
└─ ! tactile dead-pixel check: 0 dead pixels, 0 bad rows, 1 bad cols
├─ ✔ Thumb
├─ ✔ Index
├─ ✔ Middle
├─ ✔ Ring
├─ ✔ Pinky
├─ ✔ Palm
└─ ! Bad cols: 1 bad col(s)
Tip: Tactile check result is for reference only; verify via tactile heatmap in Wuji Studio结构化输出
--json 以机器可读形式输出与树形报告相同的检查结果（每个检查项一个节点，经 children 嵌套），便于保存和脚本处理：
wuji doctor --json > doctor-report.json