EVCC项目中的电价数据格式变更解析

在EVCC智能充电管理系统的v0.203.0版本更新中，开发团队对自定义电价数据源的JSON格式进行了重要调整。这一变更影响了使用HTTP自定义接口获取电价数据的用户配置。

变更背景

EVCC作为一款开源的家庭能源管理系统，允许用户通过多种方式获取电价信息。在早期版本中，自定义电价接口返回的JSON数据使用"price"字段表示电价数值。但从v0.203.0开始，系统统一改为使用"value"字段作为标准字段名。

具体变更内容

在配置文件中，原先使用"price"字段的JQ查询语法需要更新为使用"value"字段。例如：

grid:    
  type: custom
  forecast:
    source: http
    uri: http://192.168.x.xxx:1880/endpoint/price
    jq: '[.timestamps, .prices] | transpose | map({ "start": ..., "end": ..., "price": .[1] })'

需要修改为：

    jq: '[.timestamps, .prices] | transpose | map({ "start": ..., "end": ..., "value": .[1] })'

影响范围

这一变更主要影响以下用户：

1. 使用自定义HTTP接口获取电价数据的用户
2. 在配置文件中明确指定了"price"字段的JQ查询语法的用户
3. 使用v0.203.0及以上版本的用户

解决方案

对于遇到电价数据显示问题的用户，检查并更新配置文件中的JQ查询语法是首要步骤。确保所有返回电价数值的字段名都使用"value"而非"price"。

技术建议

1. 在升级EVCC版本前，建议先查阅版本变更日志
2. 对于复杂的JQ查询语法，可以使用在线JQ测试工具验证语法正确性
3. 考虑在Node-RED等中间件中对API返回的数据进行预处理，统一字段名

总结

这一变更是EVCC项目标准化进程的一部分，旨在提高代码的一致性和可维护性。虽然会给部分用户带来短暂的适配工作，但从长远看有利于系统的稳定性和扩展性。用户在遇到类似问题时，应首先考虑检查版本变更说明，确认是否有相关接口调整。