本地同步你的Garmin全维健康数据

本地运行的Garmin Connect数据同步工具，支持OAuth认证，每5分钟自动同步步数、心率、睡眠、运动等健康数据，数据完全本地存储。

基本信息

• 技能名称?Garmin Connect
• 中文名称?本地同步你的Garmin全维健康数据
• 作者?rayleigh3105
• 分类?其他
• 版本?1.0.0
• 标签?garmin, fitness-data, oauth, local-sync, quantified-self, wearables, health-tracking, clawdbot-integration, privacy-first

使用方法

使用说明
核心用法
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 ，多用户部署需手动调整。依赖第三方库的安全更新需人工跟踪。