为什么值得关注

它整合 URE、DSO、OZE 和热电联产等官方来源，提供透明的价格构成和可靠缓存，并能同时对接 Home Assistant 与 openHAB。

适合谁使用

使用 TAURON、PGE、ENERGA、Stoen 或 ENEA 的 G11-G13 电价的波兰 Home Assistant 用户
需要通过 HTTP 或 MQTT 获取当前电价的 openHAB 用户
希望在 HA 能源面板中跟踪可变电费的家庭用户
希望参考按电价组感知的电价传感器实现的开发者

典型使用场景

在 HA 能源面板中显示当前 PLN/kWh 毛价作为实时电价实体
以独立 Docker 容器运行，通过 HTTP 和 retained MQTT 发布电价及分项
为仅提供外部统计数据而没有传感器实体的电表创建累计成本统计
查看能源、电网、质量、OZE、热电联产、消费税和 VAT 的毛价分解

项目优势

覆盖波兰五大配电运营商及多种 G11/G12/G13 电价组
整合 URE、DSO、BIP、ELI 等官方数据源，并在启用前验证文档完整性
既可通过 HACS 原生接入 Home Assistant，也可作为独立 Docker 服务供其他系统使用
提供详细的分项价格分解，并支持为外部电表数据建立成本统计桥接

使用前须知

内置费率仅覆盖到 2026 年；若新费率未发布或文档格式变化，传感器或容器配置文件将变为不可用
仅支持五大 OSD，并非覆盖所有波兰配电运营商
价格不含月度固定费用，如固定网络费、订阅费、交易费和家庭容量费

README 快速开始

Polish Energy Prices

Projekt oblicza bieżącą cenę brutto 1 kWh dla gospodarstw domowych przyłączonych do jednego z pięciu największych OSD: TAURON, PGE, ENERGA, Stoen i ENEA. Można go używać jako natywnej integracji Home Assistant albo jako niezależnej usługi Docker z HTTP i MQTT dla openHAB oraz innych systemów.

W Home Assistant encja ma jednostkę PLN/kWh i może zostać wskazana w panelu Energia jako encja z bieżącą ceną. Kontener publikuje tę samą cenę wraz ze składnikami przez API HTTP i retained MQTT.

Silnik łączy cenę energii czynnej sprzedawcy z urzędu z właściwym dla aktualnej godziny składnikiem sieciowym, opłatą jakościową, OZE, kogeneracyjną i VAT-em. Co 12 godzin sprawdza cenę sprzedaży energii oraz urzędowe źródła wszystkich zmiennych składników rachunku. Ostatni poprawny, kompletny zestaw jest zapisywany lokalnie; przy awarii źródła używany jest cache, a przy pierwszym uruchomieniu — zweryfikowane stawki wbudowane.

[!IMPORTANT] Stawki wbudowane są bezpiecznym punktem startowym na okres 1.01–31.12.2026, ale nie są już jedynym źródłem. Integracja wykrywa dokument na bieżący rok, sprawdza kompletność wszystkich stref i dopiero wtedy aktywuje nowy zestaw. Jeżeli nowa taryfa nie zostanie opublikowana albo zmieni się układ dokumentu, wygasły zestaw nie jest używany po swojej dacie końcowej. Sensor albo profil kontenera staje się niedostępny i pokazuje błąd źródła.

Docker, openHAB i inne systemy

Publiczny obraz działa na amd64 i arm64. Nie wymaga Home Assistanta ani logowania do GHCR:

ghcr.io/jchrzaniuk/polish-energy-prices:latest
ghcr.io/jchrzaniuk/polish-energy-prices:v1.5.0

Uruchomienie gotowego obrazu

Potrzebujesz Docker Engine z poleceniem docker compose oraz działającego brokera MQTT.

Pobierz repozytorium i przejdź do jego katalogu:

git clone https://github.com/jchrzaniuk/PolishEnergyPrices.git
cd PolishEnergyPrices

Utwórz własny plik konfiguracji:

cp service/config.example.yaml service/config.yaml

W service/config.yaml ustaw operatora, taryfę i źródło ceny. Zmień też mqtt.host z przykładowego mqtt na adres brokera widoczny z kontenera. W razie potrzeby wpisz użytkownika i hasło przez zmienne opisane w pełnej instrukcji usługi.
Uruchom kontener:
```
docker compose up -d
```

PolishEnergyPrices