通过 Starling Home Hub 的本地 REST API 控制 Nest 和 Google Home 智能家居设备。支持恒温器、摄像头、Nest Protect、Nest × Yale 门锁、温度传感器、在家/外出控制及天气服务。用于管理设备状态、设置温度、获取摄像头快照、开关门锁、检查烟雾/一氧化碳警报及切换在家/外出模式。
Starling Home Hub(Nest/Google Home). community help – 不隶属于或认可 Starling LLC, Goog
功能概述
Starling Home Hub(Nest/Google Home). community help – 不隶属于或认可 Starling LLC, Goog是一项面向实际任务的技能，主要用于Nest 是Google LLC的商标.；Starling Home Hub 是产品.。
核心要点
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
- 使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
- 从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
使用与执行
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；
结果检查与注意事项
涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。
Starling Home Hub（Nest / Google Home）
社区技能 — 与 Starling LLC、Google、Nest 或 Apple 无任何关联，亦未获其认可或授权。 Nest 是 Google LLC 的商标。Starling Home Hub 是 Starling LLC 的产品。本技能需搭配固件版本 8.0 及以上、且已启用 Developer Connect API 的 Starling Home Hub 使用。
概述
通过 starling.sh 脚本，利用 Starling Home Hub Developer Connect（SDC）本地 REST API 控制 Nest 智能家居设备。
必需的环境变量
| 变量 | 是否必需 | 是否为密钥 | 说明 |
|---|---|---|---|
STARLING_HUB_IP |
是 | 否 | 您的 Starling Home Hub 的本地 IP 地址（例如：192.168.1.151） |
STARLING_API_KEY |
是 | 是 | 在 Starling Home Hub 应用（Developer Connect 设置页）中创建的 API 密钥 |
配置方法
请设置以下环境变量（切勿在脚本中硬编码密钥）：
export STARLING_HUB_IP="192.168.1.xxx" export STARLING_API_KEY="your-api-key" # 来自 Starling Home Hub 应用
脚本路径为：scripts/starling.sh
可选参数：--http（降级使用 HTTP — 不推荐），--raw（跳过 jq 格式化输出）
HTTPS 为默认协议。 除非显式指定 --http，否则脚本默认使用端口 3443。
安全性
API 密钥管理
- 始终通过
STARLING_API_KEY环境变量传入密钥 — 切勿使用--key参数传递（该方式会使密钥出现在ps进程列表中） - 切勿将密钥写入脚本、SKILL.md 或任何受版本控制的文件中
- 建议使用权限受限的
.env文件：执行chmod 600 .env - 生产环境或自动化部署场景下，建议使用专用密钥管理服务
最小权限原则
- 在 Starling Home Hub 应用中创建 API 密钥时，请仅授予完成任务所必需的最低权限
- 如无需设置属性或访问摄像头流媒体，请优先使用 只读密钥
- 若条件允许，建议为不同自动化任务分别创建独立密钥
TLS 证书验证
- 脚本默认启用 HTTPS，但内部使用
curl -k（跳过证书验证），因 Starling Home Hub 使用自签名证书 - 此行为在 可信的本地网络 中可接受；但在不可信网络中会增加中间人（MITM）攻击风险
- 如需对 Hub 证书进行固定（certificate pinning），请使用：
starling.sh --cacert /path/to/hub-cert.pem status - 当指定
--cacert时，脚本将不再使用-k，并执行完整的证书验证流程
API 密钥置于 URL 中
- Starling Developer Connect API 要求将密钥作为 URL 查询参数传入（
?key=...）—— 此为 API 设计本身决定，并非本技能的实现选择 - URL 查询参数可能出现在访问日志或浏览器历史记录中 —— 但由于该 API 仅限本地网络访问（无代理/CDN 等中间节点），此风险已被有效缓解
- 务必使用 HTTPS，以确保密钥在本地网络传输过程中被加密
网络安全
- Starling API 在设计上为 纯本地网络接口，不暴露至公网
- 切勿将端口 3080 或 3443 映射（port-forward）至互联网
- 始终使用 HTTPS（默认协议），防止本地网络中 API 密钥及设备数据被嗅探窃取
快照处理
- 摄像头快照包含敏感图像信息 —— 请勿将其存储于全局可读目录中
- 脚本会自动将快照文件权限设为
chmod 600（仅属主可读写） - 快照文件使用完毕后，请及时清理临时文件
最佳实践
操作前务必先检查状态
调用设备相关命令前，请先确认 Hub 已就绪：
scripts/starling.sh status
请确认输出中包含 apiReady: true 和 connectedToNest: true 后再继续后续操作。
遵守速率限制
以下限制由 Nest 云服务强制执行：
- POST（设置属性）：每台设备 最多每秒一次
- Snapshot（快照）：每台摄像头 最多每 10 秒一次
- GET（读取属性/设备列表）：无云侧速率限制（数据来自本地缓存）
幂等性操作
以下操作可安全重试，不会产生副作用：
- 所有 GET 类操作（
status、devices、device、get、snapshot） - 值未变更的 SET 操作（例如当前温度已是 22°C，再次设置
targetTemperature=22） stream-extend（仅重置保活计时器）
非幂等操作：stream-start（每次调用均创建新流）
错误处理
脚本提供明确、可操作的错误提示：
- 401 错误：请检查 API 密钥及其权限 —— 密钥绝不会出现在错误输出中
- 404 错误：请核对设备 ID 与属性名称是否正确
- 400 错误：请检查参数值与类型是否符合要求
常用工作流
列出全部设备
scripts/starling.sh devices
读取设备属性
scripts/starling.sh device# 获取全部属性 scripts/starling.sh get # 获取单个属性
设置设备属性
scripts/starling.sh setkey=value [key=value...]
摄像头快照
scripts/starling.sh snapshot--output photo.jpg --width 1280
摄像头流媒体（WebRTC）
scripts/starling.sh stream-startscripts/starling.sh stream-extend # 每 60 秒调用一次 scripts/starling.sh stream-stop
常见任务示例
将恒温器设为 22°C：
scripts/starling.sh settargetTemperature=22
设置 HVAC 模式：
scripts/starling.sh sethvacMode=heat
检测摄像头是否触发移动侦测：
scripts/starling.sh getmotionDetected
上锁/解锁门锁：
scripts/starling.sh settargetState=locked
获取摄像头快照：
scripts/starling.sh snapshot--output front-door.jpg
检查烟雾/一氧化碳报警状态：
scripts/starling.sh getsmokeDetected scripts/starling.sh get coDetected
设置家庭/离家模式：
scripts/starling.sh sethomeState=away
API 参考文档
完整设备属性说明、可写属性列表、错误码定义及各端点详细文档，请参阅 references/api-reference.md。
热门AI工具
相关专题
Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章，帮助读者完成上线流程。
0
2026.10.28
Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章，帮助读者完成从初始化到日常开发的配置。
0
2026.10.28
Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章，帮助读者理解各文件夹的用途与引用方式。
0
2026.10.28
本专题介绍Gradle插件开发的基本流程，涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法，帮助你理解插件如何组织构建逻辑，减少多个项目之间的重复配置。
0
2026.10.22
本专题介绍Gradle Wrapper的基本作用，涵盖文件组成、生成方法、版本配置和任务调用，帮助你理解项目如何使用指定的Gradle版本，减少不同开发环境带来的构建差异。
0
2026.10.22
本专题整理Golangci-lint常用Linters的用途与配置方法，覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查，帮助项目合理选规则。
0
2026.10.22
本专题介绍Gradle Java项目构建方法，涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查，帮助你理解各阶段的任务关系，逐步完成项目构建。
0
2026.10.22
本专题汇总PHP常见时间戳漏洞，包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等，并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案，帮助开发者快速排查和加固时间相关代码。
0
2026.10.22
本专题聚焦Golangci-lint YAML配置文件，讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置，便于团队统一检查标准。
0
2026.10.22
热门下载
相关下载
精品课程
