核心功能与定位
Hevy CLI 是面向 Hevy Pro 订阅者的官方命令行工具，通过 Hevy 官方 API 实现健身数据的程序化访问。核心能力覆盖四大维度：训练记录检索（workouts）、动作模板管理（routines）、动作库查询（exercises）以及单项动作历史追踪（history）。
显著优点
1. 数据主权掌控：突破移动端限制，用户可将多年训练数据以结构化 JSON 导出，便于自定义分析或迁移
2. 精准查询能力：支持按肌肉群筛选（如 --muscle quadriceps）、自定义动作隔离（--custom）、以及基于 UUID 的历史追溯
3. 单位灵活切换：默认磅（lbs）与公制（kg）无缝切换，满足国际用户需求
4. 轻量无依赖：基于 Node.js 的单二进制部署，通过 npm 全局安装即可运行
局限性与约束
- 付费门槛：强制要求 Hevy Pro 订阅，免费用户无法获取 API 密钥
- 速率限制：官方 API 存在未明确公开的限流机制，大规模数据拉取（如
--all）可能触发限制 - 只读特性：当前版本仅支持查询，无法创建或修改训练记录，双向同步需依赖官方 App
- UUID 依赖：历史查询需先通过搜索获取 exercise-id，交互流程存在断层
适用人群
- 数据驱动的进阶健身者，需 Excel/Python 自定义分析训练周期
- 跨平台迁移用户，需批量导出历史数据
- 开发者构建健身类衍生工具（如自动化周报生成）
风险提示
API 密钥存储于本地环境变量，存在终端历史记录泄露风险；建议配合 .env 文件及权限管理使用。Hevy 作为商业化健身应用，API 稳定性与数据隐私政策受企业决策影响，长期依赖需关注服务条款变更。