核心功能
Garmer 是一款面向 Garmin Connect 用户的健康数据提取工具，通过命令行和 Python API 提供全面的健身指标访问能力。核心功能覆盖六大健康维度：日常活动追踪（步数、卡路里、爬楼）、睡眠分析（时长、睡眠阶段、HRV）、心率监测（静息心率、心率区间）、压力与身体电量、运动记录（跑步、骑行、游泳等）以及体成分数据（体重、体脂率）。
使用方式
采用 OAuth 令牌认证机制，首次使用需执行 garmer login 完成 Garmin 账号授权，令牌默认存储于 ~/.garmer/garmin_tokens。CLI 设计遵循 Unix 哲学，提供 summary、sleep、activities、snapshot、export 等原子化命令，支持日期范围查询和 JSON 输出。Python API 则面向数据科学场景，允许直接实例化 GarminClient 进行程序化分析。
显著优势
- 数据完整性：相比官方 API 的受限访问，Garmer 可导出 Garmin Connect 全量历史数据
- 离线分析能力：支持批量导出（
--days/--start-date/--end-date），便于本地趋势分析 - 开发者友好：提供类型化的 Python API，返回结构化数据对象而非原始 JSON
- 隐私控制：令牌本地存储，支持自定义目录 (
GARMER_TOKEN_DIR)，无云端中转
局限与风险
- 账号依赖：需有效 Garmin Connect 账号及密码，且受限于 Garmin 服务条款
- 稳定性风险：非官方工具，依赖逆向工程协议，API 变更可能导致功能中断
- 令牌安全：长期有效的本地令牌若泄露，可导致账号数据被窃取
- 数据时效性：实时性取决于 Garmin Connect 同步频率，非医疗设备精度
适用人群
适合量化自我（Quantified Self）实践者、运动科学研究者、数据分析师，以及希望将 Garmin 数据集成至个人健康工作流的技术用户。不适合医疗诊断场景或寻求官方支持的企业环境。
安全风险评级
令牌本地存储机制存在中等泄露风险，建议配合系统级密钥管理（如 macOS Keychain、Linux Secret Service）。工具本身 MIT 协议开源，但依赖非官方 API，存在服务中断可能。