Garmin Health Analysis

核心功能

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持续下降等信号应作为就医参考而非诊断依据

核心功能

Garmin Health Analysis 是一款面向 Garmin 可穿戴设备用户的健康数据分析工具，通过非官方 API 连接 Garmin Connect，提取睡眠、心率变异性（HRV）、Body Battery 恢复指数、压力水平及运动活动等核心健康指标，生成交互式 HTML 可视化图表。

主要能力：

• 数据获取：支持睡眠、HRV、静息心率、Body Battery、压力、活动记录的时段查询
• 可视化输出：基于 Chart.js 生成交互式仪表盘，含趋势曲线、统计卡片和颜色分级提示
• 智能分析：内置健康指标解读框架（如 Body Battery 0-100 分级、睡眠评分标准），辅助用户理解数据含义

显著优点

1. 指标维度全面：覆盖 Garmin 生态核心健康数据，Body Battery 和 HRV 趋势分析对训练恢复管理具有实际指导价值
2. 开箱即用：提供多层级凭据配置（环境变量、本地文件、命令行），支持 Clawdbot UI 集成配置
3. 隐私本地化：所有数据仅本地处理，HTML 报告离线生成，无云端上传
4. 开源透明：MIT 许可，代码结构清晰，依赖均为活跃维护的社区项目

潜在局限

• API 稳定性风险：依赖逆向工程的非官方 API，Garmin 官方政策变更可能导致功能中断
• 凭据管理负担：必须存储用户账号密码或长期会话令牌，虽权限控制为 0600，仍存在本地泄露风险
• 设备兼容性：部分高级指标（如 Body Battery）需 HRV 支持型设备（如 Fenix、Venu、Forerunner 系列）
• 无实时同步：基于定时拉取模式，非 Garmin Connect 实时推送

适合人群

• Garmin 手表深度用户，希望超越官方 App 进行自定义分析
• 运动爱好者、业余运动员，关注训练负荷与恢复平衡
• 健康数据量化自我（Quantified Self）实践者
• 对数据隐私敏感，倾向本地化处理的用户

常规风险

| 风险类型 | 等级 | 说明 |

|---------|------|------|

| 凭据泄露 | 低 | 邮箱密码本地存储，需避免硬编码或误提交版本控制 |

| API 失效 | 中 | 非官方 API 可能因 Garmin 反爬策略变更而中断 |

| 健康数据暴露 | 低 | 生成的 HTML 报告含敏感信息，分享时需注意脱敏 |

| 过度解读 | 中 | 非医学级设备数据，不建议用于疾病诊断或医疗决策 |

> 免责声明：本工具提供的健康分析仅供参考，不构成医疗建议。异常指标请咨询专业医护人员。