3.3 KiB
氢耗统计与导出口径修正
百公里氢耗使用修正用氢量（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条历史车辆日， 主用氢量与修正量字段一致，可计算比率均符合修正公式。