workout-cli 是一款专为健身爱好者设计的命令行工具，旨在帮助用户高效记录和管理训练数据。它支持多用户档案系统，允许多人独立使用同一设备或账户进行锻炼跟踪，同时保持各自的数据隔离。该工具适用于需要快速录入组数、重量和次数的场景，尤其适合习惯终端操作或追求轻量化记录方式的用户。通过简洁的命令结构，用户可以轻松启动训练会话、添加自定义动作、编辑已记录的组数，并生成历史数据和个人最佳成绩（PRs）报告。
核心功能围绕训练日志展开，强调数据的准确性与可追溯性。每次训练必须以真实使用的重量和重复次数进行记录，避免用备注代替数值——这是保证后续力量增长分析和体积统计有效性的关键。此外，工具内置了模板机制，允许用户保存常用训练计划（如“推日”或“拉日”），实现一键启动标准化流程。所有命令均支持 JSON 输出格式，便于与其他健康管理系统集成。
尽管定位为 CLI 工具，workout-cli 在用户体验上做了充分优化：即使是非技术背景用户也能快速上手；同时保留了足够的灵活性，例如支持不同器械的动作变体（杠铃卧推 vs 哑铃卧推）、肌肉群标注以及备注功能用于补充上下文信息（如伤病提醒或动作要点）。整体设计兼顾专业性和易用性，是替代纸质日志或复杂移动应用的理想选择。
核心功能特点
- 支持多用户档案，各用户可独立管理自己的训练数据与模板
- 强制要求记录真实重量和次数，确保统计数据准确性
- 提供完整的训练会话控制：开始、暂停、完成、取消及中途修改
- 内置模板系统，可保存并复用常见训练计划
- 强大的历史数据分析能力，包括个人最佳、周度训练量与长期进展追踪
- 支持动作库管理，允许添加新动作并关联肌肉群、类型与器械信息
适用场景
workout-cli 特别适合那些希望摆脱传统纸质日志或臃肿健身 App 束缚的硬核训练者。对于经常在健身房共享设备但需区分个人进度的情况（如家庭成员或训练伙伴共用一台电脑），其多用户功能尤为实用——每个人拥有自己的配置文件和历史记录，互不干扰。此外，喜欢命令行操作的开发者或效率导向型用户会发现它极具吸引力：无需打开浏览器或切换应用，在终端中即可完成整个训练记录流程，极大提升操作速度。
在日常训练中，无论是自由重量训练还是固定器械练习，只要涉及具体重量和次数的记录，该工具都能胜任。例如，在进行卧推动作时，用户可通过 ‘workout log bench-press 185 8’ 精确录入一组数据；若中途发现某组未达预期，也可随时使用 ‘edit’ 或 ‘undo’ 命令修正。对于初学者而言，系统会主动提示缺失的重量信息，防止误记为零；而对进阶用户，则可通过 ‘pr’ 和 ‘volume’ 命令监控自身进步轨迹，科学安排周期化训练。
更进一步，当用户尝试新动作或组合训练时，workout-cli 提供了完善的扩展机制。只需一条命令即可将‘哑铃罗马尼亚硬拉’加入动作库，并标记为复合动作、针对臀腿肌群、使用哑铃器械。这使得跨平台、跨器械的训练也能被统一追踪。结合模板功能，用户甚至能构建完整的 hypertrophy 或 strength 周期计划，并在每次训练前快速加载。总之，无论是日常打卡、备战比赛还是学术研究级别的训练分析，这款轻量级 CLI 工具都能提供可靠支撑。