用途
Hevy CLI 是 Hevy 健身追踪 API 的命令行工具，用于查询训练记录（workouts）、训练计划（routines）、动作模板（exercises）以及动作历史，并支持创建训练计划、训练计划文件夹和自定义动作。适合在终端中快速查看健身数据、追踪某个动作的进步情况，或通过脚本批量创建训练计划。
主要能力
- 状态检查：
hevy status检查配置与连接。 - 训练记录：
hevy workouts列出最近训练（默认 5 条），支持--limit、--all、--json、--kg；hevy workout <workout-id>查看单次训练详情。 - 训练计划：
hevy routines列出全部计划，hevy routine <routine-id>查看详情，支持--json。 - 动作模板：
hevy exercises列出全部动作模板，支持--search按名称搜索、--muscle按肌群筛选、--custom仅显示自定义动作、--json。 - 动作历史：
hevy history <exercise-template-id>查看指定动作的历史，支持--limit与--json。 - 创建与更新：
hevy create-routine（从 stdin 或--file读取 JSON）、hevy create-folder、hevy update-routine <routine-id>、hevy create-exercise。 - 其他：
hevy count统计训练总数，hevy folders列出计划文件夹。
使用方式
需要 Hevy Pro 订阅才能访问 API。从 https://hevy.com/settings?developer 获取 API 密钥，并设置环境变量：
export HEVY_API_KEY="your-key"
常用示例：
- 查看最近训练：
hevy workouts - 查看某次训练详情：先
hevy workouts --limit 10找到 ID，再hevy workout <id> - 查看卧推进步：
hevy exercises --search "bench press"获取动作模板 ID，再hevy history <exercise-id> - 查看训练计划：
hevy routines，详情用hevy routine <id> - 查找腿部动作：
hevy exercises --muscle quadriceps、hevy exercises --muscle hamstrings、hevy exercises --muscle glutes - 创建推日计划：先用
hevy exercises --search找到动作 ID，再构造 JSON 通过create-routine创建。
训练计划 JSON 格式示例：
{ "routine": { "title": "Push Day 💪", "folder_id": null, "notes": "Chest, shoulders, triceps", "exercises": [ { "exercise_template_id": "79D0BB3A", "notes": "Focus on form", "rest_seconds": 90, "sets": [ { "type": "warmup", "weight_kg": 20, "reps": 15 }, { "type": "normal", "weight_kg": 60, "reps": 8 } ] } ] } }
适用场景
- 用户询问“我在健身房做了什么”时，运行
hevy workouts。 - 用户询问“显示我上次胸部训练”时，先列出训练找到 ID，再查看详情。
- 用户询问“我的卧推进展如何”时，搜索动作模板并查看历史。
- 用户询问“我有哪些训练计划”时，列出计划并查看详情。
- 用户询问“查找腿部动作”时，按肌群筛选动作模板。
- 用户要求“创建推日计划”时，查找动作 ID 后构造 JSON 创建。
限制
- 需要 Hevy Pro 订阅才能访问 API。
- 重复预防：
create-exercise会先检查同名动作是否存在，若存在则报错；可用--force强制创建（不推荐）。 - API 限制：Hevy API 不支持删除或编辑动作模板，仅支持创建；删除动作需在 App 中手动操作。
- API 速率限制：使用
--all获取全部数据时需注意。 - 重量单位：默认 lbs，使用
--kg切换为千克。 - 分页：多数命令自动分页，
--limit可减少 API 调用。 - ID：训练/计划/动作 ID 为 UUID，在详情视图中显示。
API 参考
完整 API 文档：https://api.hevyapp.com/docs/
可用端点：
- GET /v1/workouts - 列出训练（分页）
- GET /v1/workouts/{id} - 获取单次训练
- GET /v1/workouts/count - 训练总数
- GET /v1/routines - 列出计划
- GET /v1/routines/{id} - 获取单个计划
- GET /v1/exercise_templates - 列出动作
- GET /v1/exercise_templates/{id} - 获取单个动作
- GET /v1/exercise_history/{id} - 动作历史
- GET /v1/routine_folders - 列出文件夹
写操作（支持但需谨慎使用）：
- POST /v1/workouts - 创建训练
- PUT /v1/workouts/{id} - 更新训练
- POST /v1/routines - 创建计划
- PUT /v1/routines/{id} - 更新计划
- POST /v1/exercise_templates - 创建自定义动作
- POST /v1/routine_folders - 创建文件夹
CLI 侧重于读操作，写操作可通过 API 客户端以编程方式使用。