用途:把训练计划(文本、PDF、图片)转换为 Hevy 健身应用的训练套路 JSON,并通过 CLI 创建到账号中。
主要能力:认证、动作搜索、生成套路模板、创建套路。
基本用法: <skill-dir>/bin/hevy auth <key>(密钥来自 hevy.com/settings) <skill-dir>/bin/hevy exercises search "squat" <skill-dir>/bin/hevy routines template > routine.json <skill-dir>/bin/hevy routines create routine.json 查看全部命令:<skill-dir>/bin/hevy --help
工作流:解析计划中的动作、组数、次数、重量与休息时间;用 exercises search 查动作 ID;以 routines template 为基础构建 JSON;再执行 routines create。
关键规则:notes 中不可使用 @(会触发 400);JSON 必须包裹为 {"routine": {...}};组属性须匹配动作类型:weight_reps 用 weight_kg 与 reps,reps_only 只用 reps,duration 用 duration_seconds,distance_duration 用 distance_meters 与 duration_seconds,short_distance_weight 用 distance_meters 与 weight_kg;不可猜测 ID,须先搜索。
超级组:A1/A2、superset、paired 或 Circuit/EMOM 共用同一 superset_id,休息时间只写在超级组最后一个动作上;AMRAP 用 "reps": null。
单位换算:磅转千克为 lbs / 2.205,并四舍五入到 0.5 kg。
批量导入:先构建全部 JSON,创建一个并核对,其余每次间隔 2 秒;遇 429 等待 60 秒后从失败处继续。
限制与排错:401 为密钥错误,429 为频率限制,400 多为组属性与动作类型不匹配;更新时需移除 id、created_at、updated_at 等只读字段。资料未提供收费、平台支持范围等更多信息。