企业官网建设流程全解析

Helios 是 Home Assistant 的 2.5D 能量可视化 Lovelace 卡片，它的**成本芯片（cost chip）**能实时告诉你"这一小时家里在烧多少钱"：正数表示正在花钱买电，负数表示卖电赚钱，还能拖动时间轴回看任意时刻的电费速率。本文带你弄懂这个电费芯片的数据来源、双通道计算原理，以及如何三步开启它。

成本芯片长什么样，用在哪

成本芯片位于卡片角落的芯片区，显示格式为数值 + 货币 + /h（每小时速率），例如1.42 €/h或-0.35 €/h：

• 正数：此刻你家正在净花钱买电
• 负数：此刻你家正在净赚——光伏卖出的电比买进的贵

它支持三种玩法：

核心规则：实测或隐藏，绝不估算

Helios 成本芯片的第一原则是：你的能量面板没配置价格，芯片就不出现，宁缺毋假。它从不拿累计电表"估算"一个当下的价格，也从不自己编造电费数字。

这正是 cost.ts 开头注释写死的规则："Nothing is shown unless cost is configured in the Energy dashboard — measured or absent, never invented"。

开启技巧：先给能量面板配价格

Helios不需要为成本芯片单独填实体——它自动读取你已配置好的 Home Assistant 能量面板 全局设置。所以开启步骤其实是：

第 1 步：在 HA 能量页配置电网价格

进入设置 → 仪表板 → 能量，编辑电网源（Grid），为"从电网购买"的流添加价格，四种方式任选：

第 2 步：确认芯片开关

show-cost选项默认开启，配好价格后芯片自动出现。如需隐藏，在编辑器中关闭即可，参考 docs/CONFIGURATION.md 的 Data display 与 Weather 章节。

第 3 步：看效果

刷新卡片，角落出现x.xx €/h的成本芯片。点击它，就能看到当日花费、赚取、净额与日均的明细面板（detail-panel.ts）。

工作原理：双通道计算 + 新鲜度把关

成本速率的计算逻辑在 refreshCostLive 中，分两条通道，优先级明确：

通道一（优先）：HA 官方成本统计读取能量面板配置的stat_cost（买入花费）与stat_compensation（卖出补偿）统计，速率 = 单位时间内的金额增量。多电价套餐（Tempo、峰谷分时、总成本积分传感器）只走这条路——因为把几个时段的电价"平均"会给当下错误定价。

通道二（回退）：单价 × 实时功率只配置了单一价格（一个实体或一个固定数字）时，直接用价格 × 实时买电功率 − 卖电价格 × 卖电功率，精确且零延迟，见 singlePrice。

新鲜度把关：如果成本统计的最新数据桶太旧（比如某集成在补昨天的账），latestCostRate 会拒绝把它当"现在"，转而回退到价格通道或干脆隐藏——避免把 16 小时前的旧数据渲染成实时速率。对于低频上报的电表（如 15 分钟报一次），它还会按电表自身的上报节奏把最后一次读数摊平到其覆盖区间，保证芯片不"卡"在过时的值上。

多电表、多电池组的解析规则集中在 energy-prefs.ts，架构层面的说明见 ARCHITECTURE.md。

常见问题排查

小结

• 成本芯片零额外配置：能量面板配了价格，它自动出现
• 正数花钱、负数赚钱，单位是每小时净现金流
• 多电价套餐由 HA 官方成本统计驱动，固定单价走"价格 × 功率"直算
• 拖时间轴可回看历史任意时刻的电费速率，点击芯片看花费/赚取/净额明细

配好电价，让每一度电的花费都看得见——这就是 Helios 成本芯片的全部秘密。