核心功能
Garmin Connect Skill 是一个健康数据同步工具，可将Garmin生态中的运动健康数据自动导出为结构化的Markdown文件。支持睡眠评分、活动量、静息心率、压力指数、身体电量、HRV心率变异性、血氧饱和度及体重等8类核心指标，以日期为单位生成独立文档，便于长期健康追踪与跨平台分析。
显著优点
数据完整性与专业性：直接对接Garmin原生数据库，获取设备级原始数据，比第三方健康聚合平台（如Apple Health、Google Fit）的二次处理数据更精准。Markdown格式确保数据可读性与可移植性，支持版本控制与长期存档。
安全架构设计：采用OAuth令牌缓存机制，仅需一次性邮箱/密码认证，后续运行完全脱离凭据。令牌本地存储约一年，降低了凭证泄露风险。uv工具链实现依赖隔离，避免污染系统Python环境。
自动化友好：支持Cron定时任务，可配置每日自动同步，配合OpenClaw调度实现"零干预"数据更新。历史数据回溯灵活，支持单日、多日及日期范围查询。
潜在局限
认证依赖风险：Garmin未开放正式OAuth API，认证流程依赖非官方逆向工程（garminconnect库），存在服务条款争议及API变更导致失效的风险。
单点故障：令牌缓存机制虽便利，但若用户丢失~/.garminconnect目录或跨设备迁移，需重新执行完整认证流程，中断自动化链条。
数据维度边界：仅支持Garmin生态内数据，无法直接融合Apple Watch、Whoop等其他设备数据，跨平台健康分析需额外ETL处理。
云依赖：同步依赖Garmin云服务可用性，设备本地蓝牙同步数据若未上传云端则无法获取。
适合人群
- Garmin设备深度用户（Forerunner、Fenix、Venu等系列）
- 量化自我（Quantified Self）实践者，需本地长期健康档案
- 隐私敏感用户，倾向数据本地化存储而非云端仪表盘
- 开发者/分析师，需原始健康数据进行自定义可视化或机器学习
常规风险
令牌安全：虽比持久化密码安全，但OAuth refresh token若被窃取，攻击者可获取同等数据访问权限。建议配合磁盘加密与权限管控。
服务可用性：非官方API可能随Garmin服务端更新而失效，需关注上游garminconnect库维护状态。
隐私合规：健康数据属于敏感个人信息，本地存储需符合GDPR/ HIPAA等法规的自我管理要求，备份加密不可忽视。