SuperAPI AI 工具集

nest-devices

通用与其它

查看项目

更新于 10-16 06:15

技能介绍

用途:通过 Google 的 Smart Device Management(SDM)API 控制 Nest 智能家居设备,包括恒温器、摄像头和门铃。

主要能力:列出设备;读取恒温器状态;设置目标温度(摄氏度或华氏度)与运行模式(HEAT、COOL、HEATCOOL、OFF);设置节能模式(如 MANUAL_ECO);为摄像头生成约 5 分钟有效的 RTSP 直播流地址;通过 Google Cloud Pub/Sub 加 Webhook 接收门铃按铃、检测到人物、移动、声音、片段预览等实时事件,其中门铃与人物事件会附带图片推送到 Telegram,移动与声音事件仅记录。

使用方式:需先在 Google Cloud 创建项目并支付 5 美元费用,在 Device Access 控制台创建项目、建立 OAuth 2.0 凭据(Web 应用类型,重定向 URI 为 https://www.google.com),将 Nest 账号关联项目,再走 OAuth 流程获取 refresh token。凭据可存入 1Password 或环境变量(NEST_PROJECT_ID、NEST_CLIENT_ID、NEST_CLIENT_SECRET、NEST_REFRESH_TOKEN)。常用命令包括:python3 scripts/nest.py list;python3 scripts/nest.py get <device_id>;python3 scripts/nest.py set-temp <device_id> 21 --unit c --type heat;python3 scripts/nest.py set-mode <device_id> HEAT;python3 scripts/nest.py set-eco <device_id> MANUAL_ECO;python3 scripts/nest.py stream <device_id>。也可使用 Python API:from nest import NestClient,调用 list_devices、set_heat_temperature、set_thermostat_mode、set_eco_mode、generate_stream 等方法。实时事件需在 Google Cloud 创建 Pub/Sub 主题并授权 SDM 发布、在 Device Access 控制台绑定主题、用 Cloudflare Tunnel 暴露 Webhook 服务、创建推送订阅,并配置 THINKFLEET_GATEWAY_URL、THINKFLEET_HOOKS_TOKEN、OP_SVC_ACCT_TOKEN、TELEGRAM_BOT_TOKEN、TELEGRAM_CHAT_ID、PORT 等环境变量。

限制:摄像头事件图片约 5 分钟后过期,此时回退用 ffmpeg 抓取 RTSP 当前帧;实时事件必须完成 Pub/Sub 配置;无 Cloudflare 账号的快速隧道不保证在线率;部分较旧的 Nest 设备可能不支持全部功能;超过 5 分钟的过期事件只记录不告警,移动与声音事件有意不告警以避免通知疲劳。