Garmin Connect CLI，支持活动、健康、体成分、训练、设备、装备、目标等管理。
gccli. 使用gccli来连接 Garmin 健康,健身和活动数据. 要求 Garmin SSO 认证.. .
功能概述
gccli. 使用gccli来连接 Garmin 健康,健身和活动数据. 要求 Garmin SSO 认证.. .是一项面向实际任务的技能，主要用于Setup (once). gccli auth 登录@example.com (打开 Garmin SSO 的浏览器). 头无: g。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
核心要点
- 使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
- 从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
- 实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；
使用与执行
若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；
结果检查与注意事项
涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。
gccli
使用 gccli 访问 Garmin Connect 的健康、健身与活动数据。需通过 Garmin 单点登录（SSO）进行身份验证。
初始化配置（仅需执行一次）
gccli auth login you@example.com（自动打开浏览器完成 Garmin SSO 登录）- 无头模式：
gccli auth login you@example.com --headless（若启用多因素认证（MFA），需附加--mfa-code参数） - 设置默认账户：
export GCCLI_ACCOUNT=you@example.com - 验证登录状态：
gccli auth status
输出格式
- 默认：人类可读的表格形式。使用
--json/-j获取 JSON 格式，--plain获取 TSV 格式。 - 数据输出至 stdout，日志与错误信息输出至 stderr。
- 在程序化解析输出时，请始终使用
--json。
日期快捷写法
today、yesterday、3d（N 天前）、YYYY-MM-DD（指定日期）。- 使用
--start/--end参数指定日期范围。
常用命令
- 认证状态：
gccli auth status - 获取认证令牌（适用于脚本）：
gccli auth token - 导出凭证：
gccli auth export（可重定向至文件，或复制到其他机器） - 导入凭证：
gccli auth import（输入来自auth export的输出） - 移除凭证：
gccli auth remove - 列出活动：
gccli activities list --limit 20 - 按类型列出活动：
gccli activities list --type running - 活动总数：
gccli activities count - 搜索活动：
gccli activities search --start-date 2024-01-01 --end-date 2024-12-31 - 活动摘要：
gccli activity summary - 活动详情：
gccli activity details - 活动分段数据：
gccli activity splits - 活动天气信息：
gccli activity weather - 活动心率区间：
gccli activity hr-zones - 活动功率区间：
gccli activity power-zones - 活动训练组（查看）：
gccli activity exercise-sets - 设置训练组：
gccli activity exercise-sets set-e "CATEGORY/NAME:reps@weightkg[:dSECS][:rSECS]" [-e ...] - 活动所用装备：
gccli activity gear - 下载活动（FIT 格式）：
gccli activity download--format fit - 下载活动（GPX 格式）：
gccli activity download--format gpx --output track.gpx - 上传活动：
gccli activity upload ./activity.fit - 创建手动活动：
gccli activity create --name "Morning Run" --type running --date 2024-06-15T07:30:00 --duration 1800 --distance 5000 - 重命名活动：
gccli activity rename"New Name" - 修改活动类型：
gccli activity retyperunning - 删除活动：
gccli activity delete--force - 活动类型列表：
gccli activities types - 健康摘要：
gccli health summary [date] - 步数图表：
gccli health steps [date] - 每日步数范围：
gccli health steps daily --start 2024-01-01 --end 2024-01-31 - 每周步数：
gccli health steps weekly --weeks 4 - 心率：
gccli health hr [date] - 静息心率：
gccli health rhr [date] - 爬楼层数：
gccli health floors [date] - 睡眠数据：
gccli health sleep [date] - 呼吸频率：
gccli health respiration [date] - 血氧饱和度（SpO₂）：
gccli health spo2 [date] - 心率变异性（HRV）：
gccli health hrv [date] - 压力指数：
gccli health stress [date] - 每周压力指数：
gccli health stress weekly --weeks 4 - 身体电量（Body Battery）：
gccli health body-battery [date] - 身体电量范围：
gccli health body-battery range --start 2024-01-01 --end 2024-01-07 - 训练准备度：
gccli health training-readiness [date] - 训练状态：
gccli health training-status [date] - 体能年龄：
gccli health fitness-age [date] - VO₂max 及最大指标：
gccli health max-metrics [date] - 乳酸阈值：
gccli health lactate-threshold - 骑行 FTP 值：
gccli health cycling-ftp - 比赛成绩预测：
gccli health race-predictions [date] - 比赛成绩预测范围：
gccli health race-predictions range --start 2024-01-01 --end 2024-06-30 - 耐力得分：
gccli health endurance-score [date] - 爬坡得分：
gccli health hill-score [date] - 强度分钟数：
gccli health intensity-minutes [date] - 每周强度分钟数：
gccli health intensity-minutes weekly --start 2024-01-01 --end 2024-01-31 - 健康事件：
gccli health events [date] - 身体成分：
gccli body composition [date] - 身体成分范围：
gccli body composition --start 2024-01-01 --end 2024-01-31 - 体重记录：
gccli body weigh-ins --start 2024-01-01 --end 2024-01-31 - 添加体重：
gccli body add-weight 75.5 --unit kg - 添加身体成分：
gccli body add-composition 75.5 --body-fat 15.2 --muscle-mass 35.0 - 血压数据：
gccli body blood-pressure --start 2024-01-01 --end 2024-01-31 - 添加血压记录：
gccli body add-blood-pressure --systolic 120 --diastolic 80 --pulse 65 - 列出训练计划：
gccli workouts list --limit 20 - 训练计划详情：
gccli workouts detail - 下载训练计划（FIT 格式）：
gccli workouts download--output workout.fit - 上传训练计划（JSON 格式）：
gccli workouts upload ./workout.json - 安排训练计划：
gccli workouts schedule add2024-06-20 - 列出某日已安排的训练计划：
gccli workouts schedule list 2024-06-20 - 列出某日期范围内已安排的训练计划：
gccli workouts schedule list --start 2024-06-01 --end 2024-06-30 - 移除已安排的训练计划：
gccli workouts schedule remove（使用--force跳过确认提示） - 删除训练计划：
gccli workouts delete - 创建含配速目标的跑步训练计划：
gccli workouts create "Easy Run" --type run --step "warmup:5m" --step "run:20m@pace:5:00-5:30" --step "cooldown:5m" - 创建含心率目标的跑步训练计划：
gccli workouts create "HR Run" --type run --step "warmup:10m" --step "run:20m@hr:140-160" --step "cooldown:10m" - 创建含功率目标的骑行训练计划：
gccli workouts create "FTP Intervals" --type bike --step "warmup:10m" --step "run:5m@power:250-280" --step "recovery:3m" --step "run:5m@power:250-280" --step "cooldown:10m" - 列出课程：
gccli courses list - 收藏的课程：
gccli courses favorites - 课程详情：
gccli courses detail - 从 GPX 文件导入课程（默认类型为 cycling，隐私设置为 private）：
gccli courses import route.gpx - 导入课程并指定名称：
gccli courses import route.gpx --name "Sunday Ride" - 导入课程并指定类型：
gccli courses import route.gpx --type gravel_cycling - 导入公开课程：
gccli courses import route.gpx --privacy 1 - 将课程发送至设备：
gccli courses send - 删除课程：
gccli courses delete（使用-f跳过确认提示） - 列出设备：
gccli devices list - 设备设置：
gccli devices settings - 主设备：
gccli devices primary - 最近使用的设备：
gccli devices last-used - 设备闹钟：
gccli devices alarms - 太阳能数据：
gccli devices solar--start 2024-06-01 --end 2024-06-30 - 列出装备：
gccli gear list - 装备统计：
gccli gear stats - 装备关联的活动：
gccli gear activities--limit 20 - 装备默认设置：
gccli gear defaults - 绑定装备：
gccli gear link - 解绑装备：
gccli gear unlink - 目标列表：
gccli goals list --status active - 已获得徽章：
gccli badges earned - 可获取徽章：
gccli badges available - 进行中徽章：
gccli badges in-progress - 挑战列表：
gccli challenges list - 徽章类挑战：
gccli challenges badge - 个人纪录：
gccli records - 用户档案：
gccli profile - 档案设置：
gccli profile settings - 水分摄入：
gccli hydration [date] - 记录饮水量：
gccli hydration add 500 - 营养食物日志：
gccli nutrition [date] - 营养餐食：
gccli nutrition meals [date] - 营养设置：
gccli nutrition settings [date] - 训练计划：
gccli training plans --locale en - 训练计划详情：
gccli training plan - 月经周期：
gccli wellness menstrual-cycle --start-date 2024-01-01 --end-date 2024-03-31 - 孕期摘要：
gccli wellness pregnancy-summary - 事件列表：
gccli events list - 从指定日期起列出事件：
gccli events list --start 2024-06-01 --limit 50 - 添加事件：
gccli events add --name "Berlin Marathon" --date 2026-09-27 --type running --race --location "Berlin, Germany" --distance 42.195km --time 09:15 --timezone Europe/Berlin - 添加含目标及训练优先级的事件：
gccli events add --name "Spring 10K" --date 2026-05-10 --type running --race --distance 10km --goal 40m --training - 删除事件：
gccli events delete（使用-f跳过确认提示） - 重新加载数据：
gccli reload [date] - 列出训练动作分类：
gccli exercises list - 列出某分类下的训练动作：
gccli exercises list -c BENCH_PRESS - 以 JSON 格式列出训练动作：
gccli exercises list --json
力量训练工作流（LLM 辅助的动作匹配）
当用户希望以自由文本方式记录力量训练活动（例如：“Bench Press 3x12@20kg, Lat Pulldowns 3x12@41kg”）时，请按以下流程操作：
- 获取 Garmin 训练动作目录：
gccli exercises list --json - 将用户描述的每个动作映射到最匹配的 Garmin CATEGORY/EXERCISE_NAME 组合。该目录使用 SCREAMING_SNAKE_CASE 命名规范（例如：BENCH_PRESS/BARBELL_BENCH_PRESS、PULL_UP/WIDE_GRIP_LAT_PULLDOWN、LATERAL_RAISE/DUMBBELL_LATERAL_RAISE、LUNGE/DUMBBELL_LUNGE、CALF_RAISE/STANDING_BARBELL_CALF_RAISE）。请根据语义和上下文判断最接近的匹配项。
- 向用户展示建议的映射结果，并在继续前请求确认。
- 创建活动：
gccli activity create --name "Upper Body" --type strength_training --duration 34m --date 2024-06-15T19:01:00 - 从输出中提取活动 ID（JSON 输出中为
activityId字段；表格输出中为 “Created activity”）。 - 添加训练组：
gccli activity exercise-sets set-e "CATEGORY/NAME:reps@weightkg[:dSECS][:rSECS]" [-e ...]
训练组格式：CATEGORY/NAME:reps@weightkg[:dSECS][:rSECS]
- CATEGORY：训练动作分类（如 BENCH_PRESS、PULL_UP、LATERAL_RAISE、LUNGE、CALF_RAISE）
- NAME：该分类下的具体动作名称（如 BARBELL_BENCH_PRESS、WIDE_GRIP_LAT_PULLDOWN）
- reps：重复次数
- weightkg：重量（单位 kg），例如 20 表示 20kg，41.5 表示 41.5kg，0 表示自重
- :dSECS：可选，该组持续时间（秒），例如 :d30 表示 30 秒
- :rSECS：可选，该组结束后的休息时间（秒），例如 :r60 表示 60 秒
每个 -e 参数对应一组训练。若需录入 3 组 12 次，则需使用三个带相同动作的 -e 参数。
完整工作流示例：
gccli activity create --name "Upper Body" --type strength_training --duration 34m --date 2026-03-13T19:01:00 --json # 从 JSON 响应中提取 activityId gccli activity exercise-sets set-e "PULL_UP/WIDE_GRIP_LAT_PULLDOWN:12@41:d30:r60" -e "PULL_UP/WIDE_GRIP_LAT_PULLDOWN:12@41:d30:r60" -e "PULL_UP/WIDE_GRIP_LAT_PULLDOWN:12@41:d30:r90" -e "LATERAL_RAISE/DUMBBELL_LATERAL_RAISE:12@8:d25:r60" -e "LATERAL_RAISE/DUMBBELL_LATERAL_RAISE:12@8:d25:r60" -e "LATERAL_RAISE/DUMBBELL_LATERAL_RAISE:12@8:d25:r90" -e "BENCH_PRESS/BARBELL_BENCH_PRESS:12@20:d30:r60" -e "BENCH_PRESS/BARBELL_BENCH_PRESS:8@20:d35:r60" -e "BENCH_PRESS/BARBELL_BENCH_PRESS:5@20:d40"
注意事项
- 设置环境变量
GCCLI_ACCOUNT=you@example.com可避免重复指定--account参数。 - 编写脚本时，请使用
--json获取结构化 JSON 输出，或使用--plain获取制表符分隔（TSV）输出。 - 日期支持
today、yesterday、3d或YYYY-MM-DD格式。 - 认证令牌安全存储于操作系统密钥环中（macOS Keychain、Linux Secret Service，或降级为本地文件存储）。
- 遇到 HTTP 401 错误时令牌自动刷新；遇到 HTTP 429 或 5xx 错误时自动重试，采用指数退避策略。
- Garmin 中国账户用户请设置：
export GCCLI_DOMAIN=garmin.cn。 - 删除活动或训练计划前会要求确认（可使用
--force跳过）。 - 支持的下载格式包括：FIT（默认）、GPX、TCX、KML、CSV。
- 训练计划步骤格式为：
type:duration[@target:low-high]—— 其中 type 可为 warmup、run、recovery、cooldown；target 可为 pace（分:秒）、hr（bpm）、power（瓦特）、cadence（踏频）。
相关专题
Gradle插件开发入门教程
本专题介绍Gradle插件开发的基本流程，涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法，帮助你理解插件如何组织构建逻辑，减少多个项目之间的重复配置。
2026.10.22
0
11
Gradle Wrapper配置教程
本专题介绍Gradle Wrapper的基本作用，涵盖文件组成、生成方法、版本配置和任务调用，帮助你理解项目如何使用指定的Gradle版本，减少不同开发环境带来的构建差异。
2026.10.22
0
10
Golangci-lint检查器使用教程
本专题整理Golangci-lint常用Linters的用途与配置方法，覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查，帮助项目合理选规则。
2026.10.22
0
15
Gradle怎么构建Java项目
本专题介绍Gradle Java项目构建方法，涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查，帮助你理解各阶段的任务关系，逐步完成项目构建。
2026.10.22
0
10
PHP时间戳漏洞修复教程
本专题汇总PHP常见时间戳漏洞，包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等，并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案，帮助开发者快速排查和加固时间相关代码。
2026.10.22
0
25
Golangci-lint配置文件与规则设置
本专题聚焦Golangci-lint YAML配置文件，讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置，便于团队统一检查标准。
2026.10.22
0
15
Golangci-lint安装与入门教程
本专题讲解Golangci-lint的安装、初始化、基础命令和首次代码检查，覆盖本地环境、Docker及多平台用法，帮助Go开发者快速上手。
2026.10.22
0
15
PHP2Shell高危漏洞修复教程
PHP2Shell漏洞是什么，哪些PHP版本和运行环境会受到影响，服务器应该如何检测与修复？本专题提供版本自查脚本、Linux与Docker升级命令、PHP-FPM和Apache排查步骤，以及修复验证、临时缓解和应急响应方案。
2026.10.22
0
12
热门下载
相关下载
精品课程
热门推荐
/
最新课程
phpStudy极速入门视频教程
共6课时 | 54.7万人学习
独孤九贱(4)_PHP视频教程
共89课时 | 134.1万人学习
PHP实战天龙八部之仿爱奇艺电影网站
共49课时 | 82.5万人学习
最新文章