核心用法
Workout CLI 是一款基于 Bun 运行时构建的命令行健身记录工具,专为习惯终端操作的开发者和技术用户设计。核心工作流围绕「启动→记录→完成」三步骤展开:通过 workout start 开启自由或模板化训练,使用 workout log <exercise> <weight> <reps> 实时录入组数,最终以 workout done 保存并生成统计摘要。支持进阶功能包括 RIR(储备重复次数)标注、相对重量记录(如 +10 自动基于上次训练计算)、训练中途替换动作等。
显著优点
1. 效率优先的交互设计:纯 CLI 界面消除 GUI 切换成本,键盘流操作适合健身房场景快速记录
2. 灵活的渐进超负荷追踪:支持同动作多重量分段记录、自动 1RM 估算、PR 检测及容量趋势分析
3. 完全离线自主可控:数据以 JSON 格式存储于本地 ~/.workout/ 目录,无隐私泄露风险,支持版本控制
4. 可扩展的运动库:内置分类体系(肌肉/类型/器械),允许自定义动作并关联元数据
潜在局限
- 技术门槛限制受众:需预装 Bun 运行时并熟悉命令行操作,非技术用户配置成本较高
- 功能深度取舍:缺乏饮食追踪、身体测量、休息计时器等健身 App 常见功能;可视化依赖外部工具处理 JSON 导出
- 移动端体验缺失:纯桌面终端方案,健身房现场使用手机需配合 SSH 或 Termux 等方案
- 生态孤立:无 API 或第三方集成(如 Apple Health、Strava),数据迁移需手动处理
适合人群
- 已习惯终端工作流的开发者、运维工程师等技术从业者
- 重视数据主权、拒绝订阅制云服务的隐私敏感用户
- 训练计划相对固定(分化训练/力量举),不需要复杂周期化编排的进阶爱好者
常规风险
- 数据丢失风险:本地文件无自动备份机制,需用户自行配置
rclone或 Git 同步 - 输入错误难追溯:命令行即时提交无撤销机制,错误重量/次数需事后编辑 JSON
- 长期维护依赖:开源个人项目(GitHub star 数低),存在作者弃坑或 Bun 生态变动导致的兼容性风险