锻炼命令行工具

多用户配置文件

多人可以独立使用配置文件跟踪锻炼。

workout profile list               # List all profiles
workout profile create sarah       # Create new profile
workout profile delete old         # Delete profile

当存在多个配置文件时，需指定使用哪一个：

workout --profile mike start push-day
workout --profile mike log bench-press 185 8
workout --profile mike done

• 单一配置文件：命令无需--profile即可工作（向后兼容）
• 共享练习：练习库在所有配置文件间共享
• 用户数据独立：模板、锻炼记录、配置均为每个配置文件独立

关键规则

1. 始终先添加新练习

如果用户提到库中不存在的练习，在记录前先添加它：

workout exercises add "Dumbbell RDL" --muscles hamstrings,glutes --type compound --equipment dumbbell

切勿跳过此步骤——未知练习将无法记录。

2. 记录准确数字——备注不能替代

组数需要正确的重量和重复次数. 数字支撑统计分析（个人纪录、训练量、进步情况）。

• ❌ 错误做法：记录0磅，然后在备注里写上真实重量
• ✅ 正确做法：记录实际使用的重量

如果用户未指定重量，请在记录前询问。不要假设为0。

3. 备注仅用于元数据

备注用于记录背景信息（如伤病、动作提示、器械说明），而非修正错误数据：

workout note "Left elbow tender today"
workout note bench-press "Used close grip"

核心命令

workout start --empty              # Start freestyle session
workout start push                 # Start from template
workout log bench-press 135 8      # Log set (weight reps)
workout log bench-press 135 8,8,7  # Log multiple sets
workout note "Session note"        # Add note
workout note bench-press "Note"    # Note on exercise
workout swap bench-press db-bench  # Swap exercise
workout done                       # Finish session
workout cancel                     # Discard

编辑与修正已记录的组数

workout undo                       # Remove last logged set
workout undo bench-press           # Remove last set of specific exercise
workout edit bench-press 2 155 8   # Edit set 2: weight=155, reps=8
workout edit bench-press 2 --reps 10 --rir 2  # Edit reps and RIR
workout delete bench-press 3       # Delete set 3 entirely

组数编号从1开始。使用这些编号来修正训练中的错误。

练习动作

workout exercises list
workout exercises list --muscle chest
workout exercises add "Name" --muscles biceps --type isolation --equipment cable

⚠️添加练习动作需要以下参数：--muscles（目标肌群）、--type（动作类型）、--equipment（所需器械）

器械选项：杠铃、哑铃、绳索、固定器械、自重、壶铃、弹力带、其他

模板

workout templates list
workout templates show push
workout templates create "Push" --exercises "bench-press:4x8,ohp:3x8"

历史与个人记录

workout last                       # Last workout
workout history bench-press        # Exercise history
workout pr                         # All PRs
workout pr bench-press             # Exercise PRs
workout volume --week              # Weekly volume
workout progression bench-press    # Progress over time

典型训练流程

# 1. Start
workout start push

# 2. Log with REAL numbers
workout log bench-press 135 8
workout log bench-press 145 8
workout log bench-press 155 6

# 3. Notes for context only
workout note bench-press "Felt strong today"

# 4. Finish
workout done

器械变体

使用针对器械变体的特定训练动作以准确追踪：

• 卧推（杠铃）对比哑铃卧推
• 罗马尼亚硬拉（杠铃）对比哑铃罗马尼亚硬拉
• 肩部推举（杠铃）对比哑铃肩部推举

注意事项

• 重量单位采用磅
• 允许记录不同重量的多次训练组
• 交换将所有已记录的训练组移至新训练动作
• 所有命令均支持--json 参数