直连 Emporia Vue 智能电表数据，支持云端 API 与本地 ESPHome 双模式，实时获取家庭用电明细与分路监控。
说明：
## 核心用法
本技能提供两种模式查询 Emporia Vue 能源数据：
**云端模式（Cloud）**：通过 PyEmVue 库连接 Emporia 官方云服务，模拟 Home Assistant 集成方式。适合未刷机设备或追求简单配置的用户。需配置邮箱密码，支持按分钟/秒/15分钟/日/月粒度查询。
**本地模式（ESPHome）**：直连局域网内刷入 ESPHome 固件的设备，通过原生 API（端口 6053）获取数据。延迟更低、无需互联网，但要求设备已完成固件替换并配置 Noise PSK 加密密钥。
两种模式均支持三大命令：
– `list`：列出可用监测通道
– `summary`（默认）：输出总用电量及 TOP 分路排行
– `circuit `：查询指定分路实时数据
输出为结构化 JSON，包含时间戳、计量单位、总量估算及分路详情。
## 显著优点
1. **双栈灵活架构**：云端零门槛上手，本地模式满足隐私敏感与低延迟需求
2. **细粒度能源追踪**：支持秒级到月级的多尺度数据聚合
3. **分路级监控**：精准定位高耗电设备，辅助家庭能耗优化
4. **标准工具链**：纯 Python 实现，依赖 PyEmVue/ESPHome 社区成熟库
5. **跨平台兼容**：支持 macOS、Linux、Windows
## 潜在缺点与局限性
– **云端依赖**：Cloud 模式需持续互联网连接，受 Emporia 服务可用性制约
– **刷机门槛**：ESPHome 模式要求硬件改造能力，存在设备保修失效风险
– **密钥管理**：本地模式需妥善保管 base64 Noise PSK，配置复杂度显著提升
– **非官方集成**：PyEmVue 为社区逆向实现，API 变更可能导致功能中断
– **无控制功能**：只读查询，不支持继电器控制或阈值报警配置
## 适合人群
– 已部署 Emporia Vue 硬件的智能家居用户
– 希望将用电数据导入自定义看板/自动化流程的极客玩家
– 关注家庭能源账单优化、光伏自耗匹配的环保主义者
– 具备 ESPHome 刷机经验、追求数据本地化的隐私优先用户
## 常规风险
| 风险类型 | 说明 |
|———|——|
| 凭证泄露 | 邮箱密码、API 密钥需通过环境变量注入，避免硬编码或日志打印 |
| 网络暴露 | ESPHome 设备若未妥善隔离，端口 6053 可能成为内网攻击面 |
| 电气安全 | 技能明确禁止输出配电箱接线建议，硬件操作需由专业电工执行 |
| 数据精度 | “total” 字段为 best-effort 估算，不宜用于财务结算或法律举证 |
会员专属
