用途：排查嵌入式系统的 USB 问题，覆盖枚举失败、描述符异常、CDC/REPL 端口缺失以及间歇性断连等场景。适用于涉及 USB 设备未出现、接口错误、端口名变化等请求。
主要能力：将源码/构建、设备和物理证据分开记录；识别连接器、支持数据的线缆、供电路径、原生 USB 控制器与 UART 桥接的差异、VID/PID、接口、串口身份和主机操作系统；记录事件前后的枚举状态（端口名变化不一定代表不同物理板）；区分无电气连接、枚举失败、缺少驱动/接口、端口占用和应用协议问题；在公开报告中脱敏凭据和私有序列号。
使用方式：先阅读共享的嵌入式约定和 USB 诊断说明，再进行排查。依据具体板设计检查 D+/D- 接线、时钟/PHY/VBUS 预期和外部供电。在进入选定的 REPL/调试会话前关闭冲突的串口监视器。USB 堆栈配置使用对应平台技能。交付证据止步的层级、可复现的主机检查和下一步针对性测试。
限制：MicroPython 原始 REPL 和自动复位工具可能改变运行时状态；原生 USB 可能在复位、断点暂停或固件重配置期间消失，而 UART 桥接在 MCU 停止时仍保持枚举。不要为修复未明确定位的传输症状而擦除固件或任意重装驱动。源过程不代表所有目标均已测试，具体测试组合见平台覆盖说明。