OTA 升级日志诊断

OTA 升级日志诊断

对整车 OTA 升级失败做根因定位。核心原则：脚本给证据，你给结论—— 不要逐行阅读原始日志（大文件会耗尽上下文），一律先跑解析脚本拿结构化证据链。 脚本负责解析、分类、聚合等确定性工作；根因裁决、批次成因假设、报告措辞是你的工作。

执行流程

第 0 步 · 输入判定

• 用户已上传日志文件 → 进入第 1 步。
• 用户只有口头描述 → 按以下清单引导取证，不要凭描述猜根因：
  1. 车端 UA 日志（车机工程模式导出，路径通常含 ota/ 或 swdl/）
  2. 云端调度侧该 VIN 的任务记录（campaign 平台导出）
  3. 失败时间点、车辆当时状态（电量／是否在充电／网络环境）
• 多台车 → 全部日志放同一目录，脚本支持批量（直接传目录路径）。

第 1 步 · 解析（必做）

python scripts/parse_logs.py <日志文件或目录> -o parsed.json

先看 stderr 的解析率统计：

• 解析率 < 60%：日志格式不匹配。查看文件前 20 行确认来源；若是管道分隔的 旧格式，用 --format-hint legacy 重试；仍失败则向用户确认日志来源， 不要试图自己写正则逐行解析大文件。
• 出现 UNPARSED_ERROR_LINES：这些行含 ERROR 但格式异常，用 view 只查看脚本指出的那几行（已给出文件名:行号），人工纳入证据。
• exit 1 且提示文件为空：向用户确认导出是否成功。

第 2 步 · 分类（必做）

python scripts/classify_failure.py parsed.json -o classified.json

产出：每车终态失败码 → 类别映射；车队级聚合（同码占比、批次性判定）。 若 stderr 出现 WARN: 未映射码，说明码表未覆盖该码——在报告中标注该码需