Workout CLI:命令行健身训练记录与力量分析工具

0 0 更新时间: 2026-07-28 16:47:56

Workout CLI 是一款基于命令行的健身训练记录工具,支持多用户配置文件、详细记录每次训练的重量和次数、自动计算力量进展(PRs)、体积统计和趋势分析。它内置练习库、模板系统、编辑和撤销功能,适合注重数据追踪的健身爱好者。通过 npx 安装,无需图形界面,可在终端中高效管理训练日志。

安装
npx skills add https://github.com/rustykuntz/rocie-tools --skill workout
技能详情 readonly

为什么我需要一个命令行健身房记录本?

说实话,我之前用过各种健身App,什么Strong、Hevy、FitNotes都试过。但是每次解锁手机、点开App、找到练习、输入数字,感觉手忙脚乱的,尤其是组间休息就那么几分钟,手指在屏幕上戳来戳去真的很烦。后来我发现了Workout CLI,一个纯命令行的训练记录工具,简直打开了新世界的大门!

Workout CLI 是一个基于终端的健身记录工具,你不需要打开任何图形界面,直接在命令行里敲下 workout start push 就能开始推类训练,然后用 workout log bench-press 135 8 记录一组卧推(135磅、8次),练完了输入 workout done 就保存了。而且它还能自动计算你的个人纪录(PR)、每周训练容量、甚至力量进步曲线——所有数据都在本地,没有广告,没有订阅,超级清爽。

安装与配置:一分钟上手

首先,你需要在终端里运行(前提是已经安装了Node.js和npm):

npx skills add https://github.com/rustykuntz/rocie-tools --skill workout

这个命令会从rustykuntz的rocie-tools仓库中拉取workout技能包,安装后你就能用workout命令了。如果报错说找不到命令,检查一下你的npm包路径是不是在PATH里。

接着,创建一个个人配置文件——因为Workout CLI支持多用户,你和你的训练伙伴可以用同一个终端但各自的配置,互不干扰:

workout profile create sarah
workout profile list

如果只有你一个人用,可以不指定--profile参数,默认就是当前用户。但是一旦有多个配置,每次命令前都得加上--profile yourname,比如workout --profile mike log bench-press 185 8

核心操作:学会这四招就够了

我摸索了几天,总结出最常用的四个步骤:

  • 开始训练workout start --empty 开启一个自由会话,或者用模板 workout start push 直接加载已经创建好的推类模板。
  • 记录组数workout log bench-press 135 8 记录一组,如果要记多组可以一次写:workout log bench-press 135 8,8,7(表示三组,重量都是135,次数分别是8、8、7)。
  • 添加备注:用 workout note 加一些上下文信息,比如“左肘今天有点疼”或者“用了窄握距”。注意,备注不能代替真实数据——重量和次数必须如实记录!
  • 结束或取消:练完了输入 workout done 保存,如果练到一半想废弃,用 workout cancel 全部扔掉。

还有一个骚操作:workout swap bench-press db-bench 可以把当前会话中所有杠铃卧推的记录替换成哑铃卧推,适合中途换动作。

硬核细节:数据准确是王道

Workout CLI 的设计者特别强调了一点:组数必须记录真实数字。你以为记0磅然后写个备注“实际用了50磅”就完事了?错!这样统计PR和容量时会完全失真。正确的做法是,如果记不清具体重量,问清楚再记录。而且,所有新加入的练习必须先添加到库中,否则无法记录。比如你要做“Dumbbell RDL”,而库里没有,那就先:

workout exercises add "Dumbbell RDL" --muscles hamstrings,glutes --type compound --equipment dumbbell

练习库的添加需要三个必填参数:--muscles(目标肌肉,多个用逗号分隔)、--type(compound或isolation)、--equipment(可选barbell、dumbbell、cable等)。

如果你在训练过程中记错了组数,可以用 workout undo 撤销最近一组,或者 workout undo bench-press 只撤销某个练习的最后一组。更强大的是 workout edit bench-press 2 155 8 直接修改第二组的重量和次数,或者 workout delete bench-press 3 删除第三组。这些命令都是基于1索引的,用起来很直观。

数据分析:看到自己的成长

光记录不分析等于白记。Workout CLI 提供了一系列查看统计的命令:

  • 上次训练workout last 显示上一次训练内容。
  • 练习历史workout history bench-press 展示卧推的所有历史记录。
  • 个人纪录workout pr 列出所有练习的PR(最大重量、最高总容量等),或者 workout pr bench-press 只看卧推的。
  • 周容量workout volume --week 显示本周的训练容量。
  • 进展趋势workout progression bench-press 画出卧推的力量随时间的变化曲线。数据驱动训练,非常科学。

这些功能让健身不再盲目,你可以清晰看到自己哪段时间进步快,什么时候遇到了瓶颈,从而调整训练计划。

一些小技巧与注意事项

用了快两周,我总结了一些实用心得:

  1. 模板是效率神器:提前用 workout templates create "Push" --exercises "bench-press:4x8,ohp:3x8" 创建好推类模板,每次训练直接 workout start push,省去手动选择练习的步骤。
  2. 重量单位是磅:如果用的是公斤,记得心里转换一下,或者直接记录磅数(反正你心里有数)。
  3. 设备变体要注意:杠铃卧推和哑铃卧推是两个不同的练习,库中分别叫 bench-pressdumbbell-bench-press,记录时不要搞混,否则历史数据会乱。
  4. 支持JSON输出:所有命令加 --json 就可以输出结构化数据,方便你写脚本二次处理。

其实吧,刚开始用命令行记训练确实有点不习惯,但是用了一周之后,我发现自己根本不想回到App了。手指敲键盘录组比在手机上点来点去快多了,而且所有数据都在本地,随时可以备份。如果你也是个喜欢折腾终端的健身党,强烈推荐试试Workout CLI~