# P2 Job System + Burst 落地（结项与验收）

## 1. 文档目的
本文件用于对齐 `docs/TodoList.md` 的 P2 Checkpoint 9，作为 P2 结项与 P3 输入基线。

目标：
- 固化压测口径（1k/2k/3k）
- 给出回归验证结论
- 给出开关/回滚策略
- 给出最终验收判定（通过/不通过）

## 2. 验收标准（对齐 TodoList）
来源：`docs/TodoList.md` 第 171~179 行。

- 在 `3k` 敌人规模下，CPU Main Thread 明显下降（目标 `>= 30%`）。
- Profiler 中战斗帧 `GC Alloc` 接近 `0`（持续帧）。

## 3. 测试设备与环境
- 设备：iQOO Neo8
- CPU：第一代骁龙 8+
- 内存：12 GB
- 系统：OriginOS 6（Android 16）
- Profiler 口径：以 CPU `ms` 为主，`fps` 仅作辅助（Android 端存在 60fps 上限）
- Profiler 配置：`Call Stacks = Off`

## 4. P2 开关与回滚策略

### 4.1 运行开关
- `UseSimulationMovement`
- `UseJobSimulation`
- `UseBurstJobs`

### 4.2 生效时机约束
- `UseSimulationMovement` / `UseJobSimulation`：战斗内不支持热切换，需在 Battle 外修改后生效。
- `UseBurstJobs`：可切换，但建议仅用于战斗外 A/B。

### 4.3 回滚策略（建议）
1. 切回非 Job 路径：`UseJobSimulation = false`
2. 若仍异常，切回旧移动：`UseSimulationMovement = false`
3. 保留 `UseBurstJobs` 仅在 Job 路径 A/B 对照

## 5. 回归验证（Checkpoint 9）

| 用例                                       | 目标           | 状态 | 证据 |
|------------------------------------------|--------------|----|----|
| 10 分钟连续战斗                                | 无异常日志、流程稳定   | 待补 | 待补 |
| `Battle -> LevelUp -> Shop -> Battle` 循环 | 状态切换稳定、无卡死   | 待补 | 待补 |
| 掉落拾取链路                                   | 掉落生成/吸附/回收正常 | 待补 | 待补 |

建议附证据：
- `Logs/playmode-tests.log`
- 关键流程录屏/截图
- 回归脚本或人工步骤说明

## 6. 压测口径与数据

### 6.1 标准口径（必须覆盖）
- 敌人规模：`1k / 2k / 3k`
- 指标：
  - Main Thread (`ms`)
  - Job Workers (`ms`)
  - GC Alloc (`B/frame`)
  - 关键 Marker（`BuildInput / MoveSeparation / Complete / WriteBack`）

### 6.2 当前已测数据（你提供）

#### CPU 分阶段数据（P2）
| 指标             |       `500 enemies` |      `1000 enemies` |      `1500 enemies` |      `2000 enemies` |
|----------------|--------------------:|--------------------:|--------------------:|--------------------:|
| 帧率             | 62.6 fps (15.96 ms) | 52.6 fps (19.00 ms) | 35.0 fps (28.56 ms) | 24.9 fps (40.05 ms) |
| BuildInput     |             0.28 ms |             0.58 ms |             0.88 ms |             1.13 ms |
| MoveSeparation |             0.38 ms |             0.94 ms |             1.59 ms |             2.48 ms |
| StateUpdate    |             0.01 ms |             0.01 ms |             0.01 ms |             0.01 ms |
| Schedule       |             0.00 ms |             0.00 ms |             0.00 ms |             0.00 ms |
| Complete       |             0.45 ms |             1.20 ms |             1.86 ms |             3.79 ms |
| WriteBack      |             0.15 ms |             0.31 ms |             1.20 ms |             2.00 ms |

#### CPU 热路径对比（P1.5 -> P2）
说明：P2 以六阶段总和近似对齐 P1.5 四阶段 `TickEnemies ms`。

| 敌人数量   | P1.5 TickEnemies | P2 TickEnemies |     降幅 |
|--------|-----------------:|---------------:|-------:|
| `500`  |          4.77 ms |        1.30 ms | -72.7% |
| `1000` |          9.86 ms |        3.06 ms | -68.9% |
| `1500` |         15.42 ms |        5.57 ms | -63.8% |
| `2000` |         21.68 ms |        9.44 ms | -56.4% |

## 7. 验收判定

| 验收项                | 标准       | 当前状态     | 判定  |
|--------------------|----------|----------|-----|
| Main Thread 降幅（2k） | `>= 30%` | 缺失 3k 数据 | 不通过 |
| 持续帧 GC Alloc       | 接近 0     | 缺失 GC 数据 | 不通过 |

**当前结论：P2 Checkpoint 9 暂不通过。**

可确认部分：
- P2 在 `500~2000` 规模的热路径 CPU 优化已显著成立。
- 但未满足 TodoList 的完整验收口径（3k + GC + 回归证据）。

## 8. 下一步补齐动作（建议）
1. 按同一场景补采 `3k` 数据（P1.5 与 P2 各一次，至少 60s 稳态窗口）。
2. 记录 `Main Thread / Job Workers / GC Alloc` 三项，写入 6.3 对应表。
3. 完成 5.0 的三个回归用例并填入证据。
4. 补齐后将第 7 节判定更新为“通过”，再在 `TodoList.md` 把 P2 Checkpoint 9 勾选。

## 9. 测试命令（复用）
- PlayMode:
  - `Unity -batchmode -nographics -projectPath . -runTests -testPlatform PlayMode -testResults Logs/playmode-test-results.xml -logFile Logs/playmode-tests.log`
- EditMode:
  - `Unity -batchmode -nographics -projectPath . -runTests -testPlatform EditMode -testResults Logs/editmode-test-results.xml -logFile Logs/editmode-tests.log`