核心用法
Workout CLI 是一款基于 Bun 运行时的命令行训练日志工具,专为追求极简记录体验的开发者及技术用户设计。核心工作流围绕「启动→录入→完成」三步骤:通过 workout start --empty 或调用模板开启会话,使用 workout log <动作> <重量> <次数> 快速记录多组数据(支持逗号分隔同重量多组、多次调用记录递增负荷),以 workout done 结束并自动统计时长、总容量与肌群覆盖。
显著优点
1. 极速录入:纯键盘操作,支持相对重量(+10 自动基于上次训练计算)、RIR 标注、组间注释,显著减少健身房内设备操作摩擦。
2. 本地优先:数据以 JSON 形式存储于 ~/.workout/,无云端依赖、无订阅费用,满足隐私敏感用户需求。
3. 可扩展性:自定义动作库(肌群/类型/器械三维度)、模板系统(支持 4x8-12 等容量记号)、丰富的历史查询与 1RM 估算、容量周期分析等进阶功能。
4. 开发者友好:全命令支持 --json 输出,便于与其他工具链(如可视化脚本)集成。
潜在缺点与局限性
- 平台门槛:依赖 Bun 运行时(≥1.3.5),Windows 用户需额外配置环境,非技术用户安装成本较高。
- 移动端缺失:无 iOS/Android 客户端,健身房场景需携带笔记本或 SSH 远程操作,便利性不如主流 App。
- 数据同步:无内置多端同步机制,跨设备使用需自行解决文件同步(如 Dropbox、Syncthing)。
- 社区生态:相比 Strong、Hevy 等成熟产品,动作库依赖自建或社区贡献,初学者可能缺乏动作示范与计划模板。
适合人群
- 熟悉命令行的软件开发者、运维工程师等技术从业者
- 重视数据所有权、反感订阅制与云同步的隐私优先用户
- 已有结构化训练知识、不需要系统指导的自主训练者
- 希望将训练数据接入个人自动化工作流(Notion、Obsidian、自建仪表盘)的高级用户
常规风险
- 数据丢失:本地存储无自动备份,磁盘故障或误删
~/.workout/将导致历史记录永久丢失,建议配合 Git 或 rsync 定期备份。 - 单位混淆:默认磅(lbs),国际化用户需自行 mentally convert 或在自建动作命名中标明。
- 输入误操作:命令行无图形校验,重量/次数录入错误后需手动编辑 JSON 修正,对不熟悉结构的用户存在门槛。