netatmo

🏠 智能恒温与环境监测专家

基于社区开源方案,通过 CLI 工具实现 Netatmo 恒温器智能控制与全方位环境数据监测,助力家庭能源管理与健康生活。

收藏
13k
安装
3.1k
版本
v1.0.1
CLS 安全性认证2026-05-22
点击查看完整报告 >

使用说明

Netatmo Skill 是一个面向智能家居场景的纯文档型控制工具,专为拥有 Netatmo 智能恒温器和气象站的用户设计。该 Skill 本身不包含可执行代码,而是通过标准化的 Markdown 文档指导用户利用 netatmo CLI 工具实现对家庭供暖系统的精准控制与环境数据的全面监测。

核心用法方面,用户需预先在本地配置 OAuth 凭据(~/.config/netatmo/credentials.json),随后即可通过一系列直观的命令完成操作。主要功能涵盖:实时查看恒温器状态及多房间传感器数据(包括卧室、客厅、办公室和室外站点的温度、湿度、CO₂、噪音、气压等指标);灵活设置目标温度(7-30°C 范围)并切换运行模式(常规计划、离家模式、防冻保护);调取 7-14 天的历史温度数据并以 ASCII sparklines 形式直观展示趋势。所有命令均支持 JSON 格式输出,便于与其他自动化工具集成。

显著优点在于其安全透明的设计理念。作为纯文档型 Skill,它不存在代码注入、远程下载或静默数据收集等风险,所有敏感操作均依赖用户本地安装的官方 CLI 工具完成。功能层面,它提供了企业级智能家居管理能力,支持多维度环境感知(特别是 CO₂ 浓度监测有助于改善室内空气质量),且温度控制具备安全边界(3 小时自动恢复计划模式,防止能源浪费)。

潜在局限性主要包括:其一,依赖外部 CLI 工具,用户需自行安装配置 netatmo 命令行程序并处理 OAuth 认证流程,技术门槛相对较高;其二,作为 T3 级社区来源项目,长期维护更新与技术支持存在不确定性;其三,功能受限于 Netatmo 硬件生态,无设备用户无法使用;其四,温度设置虽有限制,但误操作仍可能导致短期能源浪费或舒适度下降。

该 Skill 特别适合以下群体:已部署 Netatmo 智能恒温器或气象站的家庭用户、关注室内空气质量(CO₂、湿度)的健康生活倡导者、希望通过命令行实现高效家居自动化的技术爱好者,以及需要将环境数据集成到自有监控系统的开发者。

使用风险方面,尽管 Skill 本身安全,但用户需注意:本地凭据文件(credentials.jsontokens.json)的权限管理(建议设置 700 权限),防止未经授权访问;依赖外部 CLI 的版本兼容性;以及手动温度设置后 3 小时的自动恢复机制可能影响特殊使用场景。总体而言,在正确配置本地安全策略的前提下,该 Skill 提供了安全可靠的智能家居控制能力。

安全解读

核心功能

Netatmo skill 为用户提供完整的智能家居气候管理方案,通过封装 netatmo CLI 工具实现对 Netatmo 生态设备的统一控制。

温控操作:支持精确设定目标温度(7-30°C 范围),提供 set 快速调温(自动进入 3 小时手动模式后恢复日程)、mode schedule 恢复日程、mode away 外出节能模式(12°C)、mode hg 防冻保护模式(7°C)四种核心模式,覆盖日常、离家、度假等全场景需求。

环境监测:整合多点位传感器数据,包括卧室/客厅/办公室/室外四个位置的实时温度、湿度、CO₂ 浓度、噪音分贝、气压读数及设备电池状态。特别提供 CO₂ 超标预警(>1000 ppm 提示通风不良)和 7-14 天温度历史趋势(ASCII 火花线可视化)。

数据输出:所有命令支持 --json 参数,便于与其他自动化工具集成。

显著优点

1. 零代码风险:纯 Markdown 文档型 skill,无可执行代码,无供应链攻击面
2. 命令简洁直观:语法接近自然语言,netatmo set 21 等命令学习成本极低

3. 多维度环境监测:CO₂ 与噪音检测超越普通温控器,关注居住健康

4. 智能模式设计:3 小时手动超时机制避免能源浪费,防冻/外出模式覆盖极端场景

5. 开放集成:JSON 输出格式便于接入 Home Assistant、Node-RED 等自动化平台

潜在局限

  • 依赖外部 CLI:需用户自行安装配置 netatmo 命令行工具及 OAuth 凭证
  • 仅限 Netatmo 生态:不支持其他品牌智能温控设备
  • 无原生可视化:历史数据依赖 ASCII 火花线,复杂分析需导出 JSON 自行处理
  • 手动模式时长固定:3 小时超时不可自定义
  • T3 来源:个人开发者维护,无企业级 SLA 保障

适合人群

  • 已部署 Netatmo 恒温器/气象站的智能家居用户
  • 偏好 CLI 工作流的开发者与技术爱好者
  • 需要 CO₂ 与噪音监测以优化室内空气质量的健康意识家庭
  • 追求本地优先、隐私友好的自动化方案用户(无云端 API 依赖)

常规风险

  • 凭证管理:OAuth token 存储于本地 ~/.config/netatmo/,需确保文件权限安全(建议 600)
  • 物理访问风险:若设备被他人物理接触,可能被手动篡改温控设置
  • CLI 工具中断:netatmo CLI 若停止维护,skill 功能将失效
  • 网络依赖:实际控制仍需 Netatmo 设备联网,非完全本地方案

netatmo 内容

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