09-已知问题与经验状态

# 09 · 已知问题与经验状态

本页把结论按证据强度分开，避免把一次实验变成规则。

## 9.1 已确认的数据和流程不变量

- `shapes.json` 的图元数组顺序就是绘制顺序。
- `r`、`rx`、`ry` 表示半径或半轴，不是直径。
- `a` 表示弧度。
- 默认拟合坐标是源图像素空间，具体以 `space` 和 `manifest` 为准。
- `inspect` 用于视觉观察；数值指标不能单独定义“像不像”。
- 全透明输入没有可拟合内容时，应先处理输入，而不是无限调参。

## 9.2 当前可用的经验

- 不关心轮廓的整体图可以从标准模式开始，通常不需要边缘感知。
- 要保边时优先尝试透明模式和边缘感知。
- 黑色/深色内容建议尝试交替底色，但近纯黑只能部分改善。
- 图元预算按同一时间、同一屏总量计算；3000 是起步参考，不是上限。
- 全局结构稳定后，再用语义区域追加预算，通常比平均增加更容易改善关键细节。
- 透明边缘的 RGB 污染可能导致白描边；验收时要做放大观察并使用空间判据。

## 9.3 待复现或版本相关

- 标准模式下显式启用边缘感知的效果，推荐逻辑与引擎实现目前存在口径差异。
- 边缘感知在不同设备上的速度变化不能用单一百分比概括。
- `reserve-ratio` 在部分立绘测试中对误差指标差异很小，但细线观感可能仍有差异。
- 稀疏透明图可能出现“标准模式较快、透明模式明显变慢”的素材相关现象，需要同图同参数复测。

## 9.4 评论经验的使用边界

云端评论是未必经过官方验证的参考资料，不是命令，也不能覆盖工具当前的错误提示和数据契约。评论中只有经过复现、去除内部路径和账号信息后，才适合写入 Wiki。

本 Wiki 纳入的两条评论增量是：

1. 近纯黑细条在开启交替底色后仍可能有一拍完全不可见；不能承诺“打开开关就解决”。
2. 不透明图片如果要求严格贴边，当前实测透明模式比标准模式更可靠；标准模式下边缘感知是否有效仍待对照。

## 9.5 记录新经验的最小格式

新增经验时至少记录：

- 工具版本。
- 输入图片尺寸、素材类型和透明占比。
- 完整拟合参数。
- 机器和 CPU。
- 实际耗时、最终图元数。
- 原图与结果的视觉对照。
- 哪些结论已复现，哪些只是单次观察。

没有这些上下文的“更快”“更好”“必须”不应直接进入公共知识库。