什么是Hevy
Hevy CLI 是一款专为健身爱好者设计的命令行工具，用于与 Hevy 健身追踪 API 进行交互。它允许用户通过简洁的命令行界面查询和管理自己的锻炼数据，包括详细的训练记录、健身计划、动作模板以及历史进度。该工具的核心定位是帮助用户快速获取个人健身信息，而无需依赖图形化应用或网页端操作。要使用 Hevy CLI，用户必须拥有 Hevy Pro 订阅权限，并通过官网开发者设置页面获取专属 API 密钥，随后在终端中配置环境变量以完成身份验证。一旦设置完成，用户即可通过一系列直观的指令访问其完整的健身数据库，实现自动化查询和数据提取。 Hevy CLI 的设计注重实用性与效率，特别适合习惯使用终端或希望将健身数据集成到脚本流程中的高级用户。它不仅支持查看最近几次训练内容，还能深入展示单次锻炼的每一个细节，如使用的重量、组数、次数及备注信息。此外，用户可以通过搜索功能快速定位特定动作（例如“卧推”），并查看其在不同时间段内的表现变化，从而有效监控长期训练进展。对于制定新训练计划的用户而言，CLI 提供了创建和更新自定义训练方案的能力，支持从 JSON 文件或标准输入流导入结构化数据，极大提升了批量操作的便利性。 尽管 Hevy CLI 主要聚焦于读取类操作，它也开放了部分写入接口，允许程序化地新建训练记录、调整训练计划或添加个性化动作模板。不过需要注意的是，由于 API 限制，删除或修改已有动作模板的功能不可用，相关变更仍需通过官方移动应用手动处理。整体来看，Hevy CLI 是一个高度集成、响应迅速的工具，旨在为深度用户提供一个轻量级但功能强大的健身数据管理入口。
核心功能特点
- 支持查询最近锻炼记录及详细训练日志，可指定数量或获取全部历史数据
- 提供按肌肉群筛选动作模板的功能，便于查找针对特定部位的自定义练习
- 具备完整的训练计划管理能力，包括创建、更新和导入 JSON 格式的 Routine 文件
- 集成运动历史追踪机制，可视化展示某项动作随时间推移的重量与次数变化趋势
- 支持以 JSON 格式输出所有查询结果，方便与其他系统对接或进一步分析处理
适用场景
Hevy CLI 最典型的应用场景是当用户想要快速回顾自己最近的健身房活动时。例如，如果用户询问“我上周都做了哪些训练？”，只需运行 `hevy workouts` 命令即可获得最近五次锻炼的完整列表。若需查看更多内容，可通过 `–limit 10` 参数扩展显示范围；而使用 `–all` 则可一次性拉取全部历史记录，适合做月度总结或数据备份。这种即时反馈机制让用户无需打开手机 App 就能掌握训练概况，尤其适用于通勤途中或远程办公环境下的快速查阅。 另一个高频使用场景涉及训练进度的监控与分析。比如用户关心“我的卧推力量有没有进步？”，此时可以先通过 `hevy exercises –search “bench press”` 找到对应的动作模板 ID，再执行 `hevy history ` 查看该动作的历史数据。CLI 会以清晰的时间线形式呈现每次训练的负重与重复次数，帮助用户识别平台期或突破点。结合 `–json` 选项输出的结构化数据，还可被外部脚本自动解析，生成图表或发送周报提醒，实现个人健身数据的智能化管理。 对于有系统性训练规划需求的用户，Hevy CLI 同样表现出色。无论是想建立新的分化训练方案（如“推日”、“拉日”），还是调整现有 Routine 的结构，都可以借助 CLI 提供的创建与更新命令高效完成。用户只需准备好符合规范的 JSON 文件，即可通过管道符或文件路径将其上传至账户。同时，CLI 还支持创建独立的文件夹来分类存放不同类型的训练计划，保持资料井井有条。这些功能不仅简化了日常维护工作，也为长期使用同一套体系训练的人提供了可持续的技术支撑。