Workout

🏋️ 极速录入,本地掌控训练数据

开发者开源的极简 CLI 训练日志工具,本地 JSON 存储,支持组数记录、PR 追踪与容量分析,适合技术型健身用户快速录入与长期数据沉淀。

收藏
9.4k
安装
3.3k
版本
1.0.0
CLS 安全性认证2026-07-09
点击查看完整报告 >

使用说明

核心用法

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 修正,对不熟悉结构的用户存在门槛。

安全解读

核心用法

Workout CLI 是一款基于 Bun 的本地命令行健身追踪工具,让用户无需网络连接即可完整记录力量训练数据。

训练流程

| 阶段 | 命令示例 |
|------|---------|
| 开始训练 | `workout start --empty` 或 `workout start push-day` |
| 记录组数 | `workout log bench-press 135 8,8,7,6` |
| 添加备注 | `workout note "肘部紧绷"` 或 `workout note 动作名 "具体说明"` |
| 中途调整 | `workout swap bench-press dumbbell-bench-press` |
| 结束保存 | `workout done`(显示时长、组数、容量、肌群) |

数据管理能力

  • 动作库:支持自定义动作,需指定肌群/类型/器械三要素
  • 模板系统:可创建推拉腿等固定模板,快速启动预设流程
  • 历史追溯workout history 动作名workout lastworkout pr 查看个人纪录
  • 容量分析workout volume --by muscle 按肌群统计训练量

显著优点

1. 完全本地化:数据存储在 ~/.workout/ 目录,无云端依赖,隐私可控
2. 灵活记录:支持同动作多重量记录(如热身组→正式组)、RIR(离力竭次数)标注、相对重量(+10 表示比上次增重10磅)

3. JSON 输出:所有命令支持 --json,便于与其他工具集成分析

4. 开源透明:源码可查,无商业锁定

局限与不足

  • T3 来源等级:个人开发者维护(gricha),长期更新承诺不明确
  • Bun 依赖:必须使用 Bun 运行时(≥1.3.5),Node.js 用户需额外安装
  • 无图形界面:纯 CLI 交互,手机记录需配合终端模拟器,便利性不如原生 App
  • 单位固定:默认磅(lbs),无内置公斤切换
  • 数据迁移:无官方导入/导出工具,手动操作 JSON 文件

适合人群

  • 力量训练进阶者:需要精细追踪容量、1RM 估算、周期化进展
  • 隐私敏感用户:拒绝将训练数据上传至商业健身 App
  • 开发者/极客用户:熟悉命令行,希望将训练数据纳入自定义分析流程

常规风险

  • 供应链风险:通过 git clone 安装,无签名验证机制
  • 数据丢失风险:本地文件无自动备份,需用户自行管理 ~/.workout/ 目录
  • 误操作风险workout cancel 直接丢弃当前训练,无二次确认;swap 会迁移已记录组数,需确认理解语义

Workout 内容

手动下载zip · 2.2 kB
SKILL.mdtext/markdown
请选择文件