用途:该技能用于向训练追踪器的动作库中添加新动作,适用于被要求新增动作、扩充动作库或查看已有哪些动作的场景。
主要能力与数据位置:所有动作定义在 src/data/popularExercises.ts 中,文件按“肌群 → 器械类型”分区,各分区内按字母顺序排列;文件头部包含各肌群与器械组合的数量汇总。动作 Schema 包含 name(唯一名称,重复会在运行时抛错)、equipment、muscle、type、metrics 五个字段。字段取值:equipment 可为 barbell、dumbbell、machine、cable、bodyweight、kettlebell、band、ez-bar、hex-bar、club、battle-rope;muscle 为 chest、back、legs、shoulders、arms、core;type 为 compound、isolation、stability、cardio、isometric;metrics 为 weight-reps、reps-only、duration、distance-duration、weight-distance。负重类动作通常用 weight-reps,自重力量用 reps-only,静态支撑用 duration,跑步划船等有氧用 distance-duration。
使用方式:先读取文件头部汇总或使用命令 grep -i "squat" src/data/popularExercises.ts 查询已有动作;再定位正确的肌群与器械分区;按字母顺序插入新动作;更新所在分区注释中的数量以及文件头汇总;最后运行 pnpm type-check 校验类型与重复项。批量添加时按肌群与器械分组、逐一按字母插入,最后统一执行一次 pnpm type-check。
限制与常见错误:动作名称在所有肌群与器械中必须唯一;不得放错分区;需保持分区内字母顺序;需同步更新分区数量与头部汇总;metrics 需与器械和动作类型匹配。文件具备运行时重复检测,重复名称会立即报错。其他平台支持、版本要求或收费信息暂未提供。