Hevy健身数据查询

技能简介

Hevy CLI 是连接 Hevy 健身应用的命令行工具，可查询个人训练记录、锻炼计划、动作库及历史进度。需配合 Hevy Pro 订阅使用。

业务背景

为健身爱好者与私教提供高效训练数据管理入口。无需打开App即可快速查询历史记录、调取锻炼计划、追踪特定动作的力量进步曲线，将分散的训练日志转化为可分析的进度资产，辅助科学调整负荷与周期安排。

落地案例：力量训练者想评估近三个月卧推进展，在命令行输入关键词搜索获取动作ID后，直接拉取该动作的负重、次数历史数据，生成可视化趋势，判断当前周期是否进入平台期，进而与教练沟通是否需要调整训练变量或切换计划模板。

能做什么

• 查看近期训练记录与详细内容
• 检索自定义或预设的锻炼计划
• 按肌肉群或名称搜索动作
• 追踪特定动作的负重/次数变化
• 创建新的训练计划或自定义动作

使用说明

安装前提

1. 订阅 Hevy Pro 以获取 API 权限
2. 从 开发者设置 获取 API Key
3. 安装 hevy 二进制文件并配置环境变量：export HEVY_API_KEY="your-key"

常用操作

查看最近5次训练：hevy workouts

查看特定训练详情：hevy workout <workout-id>

搜索卧推并查看进度：hevy exercises --search "bench press" 获取 ID 后执行 hevy history <exercise-id>

按肌肉群筛选动作：hevy exercises --muscle quadriceps

创建训练计划：先查询动作 ID，再组装 JSON 通过管道传入 hevy create-routine

输入与输出

见下方输入与输出表格。

风险提示

• 创建自定义动作时默认检查重名，强制覆盖可能导致数据混乱
• Hevy API 不支持删除或编辑已创建的动作模板，需在 App 内手动操作
• 全量拉取数据（–all）可能触发速率限制
• 重量单位默认为磅，需显式添加 –kg 切换

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/mjrussell/hevy/SKILL.md
来源类型：GitHub 仓库