beestat

🌡️ 智能恒温数据与空气质量管家

基于 Beestat API 的 ecobee 恒温器数据查询工具,支持温度、湿度、空气质量监测,助力智能家居环境管理。

收藏
3.5k
安装
786
版本
v0.1.0
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

Beestat 是一款专为 ecobee 智能恒温器用户设计的数据查询工具,通过集成 Beestat API,为用户提供全面的家庭环境数据监控能力。该 Skill 采用纯文档化设计,所有功能均通过调用外部 beestat-cli 命令行工具实现,支持查询实时温度、湿度、传感器状态、空气质量(CO2 和 VOC 浓度)以及 HVAC 系统运行时间等关键指标。

核心用法方面,用户需先在 beestat.io 注册账户并申请 API 密钥,通过环境变量配置后即可使用。支持 statussensorsair-qualitythermostatssummary 等子命令,涵盖从基础温度查询到能耗统计的完整数据视图。特别值得一提的是,所有命令均支持 --json 输出格式,便于开发者进行自动化脚本编写和数据集成。

显著优点包括:首先,纯文档架构确保零代码执行风险,所有操作均为只读查询,不会对恒温器设备造成误操作风险;其次,数据维度丰富,不仅包含基础温湿度,还提供专业的空气质量分级标准(CO2 和 VOC 浓度参考值),帮助用户科学评估室内环境;再者,使用门槛低,命令设计直观,配合详细的使用示例,即使是非技术用户也能快速上手。

然而,该 Skill 也存在一定局限性。作为社区维护项目(T3 来源),其长期维护稳定性不及官方工具;功能上仅限数据查询,不支持恒温器远程控制;且必须配合 ecobee Smart Thermostat Premium 等特定型号才能获取空气质量数据。此外,用户需通过邮件申请 API 密钥,流程相对繁琐。

适合的目标群体主要包括:已部署 ecobee 恒温器的智能家居用户、关注室内空气质量的健康敏感人群、需要进行能耗分析以优化电费支出的家庭,以及希望通过数据驱动改善居住环境的科技爱好者。

使用风险方面,需重点关注外部依赖安全性:用户需自行安装 npm 包 beestat-cli,建议锁定具体版本以避免供应链攻击;API 密钥 BEESTAT_API_KEY 需妥善保管,避免在共享环境变量中泄露;同时,thermostat 数据需传输至 Beestat 第三方服务器,对数据隐私有极高要求的用户需谨慎评估。

安全解读

核心功能与用法

Beestat CLI 是一款面向 ecobee 智能恒温器用户的命令行工具,通过 Beestat API 提供全方位的家居环境数据查询能力。该 Skill 采用纯 Markdown 文档形式,无可执行代码,本质上是标准化的 CLI 使用指南。

核心命令体系

| 命令 | 功能描述 | 典型场景 |
|:---|:---|:---|
| `beestat status` | 当前温度、湿度、设定值、室外天气 | "家里现在多少度?" |
| `beestat sensors` | 各房间传感器温度与 occupancy 状态 | "卧室有人吗?" |
| `beestat air-quality` / `aq` | CO₂、VOC 浓度及空气质量评分 | "室内空气质量如何?" |
| `beestat thermostats` | 设备型号、HVAC 系统详情 | 设备管理与故障排查 |
| `beestat summary --days N` | N 天 HVAC 运行历史统计 | "本周供暖用了多久?" |
| `beestat sync` | 强制与 ecobee 云端同步数据 | 数据异常时刷新 |

所有命令均支持 --json 输出,便于与 Home Assistant、Node-RED 等自动化平台集成。

显著优点

1. 数据维度丰富:相比 ecobee 官方 App 的基础展示,Beestat 提供历史运行时长分析、多传感器对比、空气质量趋势等专业级数据
2. 第三方生态兼容:JSON 输出格式支持与各类智能家居自动化工具链对接

3. 空气质量专业监测:针对 ecobee Smart Thermostat Premium 内置传感器,提供 CO₂(<800ppm 优秀)和 VOC(<0.5ppm 优秀)的分级参考标准

4. 零代码攻击面:纯文档型 Skill,无实际可执行逻辑,从根本上杜绝代码注入或恶意执行风险

局限性与注意事项

  • 硬件门槛:空气质量功能需 ecobee Smart Thermostat Premium 机型(内置传感器),基础版无法使用
  • API 获取繁琐:需邮件申请 API key,非即时自助流程
  • 数据延迟:依赖 ecobee 云端同步,极端情况下需手动 sync
  • T3 来源级别:由个人开发者(mjrussell)维护,虽功能明确但企业级支持有限
  • 许可证未声明:当前未明确开源协议,商业使用需谨慎

适合人群

  • ecobee 恒温器深度用户,尤其是 Premium 机型持有者
  • 关注室内空气质量(CO₂/VOC)的家庭用户
  • 需要将暖通数据接入自动化工作流的智能家居爱好者
  • 注重能耗分析与运行成本核算的理性消费者

常规风险提示

| 风险类型 | 等级 | 说明 |
|:---|:---|:---|
| API 密钥泄露 | 中 | `BEESTAT_API_KEY` 需妥善保管,建议定期轮换 |
| 数据隐私 | 低 | 仅传输至 beestat.io 官方服务,HTTPS 加密 |
| 功能依赖 | 低 | 完全依赖 ecobee 硬件与 Beestat 服务可用性 |
| 误判风险 | 低 | 空气质量分级标准为参考值,非医疗级诊断 |

> 安全认证结论:经 CLS-Certify v2.1.0 扫描,该 Skill 获 S 级(95分) 安全评级,满足全部安全要求,无危险代码、无敏感信息泄露、无恶意模式。

beestat 内容

手动下载zip · 1.4 kB
SKILL.mdtext/markdown
请选择文件