用途
serial-monitor 用于嵌入式开发场景下的串口监视与日志分析。当用户需要查看目标板的启动日志、断言输出或交互式 UART 输出，或者在烧录或复位刚完成后需要观察运行期行为时，可以使用该工具。它也适用于需要避免错过早期启动日志，或希望在监听后立即复位目标板的情况。使用前提是工作区或 profile 中已经有明确的 UART 端口或波特率。
主要能力
- 串口自动探测：串口选择优先级为显式用户输入、Project Profile、脚本自动检测结果，否则阻塞。自动检测时优先选择 CH340、CP210x、CMSIS-DAP、ST-Link 等常见串口或调试器虚拟串口。若存在多个同样合理的串口候选，会先列出候选并按需阻塞，而不是静默猜测。
- 波特率探测：波特率优先级为显式用户输入、Project Profile、工作区文档或代码常量，最后回落到 115200。
- 多种抓取模式：支持列表、抓取、等待字符串、持续监视以及“先监听后复位”等模式。
- 日志分析：读取脚本输出的分析结果，重点关注错误、警告、启动标记和关键外设关键词，而不仅是转述原始串口文本。
- 跨平台支持：Linux、macOS、Windows 的串口命名规则复用 platform-compatibility.md，自带脚本使用 pyserial，串口抓取路径本身跨平台。
使用方式
必要输入包括：一个串口，或一份足以完成串口探测的 Project Profile；可选的波特率、监视模式、关键字符串、日志保存路径；若要自动复位，还需要 OpenOCD 配置。
执行步骤：
- 先阅读 references/usage.md，确认本次是列表、抓取、等待字符串、持续监视，还是“先监听后复位”。
- 运行自带脚本 scripts/serial_monitor.py。列出串口时使用 --list，自动选择端口时使用 --auto。
- 普通抓取使用 --duration，等待特定输出使用 --wait，持续监视使用 --monitor --timestamp。
- 若担心错过早期启动日志，使用 --wait-reset；只有在 OpenOCD 配置已经明确时，才启用 --auto-reset。
- 读取脚本输出的分析结果，将选中的串口、波特率、命令和日志结论写回 Project Profile，并在需要时交给下游 skill。
Windows 输出中要保留准确的 COM 端口名，以及 shell 需要的命令行引号形式。
适用场景
- 查看目标板启动日志、断言输出或交互式 UART 输出。
- 烧录或复位完成后观察运行期行为。
- 避免错过早期启动日志，或在监听后立即复位目标板。
- 工作区或 profile 中已有明确 UART 端口或波特率。
失败分流
- 缺少 pyserial 或 openocd 等依赖时，返回 environment-missing。
- 选中的串口无法打开或在监视过程中消失时，返回 connection-failure。
- 宿主机没有权限访问串口设备时，返回 permission-problem。
- 存在多个合理串口候选，或工作区中隐含互相冲突的波特率时，返回 ambiguous-context。
- 串口可访问但日志明显表现为启动失败、重复复位、断言或 Fault 时，返回 target-response-abnormal。
输出约定
输出选中的串口、波特率、实际执行命令，以及对日志分析结果的简洁总结。当串口和波特率被明确后，用 serial_port 和 baud_rate 更新 Project Profile。若使用了 --auto-reset，同时记录 OpenOCD 配置来源和复位命令。当日志表明程序崩溃、卡死或启动异常时，推荐 debug-gdb-openocd。
交接关系
当日志显示需要断点、寄存器或回溯时，将结果交给 debug-gdb-openocd。
限制
关于收费、价格、具体平台支持细节、效果保证等信息暂未提供。