test: add jt808 e2e smoke verifier

docs/operations/vehicle-ingest-tdengine-verification.md

@@ -218,6 +218,21 @@ JT808 真实转发链路已验证：
 - `vehicle_locations` 中 `protocol='JT808'` 的位置行数已超过 `1900`。
 - `telemetry_fields` 中 `protocol='JT808'` 的字段行数已超过 `15000`。
 - 最新样例包含终端号 `13079963310`、消息 ID `512`、`archive://2026/06/29/JT808/...` 原始帧引用。
+
+## JT808 本机 smoke / 轻压测工具
+
+仓库提供 `tools/jt808_e2e_smoke.py`，用于重复验证 TCP `808` 到 TDengine history 的闭环：
+
+```bash
+python3 tools/jt808_e2e_smoke.py \
+  --start-phone 13079962000 \
+  --frames 3 \
+  --expect-history-count 3 \
+  --verify-pagination \
+  --archive-root "$PROJECT_ROOT/data/archive-jt808"
+```
+
+默认 `--connection-mode per-frame`，适合稳定 smoke。需要暴露长连接连续帧边界时可切换 `--connection-mode session`。脚本会输出发送数量、history 可见数量、分页验证结果和 raw archive 检查结果。
 - 合成 0x0100 注册帧终端号 `13079969999` 已验证：TCP `808` 返回 `0x8100` 注册 ACK，`raw_frames.metadata_json` 包含 `jt808.register.province`、`jt808.register.city`、`jt808.register.maker`、`jt808.register.deviceType`、`jt808.register.deviceId`、`jt808.register.plateColor`、`jt808.register.plate`，对应 raw archive 文件存在。
 
 复查 SQL：