Netatmo

核心功能

netatmo 是专为 Netatmo 智能家居生态打造的命令行控制工具，实现温控与环境监测一体化管理。

温控管理：支持 7-30°C 精确设定，提供 schedule/away/hg（防冻）三种模式切换，手动设定 3 小时后自动恢复日程，兼顾灵活与节能。

环境监测：覆盖温度、湿度、CO₂、噪音、气压五维数据，支持多房间（主卧、客厅、办公室、户外）分布式采集，CO₂ 超 1000ppm 自动提示通风需求。

数据可视化：内置 7-14 天历史温度趋势，ASCII sparkline 直观展示波动；全命令支持 --json 输出，便于脚本集成与自动化工作流。

显著优势

• 本地化优先：凭证本地存储（~/.config/netatmo/），OAuth token 自动续期，减少云端依赖
• 响应式交互：CLI 即时反馈，适合快捷场景（如离家一键切换 away 模式）
• 扩展性强：JSON 输出兼容 Home Assistant、Grafana 等第三方平台

局限与风险

• 硬件绑定：需完整 Netatmo 生态（温控器+气象站），单设备用户价值受限
• 范围约束：仅支持官方 API 暴露功能，无法自定义传感器阈值报警
• 凭证集中：credentials.json 包含 client_secret，明文存储需配合文件权限管控

适用人群

• 已有 Netatmo 设备的智能家居进阶用户
• 偏好 CLI 工作流的开发者与运维人员
• 关注室内空气质量（CO₂/湿度）的远程办公群体

安全等级说明

基于 OAuth2 标准授权流程，token 本地托管，无密码硬编码。风险点在于 credentials.json 的本地存储安全，建议配合磁盘加密与 600 权限设置。

核心用法

本 Skill 作为 netatmo CLI 工具的交互式封装层，允许用户通过自然语言指令操控 Netatmo 智能家居设备。核心功能覆盖两大场景：温控管理与环境监测。

温控操作：支持设置目标温度（netatmo set 21）、切换运行模式（schedule 定时/away 离家/hg 防冻保护）。设置命令默认进入 3 小时手动模式后自动恢复日程，兼顾即时需求与节能。

数据查询：实时获取多房间传感器数据，包括主卧（温度/湿度/CO₂/噪音/气压）、户外（温度/湿度/气压/电池）、客厅（温度/湿度/CO₂/电池）及办公室温度。支持 7-14 天历史温度趋势，以 ASCII sparkline 可视化呈现。

输出格式：所有命令支持 --json 参数，便于程序化解析与自动化工作流集成。

显著优点

1. 零代码安全架构：纯 Markdown 文档型 Skill（T-MD 分类），无可执行代码、无依赖引入、无网络请求发起，从根本上杜绝代码注入与供应链攻击风险。

2. 功能边界清晰：严格限定于 Netatmo 设备控制，不涉及泛化的家居自动化，指令语义明确，降低误操作概率。

3. 数据维度丰富：单点 Skill 覆盖温度、湿度、CO₂、噪音、气压、电池电量六大类环境指标，满足健康监测与能源管理双重需求。

4. CLI 生态兼容：依托成熟的 netatmo 命令行工具，OAuth 令牌自动刷新，用户仅需配置 client_id/secret 即可长期使用。

潜在缺点与局限性

1. 外部依赖刚性：Skill 本身仅为使用文档，实际功能完全依赖用户本地预装的 netatmo CLI 工具。若环境未配置或 CLI 版本不兼容，功能即刻失效。

2. T3 来源可信度：维护者为个人开发者（florianbeer），虽有 Mycroft AI 社区贡献记录，但缺乏企业级背书与长期维护承诺。

3. 交互粒度较粗：温控仅支持整数摄氏度设定（7-30°C），不支持 0.5°C 精调；历史数据查询上限 14 天，无年度趋势分析能力。

4. 设备生态封闭：仅兼容 Netatmo 品牌设备，无法扩展至 HomeKit、米家等跨平台协议。

适合的目标群体

• Netatmo 设备现有用户：已部署 Netatmo 恒温器与气象站，希望获得比官方 App 更快捷的语音/文本交互方式。
• 智能家居自动化爱好者：需要将环境数据接入自定义脚本或 Home Assistant 等平台的极客用户。
• 室内空气质量关注者：对 CO₂ 浓度、噪音水平敏感，需要实时告警与历史趋势分析的家庭或小型办公场景。

使用风险与注意事项

1. CLI 工具安全风险：Skill 虽不直接发起网络请求，但底层 netatmo CLI 会连接 Netatmo 云服务。建议定期检查 CLI 版本安全公告，避免使用来源不明的二进制文件。

2. 凭证管理责任：OAuth 令牌与 client credentials 存储于 ~/.config/netatmo/，需确保目录权限正确（建议 700），防止本地其他进程窃取。

3. 温度设置误操作：netatmo set 命令即时生效，无二次确认机制，极端设定（如 7°C 防冻或 30°C 上限）可能影响居住舒适度或能耗。

4. 数据隐私边界：Netatmo 云服务位于法国，数据存储受 GDPR 约束，但历史查询功能意味着部分数据本地缓存，多用户共享设备时需注意隐私隔离。