Home Assistant：130+传感器

5次阅读

获取下载链

微信关注「软件教程管家」公众号，回复 home-assistant-garmin-connect

戴着 Garmin 手表跑步、睡觉、看身体电量，却要在两个 App 里来回切换才能看全数据？这个 Home Assistant 自定义集成做的就是健康数据同步：把 Garmin Connect 云服务里的健康、睡眠、训练、活动数据变成 Home Assistant 里的 130 多个传感器，集中放在家庭自动化仪表盘上。本篇讲清它能同步什么、两种安装方式选哪个、装完先配哪几项。

Garmin Connect 健康数据同步信息表

项目	内容
项目名	home-assistant-garmin-connect
类型	Home Assistant 自定义集成（Python）
数据来源	Garmin Connect 云服务
传感器数量	130 多个（以仓库 README 为准）
覆盖类别	步数、心率、HRV、压力、睡眠、Body Battery、训练状态、训练准备度、乳酸阈值、活动、目标、徽章、装备、体成分、血压、饮水、出汗损失、周期追踪
安装方式	HACS，或手动复制 custom_components 目录
前置条件	Garmin Connect 账户、至少一台已同步的 Garmin 设备

健康数据同步安装方式怎么选

结论先行：绝大多数人选 HACS，升级省心；只有 HACS 不可用时才走手动复制。

方式	适合谁	注意点
HACS 安装	已装 HACS 的 Home Assistant 用户	在 HACS 自定义仓库中填入 cyberjunky/home-assistant-garmin_connect，安装后重启
手动安装	没有 HACS、或想精确控制文件版本的人	把 custom_components/garmin_connect 目录复制到 Home Assistant 的 custom_components 目录后重启，升级要手动重复一遍

Garmin Connect 健康数据同步安装步骤

确认手表已同步到 Garmin Connect：集成只能拿到云端已有的数据，手表没同步，传感器就是空的。
用 HACS 安装，或手动复制 custom_components/garmin_connect 目录，完成后重启 Home Assistant。
在“设置 → 设备与服务”里添加该集成，填入 Garmin Connect 账户；启用了多因素认证要提前准备好接收验证码的方式。
等待首批传感器生成，逐项核对步数、心率、睡眠、Body Battery 是否有数，再往仪表盘上放卡片。
按需开关扩展传感器：周期追踪默认禁用，需要再评估隐私需求后手动启用。

装完必改的 4 项设置

设置 → 设备与服务 → 集成配置 → 传感器开关：130 多个传感器别全开，只留每天真看的指标，实体一多，仪表盘和自动化列表都会变乱。
仪表盘 → 核心指标卡片：先放步数、心率、睡眠、Body Battery、训练准备度这组最常用的，跑一周确认数值稳定，再加装备、徽章这类扩展项。
自动化 → 身体状态触发：Body Battery 偏低、睡眠不足、训练准备度低这类状态最适合做自动化触发，比单纯看数字有用，但阈值要按自己的实际数据定，别抄别人的数。
隐私 → 周期追踪开关：该功能默认禁用，启用前先想清楚家里仪表盘谁能看到，敏感数据默认关着才是正确姿势。

Garmin Connect 健康数据同步注意事项

离不开云服务：数据走 Garmin Connect 云端，仓库没有说明离线采集和断网缓存行为，断网或云服务异常时数据会断档。
手表同步是前提：运动完先让手表同步到手机 App，云端没数据，Home Assistant 里再怎么刷新也没有。
多因素认证要留通道：初始配置和重新认证可能需要验证码，认证方式失效会导致集成掉线。
不要指望它替代 Garmin App：它的强项是集中展示和联动自动化，详细的训练分析、课程计划还是回 Garmin Connect 看更全。
升级后复查配置：Home Assistant 大版本或集成更新后，到设备与服务页复查一次配置，传感器改名或失效要及时处理。

Garmin Connect 健康数据同步适合谁，与官方渠道的分工

适合已经在用 Home Assistant、想把手表数据和家里自动化放在同一块屏上的人：早上看板一眼看到睡眠和 Body Battery，睡前自动化按身体状态调灯光和提醒。它的边界也很清楚：它只是 Garmin Connect 数据的搬运和展示层，不提供离线采集，也不承诺官方 API 级别的稳定性。如果你还没用 Home Assistant，单为这一个集成搭整套系统就本末倒置了。