04-参数、图元预算与性能

# 04 · 参数、图元预算与性能

## 4.1 参数先分三类

### 工具不变量

- 图元目标数是目标预算，不保证每次都恰好生成同样数量。
- `max-dim` 是拟合工作分辨率，不改变导出坐标的源图像素语义。
- `alpha-threshold` 决定哪些透明度被当成内容，应结合素材测试。
- `candidates`、`speed` 等参数会影响搜索过程，不能脱离版本和设备比较。
- `reserve-ratio` 会影响初步拟合与高精度阶段的预算分配。

### 当前经验起点

- 细线或发丝在拟合分辨率下最好至少有约 2~3 个像素宽，否则提高图元数也可能只是重复表达模糊边缘。
- 目标数量先从 200 或 300 做小试，再根据视觉结果增加。
- `reserve-ratio` 不应被当作首要调参项；不同素材的观感差异可能比误差指标差异更重要。

### 当前版本默认值（来自实现）

下面这些是 1.3.0 系列命令台里的参数默认值，用来判断“我改的这一项偏离默认多少”：

| 参数 | 默认 | 说明 |
|---|---:|---|
| `max-dim` | 500 | 拟合长边上限；0 表示不缩放（另有 4096 硬上限） |
| `candidates` | 64 | 每帧尝试的候选形状数，越大精度越高、越慢 |
| `speed` | 5 | 每帧产出的图元数，越大越快、CPU 占用越高 |
| `reserve-ratio` | 20 | 留给高精度阶段的形状比例，取值 0~50 |
| `alpha-threshold` | 128 | 低于该透明度的像素视为透明背景 |
| `alternate-bg` | off | 拟合过程中周期性切换黑底/白底 |
| `edge-aware` | off | 只在透明边缘区域内拟合，避免形状跨出边界 |

改 `max-dim`、`use-custom-max-dim`、`max-dim-percent` 会清空已经拟合出的图元——调这几项之前先确认当前结果不用留。

### 需要本机验证

- 边缘感知的耗时差异。
- `max-dim`、`candidates` 和目标数量的线性程度。
- 不同设备是否会出现稀疏透明图的性能拐点。

## 4.2 图元预算按同屏总量算

“3000 个图元”指同一时间、同一屏正在显示的总量，不是单张图片的永久限制。例如三张图各 2000 个图元，同时显示时按 6000 计算。

3000 是一个便于起步和 benchmark 的经验量级，不是禁止线。特写、静态高质量输出或性能足够的设备可以使用更多，但应先做实测，并准备降负载方案。

预算分配通常比盲目提高总量更有效：背景和大色块可以少一些，脸部、文字、细线等视觉敏感区域可以通过区域拟合追加预算。

## 4.3 两阶段和区域拟合

全局拟合先建立整体结构，再在目标区域内使用更小图元补细节。不要在全局结构尚未稳定时就把预算全部投入局部，否则整体轮廓可能松散。

如果区域优化会删除图元，要先保存检查点，并在 `inspect` 中确认没有破坏其他区域。区域坐标始终使用源图像素。

## 4.4 性能不是跨设备常数

文档中的“耗时更快”“增加约多少百分比”都只属于对应的机器、素材、版本和参数。它们可用于提出假设，不能直接当作用户设备的门槛。

建议每次记录：

- 工具版本。
- CPU、内存和运行模式。
- 图片尺寸、透明占比和素材类型。
- `mode`、`max-dim`、`candidates`、`speed`、`edge-aware`、`alternate-bg` 和目标图元数。
- `elapsed_ms`、最终 `shape_count` 和视觉备注。

## 4.5 超时和分段

先用小预算测量，再决定是否分段：

```text
预计秒数 ≈ 实测秒数 × (目标图元数 / 实测图元数) × 1.5
```

这是保守估算，不是引擎公式。如果预计时间过长，使用较短的超时和 `fit resume` 分段执行，保留会话和检查点，不要反复从头开始。