ha-energy 是一个 Home Assistant 能源监控配置技能，用于搭建能源监控仪表盘，并支持太阳能、电网与设备层面的能源追踪。它主要面向需要配置能源传感器、公用事业计量表、统计信息的使用者。
用途 该技能用于配置 Home Assistant 的能源监控，包括能源传感器、计费周期计量、统计记录以及能源仪表盘集成。据资料说明，它可预防 8 类常见错误并节省约 45% 的 token 消耗，并给出配置时间、常见错误数量、token 用量三组对比指标。
主要能力 资料列出的能力包括：配置能源传感器模板；设置 utility_meter 以按计费周期追踪能耗；启用统计记录器（recorder）；处理电网双向监测（分别建立 consumption 与 return 传感器）；太阳能与电池充放电追踪；通过 Riemann sum 将功率（W）转换为能量（kWh）；设备功率监控（智能插座）等。技能附带 references/ 参考文件（如 state-class-guide.md、device-class-reference.md、utility-meter-patterns.md、energy-dashboard-setup.md、solar-integration.md）与 assets/ 模板文件（如 energy-sensors-template.yaml、utility-meter-examples.yaml、energy-dashboard-card.yaml）。
使用方式 资料以 YAML 配置示例展示三步快速入门：第一步在 configuration.yaml 中通过 template 集成配置能源传感器，指定 unit_of_measurement、device_class: energy、state_class: total_increasing 等；第二步配置 utility_meter，设置 source、cycle（daily/monthly 等）与 offset；第三步配置 recorder 的 include 列表以启用统计。技能还提供 Context7 库 ID 与官方文档入口用于查阅最新文档，并给出常见故障的排查步骤。
适用场景 适用于配置能源传感器、公用事业计量表、统计信息，以及搭建含太阳能、电网、电池、独立设备的能源仪表盘。资料中的常见模式包括电网监测（consumption + return）、太阳能与电池、智能插座设备用能监控。
限制与注意事项 资料强调的关键规则包括：累积电表使用 state_class: total_increasing；所有能源传感器加入 device_class: energy；设置 unit_of_measurement: kWh；配置 utility_meter 计费周期；将能源传感器加入 recorder include 列表；电网消耗与回馈使用独立传感器等。需避免：对累积电表使用 measurement、遗漏 utility_meter 的 offset、在未做 Riemann 积分的情况下混用功率（W）与能量（kWh）传感器、在单个传感器上配置双向流动、使用已弃用的 template platform。使用前需满足的前置条件（如 Home Assistant 版本、配置访问方式、传感器可用性等）已在资料中给出检查清单，部分细节请以资料原文为准。