核心用法
nest-devices 是一个基于 Google Smart Device Management API 的智能家居控制技能，支持 Nest 温控器、摄像头和门铃设备的程序化操控。
基础功能
- 温控器控制：获取状态、设定温度（支持 °C/°F）、切换模式（HEAT/COOL/HEATCOOL/OFF）、启用节能模式
- 摄像头管理：生成 RTSP 实时流地址（有效期约 5 分钟）
- 设备枚举：列出关联的所有 Nest 设备及其 ID
实时事件推送（高级）
通过 Google Cloud Pub/Sub + Cloudflare Tunnel 实现门铃响铃、移动侦测、人员识别、声音检测等事件的即时 webhook 推送，无需轮询。
---
显著优点
1. 官方 API 支持：基于 Google 官方 Device Access API，协议稳定、功能完整
2. 多语言支持：提供 Python API 与命令行工具，便于集成到自动化工作流
3. 实时事件能力：Pub/Sub 架构支持真正的推送式通知，延迟低
4. 凭证管理灵活：支持 1Password 集成与环境变量两种安全存储方式
5. 温度参考表：内置节能/舒适/夜间等场景的温度建议
---
潜在缺点与局限性
| 问题 | 说明 |
|------|------|
| 准入门槛 | 需支付 $5 注册费，完成 Google Cloud 项目配置与 OAuth 流程 |
| 配置复杂 | 实时事件功能涉及 GCP Pub/Sub、Cloudflare Tunnel、systemd 服务，技术门槛较高 |
| 流地址时效 | 摄像头 RTSP 流仅 5 分钟有效期，需频繁刷新 |
| 设备兼容性 | 部分旧款 Nest 设备可能不支持全部 API 特性 |
| 依赖外部服务 | 事件推送依赖 Google Cloud 和 Cloudflare 的可用性 |
---
适合人群
- 智能家居爱好者：希望程序化控制 Nest 设备的技术用户
- 家庭自动化开发者：需要将温控/安防集成到自研系统的工程师
- 远程家庭管理者：需要实时接收门铃/异常事件通知的用户
- 节能优化用户：希望通过自动化调度降低能源消耗
---
常规风险
1. OAuth 凭证泄露：refresh_token 一旦泄露，攻击者可长期控制设备；建议使用 1Password 等加密存储
2. Webhook 暴露面：实时事件功能需暴露公网端点，需配置 CLAWDBOT_HOOKS_TOKEN 鉴权防止未授权访问
3. 云服务依赖：GCP 或 Cloudflare 服务中断将导致事件推送失败
4. 隐私合规：摄像头/门铃数据流经第三方云服务，需确保符合本地隐私法规