名称： emporia-energy
描述： 通过 Emporia 云端 (PyEmVue) 或本地 ESPHome API 直接查询 Emporia Vue 能源数据，包含云端与本地模式的选择/配置指导，以及运行列表/摘要/回路命令的说明。
元数据： {"moltbot":{"emoji":"⚡","os":["darwin","linux","win32"],"requires":{"bins":["python3"],"env":["EMPORIA_MODE"]}}}

Emporia 能源技能

使用 {baseDir}/scripts 目录下的脚本直接查询 Emporia Vue 数据。

通过 EMPORIA_MODE 选择模式：
- cloud：通过 PyEmVue 使用 Emporia 云端 API（类似于 Home Assistant 集成）
- esphome：使用本地 ESPHome API（适用于已刷写固件的设备）

选择模式（云端 vs 本地）

• 如果您的 Emporia 设备仍使用原厂固件，或希望采用最简单的设置，请选择云端模式。此模式需要 Emporia 账户凭据和互联网连接。
• 仅当设备已刷写 ESPHome 固件并位于您的局域网内时，才使用 esphome 模式。此模式需要设备 IP/主机名，并需在端口 6053 上启用原生 API 访问。

如果不确定设备是否已刷写 ESPHome，请选择云端模式。

环境变量

云端模式

• EMPORIA_EMAIL
• EMPORIA_PASSWORD

可选：
- EMPORIA_SCALE (MINUTE, SECOND, MINUTES_15, DAY, MONTH) - 默认为 MINUTE

ESPHome 模式

• ESPHOME_HOST
• ESPHOME_PORT（可选，默认 6053）
• ESPHOME_API_KEY（Noise PSK，base64 编码）或 ESPHOME_PASSWORD（旧式密码）

配置步骤

云端模式：
1. 设置 EMPORIA_MODE=cloud。
2. 设置 EMPORIA_EMAIL 和 EMPORIA_PASSWORD。
3. （可选）设置 EMPORIA_SCALE 以控制功率与能量单位。
4. 首先运行 list 确认通道，然后运行 summary 或 circuit <名称>。

ESPHome 模式：
1. 确保设备已刷写 ESPHome 固件并位于局域网内。
2. 设置 EMPORIA_MODE=esphome。
3. 设置 ESPHOME_HOST 为设备 IP/主机名（非 Home Assistant）。
4. 如果 ESPHome 节点启用了加密，请设置 ESPHOME_API_KEY（base64 编码的 Noise PSK）。
5. 首先运行 list 确认通道，然后运行 summary 或 circuit <名称>。

命令

脚本接受以下命令：
- summary（默认）
- list
- circuit <名称>

使用示例

云端模式：

export EMPORIA_MODE=cloud
export EMPORIA_EMAIL="you@example.com"
export EMPORIA_PASSWORD="..."
python {baseDir}/scripts/emporia_cloud.py summary

ESPHome 模式：

export EMPORIA_MODE=esphome
export ESPHOME_HOST="192.168.1.50"
export ESPHOME_API_KEY="base64-noise-psk"
python {baseDir}/scripts/emporia_esphome.py summary

依赖项（默认使用 pip）

云端模式：

python3 -m venv .venv
source .venv/bin/activate
pip install -r {baseDir}/requirements-cloud.txt

ESPHome 模式：

python3 -m venv .venv
source .venv/bin/activate
pip install -r {baseDir}/requirements-esphome.txt

可选：如果偏好，可以使用 uv 替代 pip。

输出

脚本输出 JSON 格式数据，包含：
- 时间戳
- 单位
- 总量（尽力而为）
- 主要回路
- 使用的通道

安全须知

• 切勿打印敏感信息（密码、令牌、密钥）。
• 请勿提供硬件或配电盘布线的建议。