Garmin Cli

核心用法

Garmin CLI (gc) 是一个命令行工具，用于访问 Garmin Connect 平台的健康、健身和活动数据。安装通过 Homebrew 完成，首次使用需执行 gc login 完成邮箱/密码认证（支持 MFA）。

主要功能模块包括：

• 日常健康数据：步数、心率、睡眠、压力、Body Battery、血氧、呼吸频率等
• 活动管理：查询、筛选、下载（FIT/GPX/TCX 等格式）、上传活动文件
• 进阶指标：VO2max、HRV、训练准备度、乳酸阈值、FTP、耐力评分等
• 训练计划：创建/编辑/删除结构化训练（支持 JSON 定义），查询训练计划
• 设备管理：设备列表、设置、闹钟、太阳能充电数据
• 原始 API：直接调用 Garmin Connect 内部 API 端点

日期支持灵活快捷方式（today/yesterday/week/month）或具体日期格式，输出默认可读表格，建议 --format json 用于程序化解析。

显著优点

• 数据维度极全：覆盖消费级可穿戴设备中最丰富的生理指标，尤其受耐力运动员青睐
• 批量化与自动化：CLI 形式便于脚本化，适合定时同步、数据备份、与其他系统集成
• 训练结构化支持：可创建复杂间歇训练并同步至 Garmin 设备，替代官方 App 的手动操作
• 原始 API 暴露：高级用户可直接调用未公开的内部接口，扩展性极强

潜在缺点与局限性

• 非官方实现：基于反向工程，API 可能随时变更导致功能失效
• 认证安全风险：需明文存储或使用交互式登录，MFA 支持存在但流程繁琐
• 无图形界面：数据可视化需用户自行处理，对普通消费者门槛较高
• 依赖 Homebrew 分发：Linux/Windows 用户需额外适配，安装链路较长
• 隐私合规模糊：数据经第三方 CLI 中转，敏感健康信息存在泄露风险

适合人群

• 数据分析师与量化自我（QS）爱好者
• 铁三/马拉松等耐力项目运动员及教练
• 需要自动化备份 Garmin 数据的开发者
• 希望绕过官方 App 限制的高级用户

常规风险

• 账号封禁：非官方工具违反 Garmin Connect 服务条款，存在封号可能
• 凭证泄露：密码/MFA 码在命令历史中留存风险
• 数据准确性：API 变更或解析错误可能导致指标失真
• 同步冲突：CLI 操作与官方 App 同时写入可能产生数据异常

核心用法

Garmin 技能是一款纯文档型 Skill，为用户提供 gc 命令行工具的操作指南，用于非交互式访问 Garmin Connect 平台的健康、健身与活动数据。

主要功能模块

| 模块 | 典型命令 | 数据维度 |

|------|---------|---------|

| 日常健康 | `gc health today`, `gc steps week` | 步数、爬楼、活动强度 |

| 心率监测 | `gc heart resting --date today` | 静息心率、全天心率 |

| 睡眠分析 | `gc sleep today` | 睡眠阶段、睡眠质量 |

| 压力与体能 | `gc stress --weekly`, `gc battery today` | 压力指数、Body Battery |

| 运动记录 | `gc activities --type running` | GPS 轨迹、配速、心率区间 |

| 进阶指标 | `gc metrics vo2max today` | VO₂max、HRV、训练准备度、乳酸阈值 |

| 设备管理 | `gc devices`, `gc devices solar DEVICE_ID` | 设备状态、太阳能充电 |

| 训练计划 | `gc workouts create --file workout.json` | 结构化训练、间歇课程 |

输出格式

所有数据命令支持 --format json 机器可读输出，便于程序化分析和集成。

显著优点

1. 数据维度全面：覆盖 Garmin Connect 绝大多数数据类型，从基础步数到专业训练指标
2. 自动化友好：非交互式 CLI 设计，支持脚本化和定时任务
3. 日期快捷方式：内置 today/yesterday/week/month 等语义化日期参数
4. 训练课程可编程：支持 JSON 格式创建结构化训练，可精确控制间歇、目标心率/功率区间
5. 原始 API 访问：gc api 命令允许直接调用 Garmin Connect 内部 API，扩展性强

潜在缺点与局限性

1. 外部依赖：需单独安装 gc 二进制工具（通过 Homebrew），Skill 本身仅为文档
2. 认证风险：需明文提供 Garmin 账号密码，存在凭证管理挑战
3. 无官方背书：gc 为社区逆向工程实现，非 Garmin 官方工具，存在 API 变更风险
4. T3 来源可信度：发布者为个人开发者，无企业级维护保障
5. 许可证不明：当前未声明开源协议

适合人群

• 量化自我爱好者：需要自动化导出和分析 Garmin 数据的用户
• 运动员/教练：需要批量处理训练数据、生成周报的专业用户
• 开发者：希望将 Garmin 数据集成到自建健康平台的技术人员
• 数据分析师：需要原始 JSON 格式数据进行深度挖掘的用户

常规风险

| 风险类别 | 具体描述 | 缓解建议 |

|---------|---------|---------|

| 凭证泄露 | `gc login` 需邮箱密码，存在历史命令记录风险 | 使用环境变量传递凭证，避免 shell history |

| API 稳定性 | 非官方 API，Garmin 可能随时更改或限制 | 关注项目更新，避免关键业务强依赖 |

| 数据隐私 | 健康数据属于高度敏感个人信息 | 确保本地存储安全，定期审查访问日志 |

| 供应链安全 | Homebrew tap 非官方渠道 | 审计 `voydz/homebrew-tap` 来源可信度 |