核心用法
Garmin Health Analysis 是一款面向 Garmin 智能手表用户的全方位健康数据分析工具。用户可通过自然语言提问（如"我昨天下午 3 点的心率是多少？"）获取精准的健康数据反馈，无需手动翻查 App。核心功能包括：
1. 数据查询：通过 garmin_data.py 脚本获取睡眠、Body Battery（体能电量）、HRV（心率变异性）、静息心率、压力水平、训练准备度、血氧等 20+ 指标的 JSON 数据，支持自定义日期范围。
2. 可视化分析：garmin_chart.py 生成基于 Chart.js 的交互式 HTML 图表，包含睡眠分析、Body Battery 恢复曲线、HRV 趋势、活动汇总四大模块，支持一键导出与自动浏览器打开。
3. 智能问答：内置问答映射表，自动识别用户意图并调用对应数据接口，结合 health_analysis.md 中的科学解读框架，提供趋势分析与可执行建议。
4. 文件解析：支持 FIT/GPX 运动文件分析，满足进阶用户的原始数据需求。
显著优点
- 指标覆盖全面：集成 Garmin proprietary 的 Body Battery 算法、睡眠评分、全天候压力监测等独家数据，远超通用健康类工具。
- 交互体验优秀：渐变式现代 UI 设计，支持悬停工具提示与响应式布局，数据可读性极强。
- 灵活认证机制：提供 Clawdbot UI 配置、本地配置文件、命令行参数、环境变量四种认证方式，兼顾安全与便利。
- 自动化会话管理：Token 自动刷新与本地持久化，避免频繁登录。
- 离线分析能力：通过 FIT/GPX 解析，即使无网络也可分析历史运动文件。
潜在缺点与局限性
- 非官方 API 依赖：基于
garminconnect非官方 Python 库，存在 Garmin 更改接口导致功能中断的风险。 - 设备门槛：Body Battery、HRV 等指标需 HRV 兼容设备（如 Fenix、Forerunner 245 及以上型号），入门款 Garmin 设备数据不完整。
- 速率限制：Garmin 官方对 API 请求有频率限制，高频查询可能触发封禁。
- 医学免责声明：所有分析均为信息性参考，无法替代专业医疗诊断。
- 历史数据缺口：新账户或长期未佩戴设备时，数据连续性不足影响趋势分析准确性。
适合人群
- 严肃运动爱好者：马拉松跑者、铁三运动员、CrossFit 训练者，需精准监控训练负荷与恢复周期。
- 健康数据极客：习惯量化自我（Quantified Self）、追求多维度健康指标追踪的用户。
- 睡眠质量关注者：利用 Garmin 睡眠评分与 HRV 数据优化恢复策略的人群。
- 教练与运动科学家：需要批量导出运动员数据、生成可视化报告进行分析指导的专业人士。
常规风险
- 账户安全风险：需存储邮箱密码或 session token 于本地，虽经加密处理且支持 gitignore，但仍存在物理设备丢失后的凭证泄露可能。
- 服务中断风险：非官方 API 无 SLA 保障，Garmin 服务端更新可能导致功能失效。
- 数据误读风险：用户可能过度解读短期 HRV 波动或单日睡眠评分，引发不必要的焦虑或训练决策失误。
- 隐私合规边界：健康数据属于敏感个人信息，跨设备同步或分享图表时需注意 GDPR/个人信息保护法的合规要求。