核心用法
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 同时写入可能产生数据异常