Workout

核心用法

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 生态变动导致的兼容性风险

核心用法

Workout Skill 是一个纯文档型（T-MD）CLI 工具使用指南，帮助用户通过 workout-cli 命令行工具记录健身房训练。核心功能包括：

• 训练会话管理：workout start --empty 开始自由训练，--continue 恢复中断会话，workout done 完成保存
• 组数记录：支持 workout log <动作> <重量> <次数> 格式，可记录多组（如 8,8,7,6）、渐进重量、相对增量（+10）和 RIR（保留次数）
• 动作库管理：内置常见动作，支持自定义添加（需指定肌群、类型、器械三要素）
• 模板系统：创建训练模板如 "Push Day"，快速开始结构化训练
• 数据分析：查看个人纪录（PR）、历史记录、容量分析（按周/月/肌群/动作）、长期进展趋势

显著优点

1. 离线优先：数据存储在本地 ~/.workout/，无需网络，隐私性极强
2. 灵活的记录方式：支持自由训练、模板训练、中断恢复；单次训练中可对同一动作记录多组不同重量
3. 丰富的分析维度：PR 追踪、容量趋势、肌群分布、单个动作进展曲线
4. 笔记系统：支持会话级和动作级备注，方便记录体感、伤痛、调整原因
5. JSON 输出：所有命令支持 --json，便于与其他工具集成

潜在缺点与局限性

1. 依赖外部工具：必须使用 Bun 运行时（≥1.3.5）和 workout-cli，安装门槛对非技术用户较高
2. 纯文档型限制：Skill 本身只提供使用说明，无法直接执行记录操作，用户需在终端手动输入命令
3. 数据格式锁定：专用 JSON 格式存储，迁移至其他健身 App 需手动转换
4. 无社交/社区功能：纯单机工具，缺乏分享、挑战、教练指导等互动功能
5. 单位限制：默认磅（lbs），未提及公斤支持
6. 移动端体验差：CLI 工具在手机上几乎无法使用，仅限桌面/笔记本场景

适合人群

• 技术背景健身者：习惯终端操作、喜欢数据自有化的开发者或极客
• 力量训练专注者：PR 追踪、容量分析、RIR 记录对力量举、健美人群实用
• 隐私敏感用户：拒绝云服务、希望训练数据完全本地存储
• 已有 CLI 工作流的用户：与现有开发/系统管理工具链整合

常规风险

1. 安装风险：需从 GitHub 克隆并编译，用户应自行验证仓库可信度和代码完整性
2. 数据丢失风险：本地存储无自动备份，设备故障或误删 ~/.workout/ 将导致数据丢失
3. 维护依赖：个人开发者维护（T3 来源），长期更新和支持存在不确定性
4. 学习成本：CLI 命令记忆负担，新用户需要查阅文档，无法像 App 那样直观点击
5. 跨平台限制：Bun 和 workout-cli 的 Windows 支持可能不如 Linux/macOS 完善