Workout

🏋️ 终端里的私人训练日志

开源命令行健身追踪工具,支持训练记录、PR分析、容量统计,数据本地存储隐私可控,适合技术型健身爱好者。

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

使用说明

综合评估

workout-cli 是一款面向力量训练爱好者的开源命令行工具,由开发者 gricha 维护,采用纯本地数据存储模式,无需云端账户即可完整记录训练历程。

核心用法

工具围绕"训练会话→动作记录→数据分析"三大环节设计。启动会话支持自由训练(--empty)或基于模板(push-day)两种模式;记录环节采用 workout log <动作> <重量> <次数> 的极简语法,支持多组同重、渐进负荷、RIR(预留次数)标记等进阶功能;完成训练后可通过 workout done 自动计算时长、容量及目标肌群。数据层以 JSON 格式本地存储于 ~/.workout/,所有命令均支持 --json 输出便于二次开发。

显著优点

1. 隐私优先:训练数据完全本地化,无上传、无订阅、无广告,契合健身人群对个人数据的敏感需求
2. 高效交互:CLI 操作远快于触屏 App,组间歇秒级记录不中断训练节奏

3. 分析能力:内置 PR 追踪、容量趋势(volume --by muscle)、渐进负荷可视化(progression),功能对标付费健身 App

4. 可扩展性:模板系统支持自定义训练计划,JSON 输出便于与 Obsidian、Notion 等工具联动

局限性与风险

  • 技术门槛:需终端基础操作能力,非技术用户安装配置存在障碍
  • 平台限制:目前仅支持 macOS/Linux(Bash 安装脚本),Windows 需 WSL 环境
  • 数据安全:本地存储无云备份,设备损坏即丢失历史记录,需用户自行同步方案(如 Git、Syncthing)
  • 生态单薄:无手机端配套,健身房场景需携带笔记本或 SSH 远程操作

适合人群

  • 习惯终端环境的开发者、运维工程师等技术从业者
  • 重视数据隐私、拒绝 SaaS 订阅模式的硬核健身用户
  • 需要高度自定义记录字段的进阶力量训练者

风险提示

安装脚本通过 curl | bash 直接执行,虽为 GitHub 官方源,仍存在供应链攻击向量;建议审查脚本内容后再执行。软件处于个人开源项目阶段,无商业维护承诺,功能迭代依赖作者个人时间投入。

安全解读

核心用法

workout-cli 是一款纯本地运行的命令行健身追踪工具,用户可通过 workout start 开启训练会话,使用 workout log <动作> <重量> <次数> 实时记录组数,支持多组同重、递进负荷及 RIR(Reps in Reserve)备注。会话中可随时 swap 替换动作、add 追加动作,完成后 workout done 保存并生成时长、总容量、肌群分布等统计。离线数据存储于 ~/.workout/ 目录,包含动作库与历史训练 JSON。

模板功能允许预定义训练日(如 Push Day),通过 workout templates create 快速复用;历史与数据分析覆盖个人纪录(PR)、容量趋势(volume)、动作进展(progression)等多维度,支持 --json 输出便于二次处理。

显著优点

  • 纯本地化隐私友好:所有数据存于本地文件系统,无云同步、无账号体系,满足 GDPR/CCPA 合规要求。
  • 高度可定制:自定义动作需指定肌群、类型(复合/孤立)、器械,支持任意健身流派(健美式、力量举等)。
  • 灵活记录范式:递进组、同重组、相对负荷(+10)均可通过多次调用 log 实现,贴合实际训练场景。
  • 开源透明:代码托管于 GitHub,功能与描述一致,无隐藏行为。

潜在局限

  • curl | bash 安装风险:默认安装命令从远程拉取脚本直接执行,存在供应链攻击面;项目未提供包管理器分发或签名校验。
  • 无移动端/可视化界面:纯 CLI 交互,对非技术用户门槛较高,无法实时查看图表(需导出 JSON 自行处理)。
  • 社区维护强度:个人开发者项目(T3),更新频率与长期维护存在不确定性。
  • 单位固定为磅:未提供公制切换,国际用户需自行换算。

适合人群

  • 习惯终端操作的开发者或技术背景健身爱好者
  • 重视数据隐私、拒绝 SaaS 订阅的力量训练者
  • 需要轻量、可脚本化训练日志的进阶用户

常规风险

  • 安装阶段建议先下载 install.sh 审查再执行,避免管道直接运行远程代码。
  • 定期备份 ~/.workout/ 目录,防止本地数据丢失。
  • 关注上游仓库安全公告,及时更新二进制。

Workout 内容

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