05-视觉验收与画质问题

# 05 · 视觉验收与画质问题

## 5.1 视觉优先

GEIMG 的 `rmse`、`match_percent` 和 `pixel_diff` 主要用于导航：告诉你哪里可能需要看、这一轮是否明显倒退、拟合是否仍在推进。它们不是“达到某个数字就完成”的质量门槛。

最终验收至少要看：

- 整体轮廓是否保持。
- 细线、发丝、文字和小部件是否仍可辨认。
- 黑色或深色区域是否丢失。
- 图元是否鼓出轮廓或出现明显白边。
- 局部变好时，其他区域是否被破坏。

## 5.2 用 inspect 生成可判读的图

```bash
GE_IMG_Tool.exe inspect --zoom auto --json
GE_IMG_Tool.exe inspect --sheet --grid --json
GE_IMG_Tool.exe inspect --compare "<历史结果图或结果目录>" --json
```

放大裁剪用于判断细线和边缘，并排图用于比较前后版本，拼版用于同时检查多个区域。`--compare` 需要一个取值（要对照的历史结果图路径，多个用逗号分隔），`--sheet` 和 `--grid` 是开关。

如果版本支持视觉评审记录：

```bash
GE_IMG_Tool.exe region add face 120,80,180,220
GE_IMG_Tool.exe review set face --verdict ok --note "眼睛轮廓和高光可辨认"
GE_IMG_Tool.exe review status --json
```

视觉评审以区域为单位，`--verdict` 只能是 `ok` 或 `needs-work`。图元发生变动后，已有评审会被标记为过期，需要重新确认。

## 5.3 常见现象

### 细线或发丝缺失

先检查拟合分辨率：最细结构在工作分辨率下是否只有不到 2~3 个像素。可以提高 `max-dim`，或把预算集中到该区域。单纯提高整图图元数未必有效。

### 黑色内容拟合为空

确认输入不是全透明；然后尝试 `alternate-bg on`。如果内容接近纯黑，交替底色可能只能恢复一部分，必要时在源图上增加可分辨的边缘或颜色后再拟合。

### 图元越出轮廓

优先确认是否需要 `transparent + edge-aware`。不要只根据 RMSE 较低的结果选择版本；数值更低的结果可能视觉上更鼓。

### 白描边或透明边缘发亮

透明区域的 RGB 可能在放大或插值时混入边缘。处理时使用空间关系判断是否越界，不要按“白色”直接删图元，因为高光、金边等真实内容也可能是白色。

比较颜色前先确认是否为预乘 alpha；不还原就比较，可能把偏亮误判成偏暗。

### 全透明图片或空白图

先看 `image info` 和 alpha 统计。没有可拟合内容时，正确结果可能是 `nothing_to_fit`，这不是继续调参就能解决的问题。

## 5.4 边缘处理的可迁移原则

下面是原则，不是要求每个用户复制同一套脚本：

- 外溢判据使用空间覆盖，不使用颜色单独判断。
- 边缘修正后重新检查内部误差，不能为了边缘把内部结构改坏。
- 放大透明素材时，避免透明区的无关 RGB 被插值带入内容边缘。
- 预览遮罩可以帮助诊断，但最终应验收真实导出数据，而不是只看加了遮罩的预览。

## 5.5 参考量级

以下数字来自特定素材和版本，只能当对照：

| 指标 | 一次记录的结果 |
|---|---:|
| 最外环明显偏亮像素 | 1568 → 82 |
| 轮廓外溢质量 | 745 → 333 |
| 内部 RMSE | 22.40 → 22.23 |

比数字更重要的是：把源图、未处理结果、处理后结果并排，并在外缘放大 6 倍观察；确认视觉改善没有制造新缺口。