Garmin Health Analysis

核心用法

Garmin Health Analysis 是一个综合性健康数据查询与分析技能，通过非官方 Garmin Connect API 获取用户穿戴设备的生物特征数据。支持三种认证方式（环境变量、本地配置文件、命令行参数），数据获取涵盖睡眠评分、Body Battery（体能电量）、HRV（心率变异性）、静息心率、全天压力、训练准备度、血氧等20余项指标。提供时间精确查询（如"下午3点的心率"），可分析 FIT/GPX 原始运动文件，并生成基于 Chart.js 的交互式 HTML 可视化报告。

显著优点

• 指标全面：覆盖 Garmin 生态绝大多数健康数据维度，包括 proprietary 指标如 Body Battery
• 可视化能力：自动生成渐变设计风格的交互式图表，包含统计卡片与趋势分析
• 灵活查询：支持自然语言时间查询、自定义日期范围、综合摘要与专项数据模式
• 专业分析框架：内置基于循证医学的数据解读指南，提供分层的洞察与可执行建议

潜在缺点与局限性

• API 非官方：依赖社区维护的 garminconnect Python 库，Garmin 官方 API 变更可能导致功能中断
• 设备门槛：Body Battery、HRV 等核心功能需特定型号设备（如 Forerunner、Fenix、Venu 系列）
• 认证依赖：需明文存储邮箱密码或使用 OAuth tokens，存在凭证泄露理论风险
• 数据延迟：部分指标（如睡眠评分）需设备同步后延迟生成，非实时可用
• 医学免责声明：明确标注非医疗建议，重大健康决策仍需专业医师

适合人群

Garmin 智能穿戴设备深度用户、耐力运动员、量化健康爱好者、需要追踪恢复状态的 CrossFit/铁三/马拉松训练者，以及希望通过数据驱动优化训练负荷的健身教练。

常规风险

• 隐私风险：健康数据（心率、睡眠、HRV）属敏感个人信息，本地 token 文件需妥善保管
• 服务中断：非官方 API 可能因 Garmin 反爬策略或协议变更而失效
• 过度解读：用户可能误将健身追踪数据等同于医疗诊断，延误真正需要的医疗干预