安装失败

确认 Python ≥3.10，并让 qnbot-sdk-exo==1.0.0 与 qnbot-sdk-core==1.4.0 配套。运行 python -m pip check 检查冲突。

找不到设备

运行 discover_exos()，确认串口未被上位机或其他进程占用。多台设备同时连接时不要使用无条件自动发现，应固定 port。

没有数据

确认已经调用 exo.start()，运行器仍在推进，并保持订阅对象存活。再检查 get_device_info().capabilities.telemetry 和 device.health()。

控制失败

ExoControlError 提供 kind、command、device_code 和 detail。震动前检查 capabilities.haptics，并保证至少一侧强度位于 0…100。

资源已关闭

父级 Exo 或 Sdk 关闭后，旧 ExoDevice 和通道不能复用；重新创建完整对象树。