Workout

# Workout CLI

## 多用户配置文件

多人可以使用配置文件独立跟踪训练。

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

当存在多个配置文件时，指定使用哪一个： ```bash workout --profile mike start push-day workout --profile mike log bench-press 185 8 workout --profile mike done ```

- **单个配置文件**：命令无需 `--profile` 即可运行（向后兼容） - **共享动作**：动作库在所有配置文件之间共享 - **每用户数据**：模板、训练记录、配置是每个配置文件独立的

## 关键规则

### 1. 始终先添加新动作

如果用户提到的动作不在库中，**在记录之前先添加它**： ```bash workout exercises add "Dumbbell RDL" --muscles hamstrings,glutes --type compound --equipment dumbbell ``` 切勿跳过此步骤 — 未知的动作将导致记录失败。

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

组需要**正确的重量和次数**。数字用于统计分析（PR、容量、进阶）。 - ❌ 错误：记录 0 磅，然后在备注中添加真实重量 - ✅ 正确：记录实际使用的重量

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

### 3. 备注仅作元数据使用

使用备注记录上下文（伤病、动作提示、设备说明），而不是为了修正错误数据： ```bash workout note "Left elbow tender today" workout note bench-press "Used close grip" ```

## 核心命令 ```bash 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 ```

## 编辑和修正已记录的组 ```bash 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 开始索引。使用这些命令在训练过程中修正错误。

## 动作 ```bash workout exercises list workout exercises list --muscle chest workout exercises add "Name" --muscles biceps --type isolation --equipment cable ``` ⚠️ `exercises add` 需要：`--muscles`、`--type`、`--equipment`

设备选项：barbell（杠铃）、dumbbell（哑铃）、cable（拉索）、machine（器械）、bodyweight（自重）、kettlebell（壶铃）、band（弹力带）、other（其他）

## 模板 ```bash workout templates list workout templates show push workout templates create "Push" --exercises "bench-press:4x8,ohp:3x8" ```

## 历史记录与 PR ```bash 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 ```

## 典型训练流程 ```bash # 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 ```

## 设备变式

使用特定的动作来跟踪不同的设备变式： - `bench-press`（杠铃） vs `dumbbell-bench-press` - `romanian-deadlift`（杠铃） vs `dumbbell-rdl` - `shoulder-press`（杠铃） vs `dumbbell-shoulder-press`

## 备注 - 重量单位为 **lbs** - 在不同重量下多次调用 `log` 是允许的 - `swap` 会将所有记录的组移动到新动作 - 所有命令都支持 `--json`