名称： beestat
描述： 通过 Beestat API 查询 ecobee 恒温器数据，包括温度、湿度、空气质量（CO2、VOC）、传感器状态和 HVAC 运行时间。当用户询问家庭温度、恒温器状态、空气质量或供暖/制冷使用情况时使用。
主页： https://beestat.io
元数据：
clawdbot:
emoji: "🌡️"
requires:
bins: ["beestat"]
env: ["BEESTAT_API_KEY"]

Beestat CLI

用于访问 Beestat API（ecobee 恒温器数据分析）的命令行工具。可查询温度、湿度、空气质量及 HVAC 运行时间。

安装

npm install -g beestat-cli

设置

1. 在 beestat.io 创建账户并关联您的 ecobee 设备
2. 将恒温器序列号通过邮件发送至 contact@beestat.io 以获取 API 密钥
3. 设置环境变量：export BEESTAT_API_KEY="您的密钥"

命令

状态查询

beestat status             # 当前温度、湿度、设定值及天气
beestat status --json

传感器信息

beestat sensors            # 所有传感器的温度与占用状态
beestat sensors --json

空气质量

beestat air-quality        # CO2、VOC 及空气质量评分
beestat aq                 # 快捷别名
beestat aq --json

需要 ecobee Smart Thermostat Premium 型号（内置空气质量传感器）。

CO2 等级参考：
- < 800 ppm：优
- 800-1000 ppm：良
- 1000-1500 ppm：中（建议通风）
- > 1500 ppm：高（需立即通风！）

VOC 等级参考：
- < 0.5 ppm：优
- 0.5-1.0 ppm：良
- 1.0-3.0 ppm：中
- > 3.0 ppm：高

恒温器信息

beestat thermostats        # 型号信息与 HVAC 详情
beestat thermostats --json

运行时间汇总

beestat summary            # 运行历史（默认最近 7 天）
beestat summary --days 14  # 最近 14 天数据
beestat summary --json

强制同步

beestat sync               # 强制与 ecobee 同步数据

使用示例

用户：“家里现在温度多少？”

beestat status

用户：“空气质量还好吗？”

beestat aq

用户：“卧室里有人吗？”

beestat sensors

用户：“这周开了多久暖气？”

beestat summary --days 7

用户：“我们有哪些恒温器？”

beestat thermostats

注意事项

• 空气质量数据来源于 ecobee 运行记录，而非传感器实时能力
• 所有命令均支持 --json 参数，便于脚本与自动化处理
• 若数据更新延迟，可使用 beestat sync 强制同步