# tools/serial_tool/ — Python 串口助手

> **常驻 daemon + CLI** 架构的串口工具：后台持续收串口日志，CLI 按需查询/发送，
> 避免反复开关串口导致日志丢失（台架与测试的主力观测工具）。

## 文件一览

| 文件/目录 | 作用 |
|---|---|
| `serial_tool.py` | 串口助手主程序（daemon 与 CLI 合一） |
| `state/` | **运行时状态目录** |
| `state/serial.log` | 串口原始日志（`stack_report.py -s` 的输入之一） |
| `state/daemon.log` | daemon 自身运行日志 |
| `state/meta.json` | daemon 元数据（端口、状态等） |

## 使用方式

```bash
# 启动 daemon / 打开串口
& '.venv\Scripts\python.exe' tools/serial_tool/serial_tool.py open COM6

# 查询日志 / 发送命令
& '.venv\Scripts\python.exe' tools/serial_tool/serial_tool.py tail
& '.venv\Scripts\python.exe' tools/serial_tool/serial_tool.py send "<命令>"

# 关闭
& '.venv\Scripts\python.exe' tools/serial_tool/serial_tool.py close
```

> 具体子命令以 `--help` 为准。

## ⚠️ 注意

- **单写者**：串口同一时刻只能被一个进程占用——别同时用本工具和其它串口程序
- `state/serial.log` 是 `[STACK]` 运行时水位的来源，`scripts/stack_report.py -s` 直接读它
- `state/` 是运行时数据，**不入库**

## 相关文档

- `docs/测试说明/串口助手使用指南.md` — 命令用法 / 工作流 / 排障
- `docs/测试说明/串口助手设计说明.md` — 契约 / daemon 行为 / 陷阱