用途：读取并分析 Arduino 或嵌入式设备的串口输出，进行结构化运行时调试，兼容 Arduino IDE、Arduino CLI、PlatformIO 及厂商监视器。
主要能力：实时串口监控；带时间戳保存日志；按关键字、正则或数据类型过滤；自动高亮常见错误与警告；支持文本、JSON、CSV、二进制等格式；跨 Windows、macOS、Linux。推荐在代码中使用固定字段的事件格式，如 t_ms、level、event、value。
使用方式：需 Python 3.8+ 与 uv 0.4+，脚本内联声明 pyserial 和 colorama。基本监控： uv run --no-project scripts/monitor_serial.py --port COM3 指定波特率与输出文件： uv run --no-project scripts/monitor_serial.py --port /dev/ttyACM0 --baud 115200 --output debug.log 正则过滤： uv run --no-project scripts/monitor_serial.py --port COM3 --filter "ERROR|WARNING" JSON 解析：--format json --pretty；时间戳与彩色输出：--timestamp --color；错误检测：--detect-errors。可与 Arduino CLI 配合：先 arduino-cli compile/upload，再监控串口。脚本帮助：uv run --no-project scripts/monitor_serial.py --help。
适用场景：内存问题、传感器数据验证、时序分析、通信错误排查等。建议先保存未过滤日志，保留首次启动行、复位/掉电/看门狗消息及复现症状的转变点；结论按构建、上传、硬件、系统或部署证据标注。
限制与安全：干净的串口流不能证明引脚、电源或整个系统正确；需记录板卡/版本、固件/镜像标识、工具链版本、端口、波特率和复位原因。日志不得包含 Wi-Fi 密码、API 密钥、证书、令牌或隐私数据。Linux/macOS 权限问题可将用户加入 dialout 组：sudo usermod -a -G dialout $USER，然后重新登录。