本地运行的Garmin Connect数据同步工具，支持OAuth认证，每5分钟自动同步步数、心率、睡眠、运动等健康数据，数据完全本地存储。
说明：
## 核心用法
Garmin Connect Skill 是一款专为 Clawdbot 设计的本地健身数据同步工具。用户通过 OAuth 一次性认证后，系统每 5 分钟自动拉取 Garmin Connect 的全量健康数据，包括日常活动（步数、静息心率、卡路里、活动时长）、睡眠分析（时长、质量分数、深浅REM睡眠阶段）以及近期运动记录（类型、距离、时长、心率区间）。数据以 JSON 格式本地缓存，提供 Python API 供 Clawdbot 调用。
### 显著优点
1. **隐私优先设计**：OAuth 认证替代密码存储，session 文件仅存于本地 `~/.garth/session.json`，无云端传输风险
2. **数据完整性**：覆盖 Garmin 生态核心指标，睡眠阶段细分到 deep/REM/light，运动记录包含心率极值
3. **自动化程度高**：cron 定时任务实现准实时同步，无需手动干预
4. **扩展友好**：模块化架构（auth/sync/formatter 分离），支持多用户场景
### 潜在局限与风险
– **2FA 冲突**：官方明确建议禁用双因素认证或使用应用专用密码，对安全敏感用户存在张力
– **无官方 API**：依赖非官方库（推测为 garth/garminconnect-ha），存在服务协议灰色地带及接口变更风险
– **本地单点故障**：缓存文件损坏或 cron 失效时无告警机制
– **频率限制未量化**：仅提示”wait 5 minutes”，缺乏具体限流策略文档
### 适合人群
Garmin 设备长期用户、自建量化健康系统的极客、对厂商云同步有隐私顾虑的数据主权倡导者，以及需要结构化健康数据输入 AI 工作流的 Clawdbot 用户。
### 常规风险提示
OAuth token 虽本地存储，但明文 JSON 文件需配合文件系统权限管控（建议 600）。cron 脚本路径硬编码为 `/home/user`，多用户部署需手动调整。依赖第三方库的安全更新需人工跟踪。
会员专属
