对话式健康数据分析师，读懂你的身体

自然语言查询Garmin健康数据，支持睡眠分析、Body Battery恢复指标、HRV趋势及交互式健康仪表盘，适合深度运动健康追踪。

基本信息

• 技能名称?Garmin Health Analysis
• 中文名称?对话式健康数据分析师，读懂你的身体
• 作者?eversonl
• 分类?其他
• 版本?1.2.2
• 标签?wearables, garmin, health-tracking, hrv-analysis, recovery-monitoring, sleep-analysis, fitness-data, body-battery, training-load, data-visualization

使用方法

使用说明
核心用法
Garmin Health Analysis 技能允许用户通过自然语言与Garmin Connect数据进行对话式交互。支持20+健康指标查询，包括睡眠阶段（深睡、REM、清醒时长）、Body Battery恢复评分（0-100）、心率变异性（HRV）、静息心率、VO2 max、训练准备度、血氧（SpO2）及体重体脂等。用户可询问"昨晚睡眠如何"、"本周恢复状态怎样"或"3点心率多少"等问题，系统自动调用 garmin_data.py 提取JSON数据并生成易读回复。同时提供 garmin_chart.py 生成基于Chart.js的交互式HTML可视化图表，支持睡眠分析、Body Battery趋势、HRV/静息心率长期追踪及综合仪表盘。
数据获取支持灵活的时间范围（默认7天，可扩展至90天或自定义日期），并能下载FIT/GPX原始文件进行路线、海拔、配速的逐点分析。对于深度用户，技能内置科学解读框架，结合 health_analysis.md 提供基于年龄和体能水平的正常范围参考、趋势识别（如HRV上升=恢复改善）、训练负荷平衡分析及可执行建议。
显著优点
自然语言交互 ：突破传统仪表盘限制，直接用对话方式探索个人健康数据，大幅降低使用门槛
多维度恢复指标 ：Body Battery综合HRV、压力、睡眠和活动数据，提供直观的0-100能量评分，比单一心率指标更能反映真实恢复状态
科学解读框架 ：内置权威参考范围（如运动员静息心率40-60bpm、HRV正常范围20-200ms），避免用户误解数据
离线可视化 ：生成本地HTML交互图表，无需上传敏感数据至第三方，隐私可控
双模式部署 ：同时支持Clawdbot Skill（自动化监控）和MCP Server（Claude Desktop标准集成），灵活适配不同工作流
潜在缺点与局限性
非官方API依赖 ：基于 garminconnect 社区库，Garmin官方可能随时变更接口导致功能中断，需及时更新依赖
设备门槛 ：Body Battery、HRV等核心功能需特定型号（如Forerunner、Fenix、Venu系列），老旧设备数据缺失
认证复杂度高 ：需配置邮箱密码，支持四种凭证来源（环境变量、config文件、Clawdbot配置、命令行），新手易混淆
医学免责声明 ：所有分析仅为信息参考，不能替代专业医疗诊断，用户可能过度解读数据产生焦虑
速率限制 ：频繁查询可能触发Garmin反爬机制，影响体验
适合人群
严肃跑者/铁三/越野运动员：需要追踪训练负荷与恢复平衡，优化周期化训练
健康优化爱好者：关注睡眠质量、HRV长期趋势，进行生活方式干预
Garmin手表深度用户：已积累数月数据，希望从原始数据中提取洞察而非仅看每日分数
数据驱动型健身者：希望将可穿戴数据整合到自动化工作流（如结合Clawdbot定时生成周报）
常规风险
凭证安全 ：密码以明文形式存储于本地JSON（config.json或clawdbot.json），虽.gitignore保护但文件系统权限不当可能导致泄露
数据误读风险 ：HRV个体差异极大（20-200ms均为正常），缺乏医学背景的解读可能误导用户忽视真正健康问题
过度训练暗示 ：Body Battery低时系统建议休息，但竞技运动员可能在关键训练期故意压低该指标，盲目遵循建议可能干扰训练计划
API失效风险 ：非官方库无服务级别协议，Garmin策略变化可能导致长期数据访问中断