名称： hevy
描述： 查询 Hevy 的健身数据，包括训练记录、训练计划、动作模板和历史记录。当用户询问其训练情况、健身课程、运动进展或健身计划时使用。
主页： https://hevy.com
元数据：
clawdbot:
emoji: "🏋️"
requires:
bins: ["hevy"]
env: ["HEVY_API_KEY"]

Hevy CLI

用于 Hevy 健身追踪 API 的命令行工具。可查询训练记录、训练计划、动作模板并追踪进度。

设置

需要 Hevy Pro 订阅以获得 API 访问权限。

1. 从 https://hevy.com/settings?developer 获取 API 密钥。
2. 设置环境变量：export HEVY_API_KEY="你的密钥"

命令

状态

# 检查配置和连接状态
hevy status

训练记录

# 列出最近的训练记录（默认5条）
hevy workouts
hevy workouts --limit 10

# 获取所有训练记录
hevy workouts --all

# 显示详细的训练记录
hevy workout <训练记录-id>

# 输出 JSON 格式
hevy workouts --json
hevy workout <id> --json

# 以公斤显示重量（默认为磅）
hevy workouts --kg

训练计划

# 列出所有训练计划
hevy routines

# 显示详细的训练计划
hevy routine <训练计划-id>

# 输出 JSON 格式
hevy routines --json

动作模板

# 列出所有动作模板
hevy exercises

# 按名称搜索
hevy exercises --search "卧推"

# 按肌群筛选
hevy exercises --muscle chest

# 仅显示自定义动作
hevy exercises --custom

# 输出 JSON 格式
hevy exercises --json

动作历史

# 显示特定动作的历史记录
hevy history <动作模板-id>
hevy history <动作模板-id> --limit 50

# 输出 JSON 格式
hevy history <动作模板-id> --json

创建训练计划

# 从 JSON（标准输入）创建训练计划
echo '{"routine": {...}}' | hevy create-routine

# 从文件创建训练计划
hevy create-routine --file routine.json

# 创建训练计划文件夹
hevy create-folder "推拉腿计划"

# 更新现有训练计划
echo '{"routine": {...}}' | hevy update-routine <训练计划-id>

# 创建自定义动作（会先检查重复项！）
hevy create-exercise --title "我的动作" --muscle chest --type weight_reps

# 即使存在重复项也强制创建
hevy create-exercise --title "我的动作" --muscle chest --force

⚠️ 重复项预防： create-exercise 命令会检查是否已存在同名动作，如果发现则会报错。使用 --force 参数可强制创建（不推荐）。

训练计划 JSON 格式：

{
  "routine": {
    "title": "推日 💪",
    "folder_id": null,
    "notes": "胸、肩、三头肌",
    "exercises": [
      {
        "exercise_template_id": "79D0BB3A",
        "notes": "注意动作标准",
        "rest_seconds": 90,
        "sets": [
          { "type": "warmup", "weight_kg": 20, "reps": 15 },
          { "type": "normal", "weight_kg": 60, "reps": 8 }
        ]
      }
    ]
  }
}

其他

# 训练记录总数
hevy count

# 列出训练计划文件夹
hevy folders

使用示例

用户提问："我上次在健身房练了什么？"

hevy workouts

用户提问："给我看看我上次的胸部训练"

hevy workouts --limit 10  # 找到相关的训练记录 ID
hevy workout <id>         # 获取详细信息

用户提问："我的卧推进展如何？"

hevy exercises --search "卧推"  # 获取动作模板 ID
hevy history <动作-id>          # 查看进展

用户提问："我有哪些训练计划？"

hevy routines
hevy routine <id>  # 查看详情

用户提问："找一些腿部动作"

hevy exercises --muscle quadriceps
hevy exercises --muscle hamstrings
hevy exercises --muscle glutes

用户提问："创建一个推日训练计划"

# 1. 查找动作 ID
hevy exercises --search "卧推"
hevy exercises --search "肩推"
# 2. 使用这些 ID 创建训练计划 JSON，并通过管道传递给 create-routine

注意事项

• 重复项预防： create-exercise 命令在创建前会检查是否存在同名动作。使用 --force 参数可强制覆盖（不推荐）。
• API 限制： Hevy API 不支持删除或编辑动作模板——仅支持创建。如需删除动作，请在 App 中手动操作。
• API 速率限制： 获取所有数据时（使用 --all 标志）请注意。
• 重量单位： 默认使用磅，使用 --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 客户端以编程方式使用。