核心用法
Garmin Health Analysis 是一款面向 Garmin 穿戴设备用户的健康数据分析技能，通过非官方 Garmin Connect API 获取个人健康数据，并提供交互式可视化图表。用户需配置 Garmin 账号邮箱和密码完成认证，支持三种凭证配置方式（Clawdbot UI 配置、本地配置文件、命令行参数）。认证后可通过命令行工具获取睡眠、Body Battery（身体电量）、HRV（心率变异性）、心率、活动记录、压力等多维度数据，并生成基于 Chart.js 的交互式 HTML 图表。
数据获取能力
- 睡眠分析：时长、睡眠评分（0-100）、各阶段分布
- Body Battery：Garmin 专利恢复指标（0-100），基于 HRV、压力、睡眠综合计算
- HRV 趋势：夜间平均 HRV，反映自主神经平衡与恢复能力
- 心率监测：静息心率、最大/最小心率追踪
- 活动记录：运动类型、卡路里消耗、时长统计
- 压力水平：全天候 HRV 衍生压力评估
可视化输出
支持生成单指标图表（睡眠、Body Battery、HRV、活动）及综合仪表板，图表采用渐变色现代设计，包含统计卡片与交互式悬停提示，自动在默认浏览器中打开。
显著优点
1. 数据整合度高：覆盖 Garmin 生态核心健康指标，一站式满足运动健康分析需求
2. 可视化专业：Chart.js 交互图表美观易读，支持 30/90 天等多时间维度对比
3. 分析框架科学：内置基于循证医学的指标解读指南（health_analysis.md），提供个性化建议
4. 认证机制灵活：支持 UI、文件、环境变量、命令行四种凭证配置，适应不同使用场景
5. 会话管理智能：Token 自动刷新，避免频繁重复登录
潜在缺点与局限性
- API 非官方：依赖社区维护的
garminconnect库，Garmin 官方 API 变更可能导致功能中断 - 设备门槛：Body Battery、HRV 等高级功能需特定型号 Garmin 设备（如 Forerunner、Fenix、Venu 系列）
- 数据精度限制：睡眠分期、压力评估为算法估算，非医疗级精度
- 无实时同步：需手动触发数据获取，非自动后台同步
- 比较功能缺失：缺乏与 Apple Health、Whoop 等平台的直接数据对比工具（仅提供文字对比表）
适合人群
- 严肃跑者/铁三运动员：需要追踪训练负荷与恢复平衡
- 健身爱好者：关注睡眠、压力、心率等健康趋势
- 数据驱动型用户：希望将可穿戴设备数据转化为可行动洞察
- Garmin 手表用户（尤其是中高端型号）
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 账号安全 | 需存储邮箱密码，存在凭证泄露风险 | 使用本地加密存储，Token 文件权限控制，定期更换密码 |
| 服务可用性 | 非官方 API 可能因 Garmin 反爬虫策略失效 | 关注库更新，避免高频请求，预留手动导出备选方案 |
| 健康误导 | 算法数据非医疗诊断，可能误判身体状况 | 明确免责声明，异常指标建议就医确认 |
| 隐私合规 | 健康数据属于敏感个人信息 | 数据仅本地处理，不向第三方传输，Token 可手动撤销 |