EVCC自定义电价插件配置优化指南

背景介绍

EVCC是一款优秀的电动汽车充电管理平台，其电价插件功能允许用户对接自定义的电价数据源。近期社区发现文档中的示例配置存在两个关键问题，可能导致电价显示异常。

问题分析

1. 字段名称不匹配：原示例使用price字段，实际系统要求使用value字段
2. 数值单位问题：电价数值需要以欧元/千瓦时为单位，原始数据可能需要除以100转换

正确配置方案

数据结构要求

有效的电价数据应遵循以下JSON格式：

[
  {
    "start": "2025-04-16T14:00:00Z",
    "end": "2025-04-16T15:00:00Z", 
    "value": 0.30
  },
  {
    "start": "2025-04-16T15:00:00Z",
    "end": "2025-04-16T16:00:00Z",
    "value": 0.22
  }
]

jq处理脚本修正

对于需要转换的数据源，建议使用以下jq处理脚本：

[.timestamps, .prices] | transpose | map({ 
  "start": (.[0] | strptime("%Y-%m-%dT%H:%M:%S.%f%z") | strftime("%Y-%m-%dT%H:%M:%SZ")), 
  "end": (.[0] | strptime("%Y-%m-%dT%H:%M:%S.%f%z") | mktime + 3600 | strftime("%Y-%m-%dT%H:%M:%SZ")), 
  "value": (.[1]/100) 
}) | tostring'

实现建议

1. 数据验证：建议先单独测试jq脚本的输出，确认格式正确
2. 单位确认：确认原始数据单位，必要时添加转换逻辑
3. 时区处理：注意时间戳的时区设置，确保与系统时区一致

典型问题排查

当电价显示为0.000时，建议检查：

1. 字段名称是否为"value"
2. 数值是否经过适当转换
3. 时间范围是否覆盖当前时段

该优化方案已合并到最新文档中，用户升级后即可获得正确的配置指引。