核心功能
Garmin Health Analysis 是一款面向Garmin穿戴设备用户的健康数据分析工具，通过非官方Garmin Connect API (garminconnect库)获取用户授权数据，生成交互式HTML可视化报告。
主要数据维度：
- 睡眠分析：睡眠时长、睡眠评分(0-100)、睡眠阶段分布
- Body Battery：Garmin专有的恢复指标(0-100)，综合HRV、压力、睡眠和活动数据
- HRV趋势：夜间心率变异性追踪，评估自主神经系统平衡
- 心率数据：静息心率、最大/最小心率趋势
- 活动记录：运动类型、卡路里消耗、训练负荷
- 压力监测：全天候压力水平分析
交互式图表：基于Chart.js生成现代化渐变设计图表，支持数据钻取、趋势对比，可输出为独立HTML文件在浏览器中查看。
显著优点
1. 多源数据整合：将分散在Garmin Connect的各项健康指标统一可视化，避免用户在App中切换查看
2. 科学解读框架：内置health_analysis.md参考文档，提供基于循证医学的数据解读标准（如HRV正常范围、睡眠评分分级）
3. 灵活的查询方式：支持按天数(1-90天)或自定义日期范围查询，适应短期复盘和长期趋势分析
4. 本地隐私保护：凭证和会话令牌仅存储在本地~/.clawdbot/garmin-tokens.json，不经过第三方服务器
5. 自动化会话管理：支持token自动刷新，减少重复登录摩擦
潜在局限与风险
1. API非官方性质：依赖社区维护的garminconnect库，Garmin官方API变更可能导致功能中断
2. 设备兼容性限制：Body Battery等高级功能需要特定型号（如Fenix、Venu、Forerunner系列），部分旧设备不支持HRV监测
3. 数据完整性依赖佩戴：睡眠、HRV等数据需夜间佩戴设备，漏戴会导致数据缺口
4. 速率限制：Garmin对API请求有限流，频繁查询可能触发"Too many requests"错误
5. 健康建议边界：工具明确标注"非医疗建议"，但用户可能过度解读数据（如自行诊断心律失常）
适合人群
- 严肃运动爱好者：需要追踪训练负荷与恢复平衡的铁三、马拉松跑者
- 量化自我践行者：希望建立长期健康数据档案，优化睡眠和压力的科技用户
- Garmin生态深度用户：已拥有多代Garmin设备，积累了足够历史数据用于趋势分析
- 教练与运动科学研究人员：需要批量导出运动员数据生成可视化报告
常规风险提示
- 数据安全风险：虽为本地存储，但
config.json和token文件如未加密，存在被恶意软件窃取风险 - 过度关注风险：持续监控健康数据可能引发"orthorexia"（健康焦虑），建议结合主观感受综合判断
- 医疗决策边界：静息心率突然升高、HRV持续下降等信号应作为就医参考而非诊断依据