V2.0.4 周报 — 车检器测试工装项目

报告周期：2026年6月1日 ~ 6月5日
项目：vd_test_fixture（车检器自动化测试工装）
作者：wangfq

一、概述

本周完成 V2.0.3 波动测试模式全链路实现、继电器状态存储重构、测试操作/信息页面多项增强，以及若干关键 Bug 修复。共提交 24 个 commits（主仓库 19 + edc_server 子模块 4 + edc-web 1）。

模块	变更
`dg430.py`	新增 `DG430WaveStatus` dataclass、`parse_b4_wave_status()` 解析器；扩展 `DG430FixtureParams` + `parse_4c_params()` 支持 6 个新字段
`models.py`	DDL 增加 10 个新列（test_mode、data_source、remain_count、work_freq、b4_enter_dist 等）；新增 `insert_wave_data()` 存库函数；ALTER TABLE 自动迁移逻辑
`handlers.py`	parse_loop 增加 0xB4 分支，波动数据路由入库；0x4C 处理传递新参数字段

tb_state_tst 新增 relay_code TINYINT 列，存储原始 hex 值
- 0x00 = 无输出，0x01 = 存在信号，0x02 = 脉冲信号，0x03 = 存在+脉冲
relay_out VARCHAR 列保留，兼容历史数据
B2/B4 解析后直接以 int 值写入 relay_code

功能	说明
自动化间隔/超时	新增间隔时间（秒）和超时时间（秒）参数；重写为状态机驱动，收到回复后等待间隔再发下一条，超时立即发下一条
渲染容错	每个 render 调用独立 try-catch，避免一处报错级联导致全部数据显示失败
初始数据加载	页面打开时自动请求最新测试数据，无需等待启动自动化
时间格式统一	所有区域统一显示 `yyyy-MM-dd HH:mm:ss`，修复 Flask jsonify "GMT" 导致的 UTC+8 时区偏移

功能	说明
三视图标签页	全部 / 灵敏度测试 (B2) / 波动测试 (B4)，独立列布局
ECharts 图表	表格/图表一键切换，B2 显示 8 条线（峰峰值/频率/距离/速度），B4 显示 7+1 条线（含继电器），三 Y 轴，dataZoom 缩放，保存为 2x PNG
分页条数	搜索栏增加「每页：20/50/100」下拉框
Admin 删除	仅 admin 可见，按设备编码/日期范围/数据来源筛选删除，确认框防误删，`tb_log` 留痕

问题	根因	修复
FarStay 字段长度	用户纠正：NearStay 和 FarStay 均为 2 字节	全量回退 1 字节改动，恢复协议+代码 2 字节设计
数据库缺列	旧表缺少 V2.0.3 新增字段	服务启动时 ALTER TABLE ADD COLUMN IF NOT EXISTS 自动迁移
时间显示偏移 8 小时	Flask jsonify 给本地时间加 "GMT" 后缀，JS 误当 UTC 解析	`fmtTime()` 先 strip "GMT" 再解析
测试操作三个数据区不显示	pollProgress 共用一个 try-catch，一处报错跳过后续渲染；全部完成时 return 跳过最终渲染	独立 try-catch；渲染代码移到 return 之前
自动化平均值/明细不显示	同上（渲染代码在 return 之后）	同上

主仓库（vd_test_fixture）：19 commits
子模块（edc_server）：4 commits
合计：23 commits

日期	主题
6/1	培训手册 V1.0、精简 requirements.txt
6/2	DG430 V2.0.3 协议文档、后端实现、前端同步、ALTER TABLE 迁移
6/3	FarStay 字节修正、波动测试前端适配、三视图重构
6/4	自动化间隔/超时、协议文档补充灵敏度流程
6/5	时间格式化、分页条数、ECharts 图表、图表保存图片、admin 删除、继电器重构、时区修复、渲染容错、图表继电器系列