串口助手补残行封顶与会话边界复位、截头按行对齐、open 保持 dtr/rts；判定加命中行/顺序/耗时/JSON 与产物清理

tools/serial_tool/README.md

@@ -16,18 +16,24 @@
 ## 使用方式
 
 ```bash
-# 启动 daemon / 打开串口
-& '.venv\Scripts\python.exe' tools/serial_tool/serial_tool.py open COM6
+# 打开串口（daemon 自动拉起；端口缺省取 .opencode/serial_config.json，不必带参数）
+& '.venv\Scripts\python.exe' tools/serial_tool/serial_tool.py open
 
-# 查询日志 / 发送命令
-& '.venv\Scripts\python.exe' tools/serial_tool/serial_tool.py tail
+# 看有哪些口 / 配置口是否还在位（单一候选时回 hint）
+& '.venv\Scripts\python.exe' tools/serial_tool/serial_tool.py ports
+
+# 读日志（先过滤后截尾）/ 发送 / 等静默
+& '.venv\Scripts\python.exe' tools/serial_tool/serial_tool.py log --tail 50 --grep "App init OK"
 & '.venv\Scripts\python.exe' tools/serial_tool/serial_tool.py send "<命令>"
+& '.venv\Scripts\python.exe' tools/serial_tool/serial_tool.py wait-idle --settle-ms 8000 --max-ms 30000
 
-# 关闭
+# 状态 / 关闭
+& '.venv\Scripts\python.exe' tools/serial_tool/serial_tool.py status
 & '.venv\Scripts\python.exe' tools/serial_tool/serial_tool.py close
 ```
 
-> 具体子命令以 `--help` 为准。
+> 全部命令输出 JSON、退出码 0/1/2/3；具体子命令以 `--help` 为准。
+> 抓开机日志的顺序是 `open` → `clear` → 烧录/复位 → `wait-idle` → 读日志（采集必须先于烧录）。
 
 ## ⚠️ 注意