# `offload_num_in_group` 测试报告

> 状态: 通过  
> 测试日期: 2026-07-05

## 1. 测试范围

- `offload_num_in_group=0` 保持 Noop
- `offload_num_in_group=1/2/4` 对每组 selected layers 的影响
- `offload_num_in_group > offload_group_size` 启动阶段报错
- 与共享 selection、sync、prefetch、runner 集成测试共同覆盖参数链路

## 2. 单测结果

完整 offloader 测试集结果：

```text
35 passed, 3 warnings in 12.71s
```

## 3. 参数矩阵实测

固定 `offload_group_size=4` 时，`offload_num_in_group` 增大后每组 offload 层数增加，HBM 节省增大，吞吐下降。

| case | group_size | num_in_group | offload layers | saved GB | output tok/s |
|---|---:|---:|---:|---:|---:|
| baseline_0_1 | 0 | 1 | 0 | 0.0000 | 38.8511 |
| group_4_num_1 | 4 | 1 | 7 | 0.6102 | 24.5113 |
| group_4_num_2 | 4 | 2 | 14 | 1.2203 | 14.9576 |

非法参数验证：

```text
offload_num_in_group > offload_group_size -> SMOKE_INVALID_OK
```

## 4. 结论

`offload_num_in_group` 已按预期控制每个 group 内 offload 层数，并能拒绝非法参数组合。
