核心用法
Hevy CLI 通过命令行界面桥接 Hevy 健身应用的 REST API，为开发者和高阶用户提供脱离移动端的数据操控能力。核心场景包括：
- 训练数据查询：
hevy workouts获取近期训练记录，hevy workout <id>查看单次训练详情，支持 JSON 输出便于管道处理 - 进度追踪：
hevy history <exercise-id>追踪特定动作的负荷/容量变化，配合--limit控制数据范围 - 训练计划管理：
hevy routines列出现有计划，hevy create-routine从 JSON 创建结构化方案，支持文件夹组织 - 动作库管理：
hevy exercises --search/--muscle检索动作模板，hevy create-exercise添加自定义动作（内置重复名称检测）
显著优点
1. API 原生封装：直接映射 Hevy 官方 API 端点，数据结构与应用内一致，无信息损耗
2. 管道友好：全系支持 --json 输出，可与 jq、脚本自动化无缝集成
3. 重复预防机制：创建自定义动作时自动检测同名项，避免库冗余
4. 单位灵活：默认磅制，可选 --kg 满足国际用户习惯
潜在局限
- 付费门槛：Hevy Pro 订阅（约 $3.99/月）为硬性前提，免费用户无法获取 API 密钥
- 只读为主：CLI 侧重查询，写操作（创建/更新）需手动构造 JSON，无交互式向导
- API 功能边界：不支持删除/编辑动作模板，需在移动端完成；无批量导入历史训练数据能力
- 无离线缓存：每次查询均调用 API，
--all大量数据时需注意速率限制
适合人群
- 数据驱动型健身者，希望用电子表格/脚本分析长期训练趋势
- 教练或程序员，需要批量生成或同步训练计划
- Hevy 重度用户，对移动端数据管理效率不满
常规风险
| 风险类型 | 说明 |
|---------|------|
| API 密钥泄露 | `HEVY_API_KEY` 环境变量若写入 `.bashrc` 等明文文件，存在凭证泄露风险 |
| 误操作覆盖 | `update-routine` 无确认交互，错误 JSON 可能覆盖现有计划 |
| 速率限制触发 | 高频调用 `--all` 或循环脚本可能被限流 |
| 数据锁定 | 若取消 Pro 订阅，API 访问立即失效，依赖自动化的工作流将中断 |