核心功能与用法
Hevy CLI 是一款面向 Hevy Pro 订阅用户的命令行工具，用于本地访问和分析个人健身数据。核心功能包括：训练历史查询（支持分页和 JSON 导出）、单次训练详情获取（含组数、重量、次数）、训练模板浏览、以及原始数据的结构化导出。
典型工作流：先通过 hevycli workouts list 查看近期训练，再用短 ID 或完整 UUID 调用 workouts get 获取详细数据，最后以 --format json 导出进行自定义分析。该工具仅支持读取操作，无法创建或修改训练记录。
显著优点
1. 数据自主权：打破 App 限制，用户可直接获取原始 JSON 数据，便于使用 Python、R 等工具进行深度分析
2. 终端友好：支持短 ID（8 字符）快速查询，表格/JSON 双格式输出适配不同场景
3. 轻量高效：Go 编写，单二进制文件，跨平台运行
局限性与风险
- 订阅门槛：必须持有 Hevy Pro 才能生成 API key，免费用户无法使用
- 只读限制：无法同步修改数据，训练记录仍需在移动端 App 创建
- 数据范围：单次最多返回 10 条记录，大量历史数据需分页拉取
- 格式依赖：重量统一为公斤，距离为米，需自行单位换算
适合人群
- 希望用 Excel/Python 自定义分析训练数据的量化健身爱好者
- 需要将健身数据与其他健康数据源（如 Apple Health）整合的高级用户
- 习惯终端工作流的开发者群体
常规风险提示
- API key 以明文存储于本地配置文件，多人共用设备时存在泄露风险
- 导出的 JSON 文件包含完整训练历史，需注意本地文件安全
- 第三方 CLI 非 Hevy 官方出品，API 变更可能导致工具失效