fix: prevent tdengine raw frame overwrite

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

@@ -225,15 +225,23 @@ JT808 真实转发链路已验证：
 仓库提供 `tools/jt808_e2e_smoke.py`，用于重复验证 TCP `808` 到 TDengine history 的闭环：
 
 ```bash
+export TDENGINE_REST_URL='http://<tdengine-host>:6041/rest/sql/vehicle_ts'
+export TDENGINE_USERNAME='root'
+export TDENGINE_PASSWORD='<tdengine-password>'
+
 python3 tools/jt808_e2e_smoke.py \
+  --connection-mode session \
   --start-phone 13079962000 \
   --frames 3 \
   --expect-history-count 3 \
   --verify-pagination \
-  --archive-root "$PROJECT_ROOT/data/archive-jt808"
+  --archive-root "$PROJECT_ROOT/data/archive-jt808" \
+  --tdengine-rest-url "$TDENGINE_REST_URL" \
+  --tdengine-username "$TDENGINE_USERNAME" \
+  --tdengine-password "$TDENGINE_PASSWORD"
 ```
 
-默认 `--connection-mode per-frame`，适合稳定 smoke。需要暴露长连接连续帧边界时可切换 `--connection-mode session`。脚本会输出发送数量、history 可见数量、分页验证结果和 raw archive 检查结果。
+默认 `--connection-mode per-frame`，适合单帧连接 smoke。生产验收建议使用 `--connection-mode session` 覆盖同一连接内连续位置帧。脚本会输出发送数量、history 可见数量、分页验证结果、raw archive 检查结果和 `tdengineRawFrames`。`tdengineRawFrames` 表示本次可见位置记录中的唯一 `rawUri` 有多少个已确认写入 TDengine `raw_frames`。
 - 合成 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：
@@ -277,13 +285,29 @@ SELECT COUNT(*) FROM raw_frames
   WHERE protocol = 'GB32960' AND vin = 'LTEST202606290001';
 SELECT COUNT(*) FROM telemetry_fields
   WHERE protocol = 'GB32960' AND vin = 'LTEST202606290001';
-SELECT event_time, vin, raw_uri, raw_id
+SELECT event_time, vin, raw_uri, frame_id
   FROM raw_frames
   WHERE protocol = 'GB32960' AND vin = 'LTEST202606290001'
   ORDER BY event_time DESC
   LIMIT 5;
 ```
 
+也可以直接运行仓库 smoke 工具验证 TCP `32960`、history records、TDengine 字段、TDengine `raw_frames` 和 raw archive：
+
+```bash
+export TDENGINE_REST_URL='http://<tdengine-host>:6041/rest/sql/vehicle_ts'
+export TDENGINE_USERNAME='root'
+export TDENGINE_PASSWORD='<tdengine-password>'
+
+python3 tools/gb32960_e2e_smoke.py \
+  --archive-root "$PROJECT_ROOT/data/archive-jt808" \
+  --tdengine-rest-url "$TDENGINE_REST_URL" \
+  --tdengine-username "$TDENGINE_USERNAME" \
+  --tdengine-password "$TDENGINE_PASSWORD"
+```
+
+预期输出包含 `records >= 1`、`fieldCounts` 中关键字段均大于 0、`tdengineRawFrames` 等于本次可见唯一 `rawUri` 数量、`archiveChecked >= 1`。
+
 复查 API：
 
 ```bash