用途
garmin-connect 是一个命令行工具（CLI），用于查询和管理 Garmin Connect 的健身与健康数据，包括活动记录、运动员统计、睡眠、心率、压力、身体电量、训练状态与准备度、VO2 Max、HRV 以及体重等。当用户需要查看或管理 Garmin 账户中的这类数据时，可使用该工具。
前置条件
-
安装 CLI：
curl -fsSL https://raw.githubusercontent.com/eddmann/garmin-connect-cli/main/install.sh | sh
-
身份验证：
garmin-connect auth login
使用邮箱和密码登录，支持多因素认证（MFA）。
快速上下文
通过一次调用获取聚合数据：
garmin-connect context # 完整上下文：个人资料、统计、健康、活动
garmin-connect context --activities 10 # 获取更多近期活动
garmin-connect context --focus stats,health # 仅指定部分
garmin-connect context
命令
运行 garmin-connect --help 或 garmin-connect <command> --help 可查看所有选项。
活动（Activities）
garmin-connect activities list [--after DATE] [--before DATE] [--limit N] [--type TYPE]
garmin-connect activities get <ID> [--details]
garmin-connect activities splits <ID>
garmin-connect activities download <ID> [--format TCX|GPX|FIT] [-o FILE]
garmin-connect activities upload <FILE>
garmin-connect activities delete <ID> [--force]
运动员（Athlete）
garmin-connect athlete # 个人资料
garmin-connect athlete stats # 每日统计数据
garmin-connect athlete summary # 综合统计 + 身体指标
健康（Health）
garmin-connect health sleep [--date DATE]
garmin-connect health heart-rate [--date DATE]
garmin-connect health steps [--date DATE]
garmin-connect health stress [--date DATE]
garmin-connect health body-battery [--date DATE]
garmin-connect health rhr [--date DATE]
训练（Training）
garmin-connect training status [--date DATE] # 例如 Productive、Peaking
garmin-connect training readiness [--date DATE] # 准备度分数（0-100）
garmin-connect training vo2max [--date DATE]
garmin-connect training hrv [--date DATE]
garmin-connect training fitness-age
体重（Weight）
garmin-connect weight list [--start DATE] [--end DATE]
garmin-connect weight get [--date DATE]
garmin-connect weight log <WEIGHT_KG> [--date DATE]
数据单位
| 字段 | 单位 |
|---|---|
| distance | 米 |
| duration、movingTime | 秒 |
| averageSpeed、maxSpeed | 米/秒 |
| elevation | 米 |
| dates | ISO8601 |
常见用法
# 近期活动
garmin-connect activities list --limit 10
# 本月活动
garmin-connect activities list --after 2025-12-01
# 使用 jq 过滤
garmin-connect activities list | jq '[.[] | select(.activityType.typeKey=="running")]'
# 总距离
garmin-connect activities list | jq '[.[].distance] | add'
认证状态
garmin-connect auth status # 检查是否已认证
garmin-connect auth login # 使用邮箱/密码登录（支持 MFA）
garmin-connect auth logout # 清除已存储的令牌
活动类型
running、cycling、swimming、walking、hiking、trail_running、open_water_swimming、indoor_cycling、virtual_cycling、strength_training、cardio、yoga、pilates、elliptical、indoor_rowing、other
退出码
- 0 = 成功
- 1 = 一般错误
- 2 = 认证错误（请运行 garmin-connect auth login）
限制
资料中未提供关于平台支持、收费、价格、效果或其他未提及功能的信息。