Workout

核心用法

Workout-cli 是一款面向力量训练爱好者的本地命令行健身日志工具，支持完整的训练周期管理：从启动训练、记录组数与重量，到历史回溯与进步曲线分析。

关键工作流：
1. 启动训练：通过 workout start [template] 创建结构化或自由训练课表
2. 精确记录：workout log <exercise> <weight> <reps> 强制记录真实数据，支持多组简写如 135 8,8,7
3. 元数据补充：workout note 用于记录体感、伤痛或动作变式，但不可替代数值
4. 数据洞察：内置 PR 追踪、容量统计、单动作历史与长期进步曲线

显著优点：

• 数据主权：完全本地存储，无云端依赖或隐私风险
• 分析深度：自动计算 PR、周容量、训练频率与动作进步趋势
• 模板系统：支持自定义分化训练模板（如 Push/Pull/Legs）
• 装备细分：强制区分杠铃/哑铃/绳索等变体，避免数据混淆

潜在局限：

• 需预先维护动作库，未知动作必须先 exercises add
• 纯 CLI 交互，对图形界面用户学习成本较高
• 无内置热量/营养追踪，专注纯力量数据
• 移动端体验依赖终端应用，不如原生 App 便捷

适合人群：

• 注重数据隐私的力量训练者
• 习惯命令行效率的技术用户
• 需要长期训练量化与周期规划的进阶健身者

常规风险：

• 数据仅存本地，无自动备份机制需自行维护
• 重量单位固定为磅（lbs），公制用户需心算转换
• 删除或损坏本地数据库将导致历史记录永久丢失

核心用法

Workout 是一个纯 Markdown 格式的健身训练记录辅助 Skill，用于指导用户通过 workout-cli 命令行工具完成健身房训练日志管理。

主要功能模块

• 训练启动：支持自由式 (--empty) 或基于模板 (push/pull/leg) 开始会话
• 数据记录：精确录入重量(lbs)×次数，支持单组或多组批量记录
• 训练库管理：动态添加新动作，需指定肌群、动作类型(孤立/复合)、器械类型
• 历史分析：查看个人纪录(PR)、训练容量(volume)、动作进展趋势(progression)

关键操作规范

1. 先注册后记录：未知动作必须先执行 exercises add，否则无法录入
2. 数字准确性：严禁用备注替代真实数据，必须记录实际使用的重量
3. 备注仅作元数据：用于记录伤痛、动作变式等上下文信息

显著优点

• 零执行风险：纯文档型 Skill，无动态代码、无外部依赖、无网络请求
• 数据完整性设计：强制要求关键字段，从源头避免脏数据
• 隐私原生友好：本地 CLI 工具模式，无云端数据收集
• 模板化工作流：支持自定义训练模板，提升记录效率

潜在局限

• 工具依赖性：需预装 workout-cli 二进制文件，Skill 本身不提供安装
• 单位锁定：固定使用英制磅(lbs)，无公制切换选项
• 来源可信度受限：T3 评级意味着缺乏组织背书，建议企业环境审慎评估

适合人群

健身房规律训练者、力量举/健美爱好者、偏好命令行工具的数据驱动型用户。

常规风险

• 数据录入错误：用户可能误记重量单位或次数，影响长期趋势分析
• CLI 学习曲线：非技术用户可能需要适应命令行操作
• 版本兼容：workout-cli 工具更新可能导致命令语法变化