46 lines
3.3 KiB
Markdown
46 lines
3.3 KiB
Markdown
# 氢耗统计与导出口径修正
|
||
|
||
百公里氢耗使用修正用氢量（`soc_balanced_consumption_kg`）除以匹配里程乘以 100。
|
||
匹配里程延续既有口径：优先氢能统计的混动里程，否则使用日纯氢里程。
|
||
每日值、车辆区间合计和车队区间汇总均使用此口径；区间效率只计质量通过且有匹配里程的车辆日。
|
||
修正用氢量缺失时不回退物理用氢量，零里程不计算效率。
|
||
物理用氢量仍保留在 Excel 独立列及计算证据中。
|
||
|
||
Excel「氢能明细」增加当天所在省、市、大区、定位时间和位置状态。
|
||
省市取北京时间该日最后一个有效历史定位点，经现有服务端高德接口解析。
|
||
跨省、市行驶以该点归属为准，不表示全天仅在该行政区活动。
|
||
无当天有效定位时标记未知；历史位置或地址接口失败时终止导出并提示重试。
|
||
位置请求限制为三个并发，支持进度显示及取消。大范围导出会增加位置查询耗时。
|
||
|
||
大区采用七区划分：华东、华北、华中、华南、东北、西南、西北；西部未合并成“华西”。
|
||
直辖市的城市字段在解析接口未返回时使用直辖市名称。
|
||
|
||
本次无需数据库迁移或历史用氢重算，依赖已有修正用氢量、历史定位数据及高德服务配置。
|
||
已同时发布 API 和 Web，版本 `hydrogen-consumption-202609100956`。
|
||
保留上一版 `platform-performance-202609091012` 供回滚。
|
||
|
||
正式域名 https://vehicle.d.lnoneos.com 上抽查 200 条车辆日记录：149 条可计算，
|
||
全部符合修正口径，其中 146 条修正量与物理量不同；单车区间汇总核验通过。
|
||
当天历史位置和高德省市解析核验通过。API 服务 active，运行版本及二进制 SHA-256 与发布产物一致。
|
||
发布脚本的当前及兼容静态资源逐字节检查通过。
|
||
验收证据位于 `outputs/hydrogen-consumption-release-20260910/`。
|
||
|
||
|
||
## 2026-09-10 补充修复与线上交互验收
|
||
|
||
版本 `hydrogen-consumption-202609101134` 已发布，上一版 `hydrogen-consumption-202609100956` 保留。
|
||
上次仅统一日氢耗比率，日数据主字段 `hydrogenConsumptionKg` 仍为物理量；现改为修正量，
|
||
物理量通过 `hydrogenPhysicalConsumptionKg` 单独返回。计算证据主比率字段改为修正比率，
|
||
原物理比率通过 `physicalConsumptionKgPer100Km` 保留。客户权限过滤同时屏蔽新增物理量字段。
|
||
这些改动作用于历史查询，未改写原始物理计算证据。
|
||
|
||
氢耗视图导出现在以「氢能明细」作为第一张工作表，省、市、大区移至第3～5列；
|
||
文件名明确标为车辆氢耗明细。里程视图保留里程表在首位。
|
||
|
||
正式域名通过 Playwright + 已安装 Chrome 实际点击氢耗视图、导出 Excel，并用 ExcelJS 重新打开下载文件：
|
||
浙F09968F / 2026-09-01，修正量8.714kg，物理量12.813kg，匹配里程77km，
|
||
每日氢耗11.316883116883117kg/100km，地区为浙江省、嘉兴市、华东；首表、列序、数值断言通过。
|
||
桌面1440×1000页面正常、无运行时错误。未覆盖手机端导出及用户尚未提供的具体异常记录。
|
||
另外抽查2026-07-13、2026-08-11、2026-09-08各200条历史车辆日，
|
||
主用氢量与修正量字段一致，可计算比率均符合修正公式。
|