核心功能
Garmin Health Analysis 是一款面向 Garmin 设备用户的综合健康数据分析工具，通过非官方但广泛使用的 garminconnect Python 库，实现与 Garmin Connect 平台的数据同步。核心功能包括：
数据获取：支持查询 20+ 项健康指标，涵盖睡眠（时长、评分、阶段）、Body Battery（佳明专有的恢复能量指数）、HRV（心率变异性）、静息心率、血氧饱和度、压力水平、训练准备度、身体成分等。支持自然语言时间查询（如"昨天下午3点的心率"）和自定义日期范围。
可视化分析：基于 Chart.js 生成交互式 HTML 图表，包含趋势曲线、统计卡片、颜色编码区间，支持单指标深度视图（如 90 天 HRV 趋势）和综合仪表板模式。
智能解读：内置健康分析框架，提供指标正常范围参考（如 Body Battery 75-100 为完全恢复、HRV 趋势上升表示恢复能力提升），并输出可执行建议（何时该休息、何时可高强度训练）。
显著优点
1. 指标全面性：Body Battery 是 Garmin 独有的综合恢复指标，整合 HRV、压力、睡眠和活动数据，比单一指标更能反映真实身体状态。
2. 离线友好：会话令牌本地存储（~/.clawdbot/garmin-tokens.json），支持自动刷新，减少重复登录；图表生成为独立 HTML 文件，可离线查看。
3. 隐私可控：所有数据处理均在本地完成，仅与 Garmin 官方服务器通信，凭证支持多种安全配置方式（环境变量、配置文件、命令行）。
4. 生态兼容性：支持 FIT/GPX 文件分析，可与 Training Peaks、Strava 等第三方平台数据互补。
潜在局限
1. API 稳定性风险：依赖非官方逆向工程 API（garminconnect 库），Garmin 可能随时调整接口导致功能中断，需及时跟进库更新。
2. 设备依赖性：部分高级功能（Body Battery、训练准备度、血氧）需特定型号支持（如 Fenix、Forerunner、Venu 系列），入门机型数据不完整。
3. 医学免责声明：虽然提供健康趋势分析，但明确指出非医疗建议，无法替代专业诊断。HRV 等指标个体差异极大（正常范围 20-200+ ms），需结合个人基线判断。
4. 速率限制：Garmin 对 API 请求频率有限制，频繁查询可能触发临时封禁。
适合人群
- 运动表现优化者：马拉松、铁三、CrossFit 等耐力运动爱好者，需要量化恢复状态、避免过度训练
- 健康数据极客：希望整合多维度生物指标、建立个人健康基线的量化自我实践者
- 睡眠质量关注者：利用睡眠评分和 HRV 数据优化作息规律
- Garmin 生态深度用户：已拥有中高端 Garmin 设备，希望突破官方 App 的展示限制
常规风险
- 账户安全风险：需存储邮箱密码或会话令牌，虽采用本地加密存储，仍存在凭证泄露可能（建议启用 Garmin 账户两步验证）
- 数据断档风险：设备未佩戴、电量耗尽或同步失败时会产生数据空缺，影响趋势分析准确性
- 过度解读风险：单日数据波动可能受咖啡因、饮酒、生病等因素干扰，需关注长期趋势而非单一数值