移除无效拓扑字段并精简设计参数说明

删除未被读取的 expected 配置,避免误认为拓扑已受保护。配置检查、manifest 测试及文档检查通过。
This commit is contained in:
ykcheungab
2026-10-07 16:04:31 +08:00
parent 470281b659
commit 457918434a
4 changed files with 3 additions and 37 deletions
+3 -20
View File
@@ -344,24 +344,7 @@ seam 分开,两张印刷文件不会在同一位置重复打印白底。
|---|---:|---| |---|---:|---|
|Xynova `incidence_limit_deg`|62.0|当前表面会产生 4.8% hole;显式 70.0 是必要配置| |Xynova `incidence_limit_deg`|62.0|当前表面会产生 4.8% hole;显式 70.0 是必要配置|
## 6. `expected.*`:目前还没有真正起到保护作用 ## 6. 已知几何漂移
`expected.sensing_vertices` 和 `expected.sensing_triangles` 看起来像拓扑变化门槛,但当前
`src/`、`blender/`、`tools/`、`tests/` 中没有代码读取它们。
Xynova YAML 当前写的是 2595 vertices / 5005 triangles,实际测得为 2584 vertices /
5007 triangles。早期注释曾声称 `expected.*` 能发现这类变化,这个说法不成立,因为字段尚未
接入导出 manifest 或测试。
在它们真正接入检查之前:
- 把这些数值视为“未验证”;
- 不要在报告中引用它们作为自动验收结果;
- 不要因为字段存在,就假设拓扑变化已经受到保护。
理想的后续实现是:导出时测量实际拓扑,与 `expected.*` 比较;不一致时明确失败并打印差异。
## 7. 已知几何漂移
仓库中的历史资料对 Xynova sensing surface 的描述互不一致: 仓库中的历史资料对 Xynova sensing surface 的描述互不一致:
@@ -399,7 +382,7 @@ sensing_surface_918_s
目前 `_0928` 已隐藏;`texture-views` 现在也会在发生遮挡时失败,并指出拦截射线的对象, 目前 `_0928` 已隐藏;`texture-views` 现在也会在发生遮挡时失败,并指出拦截射线的对象,
不会继续生成空白纹理。 不会继续生成空白纹理。
## 8. 两个 revision 的差异 ## 7. 两个 revision 的差异
|项目|`finger/r01`|`finger-xynova/r01`| |项目|`finger/r01`|`finger-xynova/r01`|
|---|---|---| |---|---|---|
@@ -414,7 +397,7 @@ sensing_surface_918_s
不能为了让两个 revision 的 YAML 看起来一致,就统一这些值。分辨率、页面、网格比例、相机 不能为了让两个 revision 的 YAML 看起来一致,就统一这些值。分辨率、页面、网格比例、相机
位姿和入射角门槛都是各自设计与测量条件的一部分。 位姿和入射角门槛都是各自设计与测量条件的一部分。
## 9. 新同事修改参数时的建议步骤 ## 8. 新同事修改参数时的建议步骤
1. 先确认正在修改哪个 sensor 和 revision,不要把 `finger` 的参数复制到 1. 先确认正在修改哪个 sensor 和 revision,不要把 `finger` 的参数复制到
`finger-xynova` 后直接使用。 `finger-xynova` 后直接使用。
-3
View File
@@ -29,9 +29,6 @@ Recorded blend hash for the 2026-09-27 measurement set: `61093B1A…`.
| Position | x ∈ [−15.81, −1.77] mm; area-weighted centroid ≈ **(−8.13, 0.00, 3.14) mm** | **The surface is not centred on the origin.** Any view aimed at the origin misses it | | Position | x ∈ [−15.81, −1.77] mm; area-weighted centroid ≈ **(−8.13, 0.00, 3.14) mm** | **The surface is not centred on the origin.** Any view aimed at the origin misses it |
| Face normals | **94.5 % inward-facing** (`normal.z < 0`), `normal.z ∈ [−0.9999, +0.6755]` | Winding is not trustworthy on this mesh; see §5 | | Face normals | **94.5 % inward-facing** (`normal.z < 0`), `normal.z ∈ [−0.9999, +0.6755]` | Winding is not trustworthy on this mesh; see §5 |
`design.yaml` declares `expected.sensing_triangles: 1974`, but **nothing validates it** — the
value is a comment, not a gate.
## 3. UV layouts ## 3. UV layouts
| Fact | Value | | Fact | Value |
-7
View File
@@ -24,13 +24,6 @@ collections:
design_sim: DESIGN_SIM design_sim: DESIGN_SIM
exclude: EXCLUDE exclude: EXCLUDE
# Topology guard. NOT YET WIRED - no code reads these, and the measured topology is
# 2584/5007. Unverified until connected to the export manifest; see
# docs/design-parameters.md part 5.
expected:
sensing_vertices: 2595
sensing_triangles: 5005
# Camera-space artwork on UV unwraps (`orisys-design texture`). # Camera-space artwork on UV unwraps (`orisys-design texture`).
# See docs/design-parameters.md part 1. # See docs/design-parameters.md part 1.
texture_patch: texture_patch:
-7
View File
@@ -24,13 +24,6 @@ collections:
design_sim: DESIGN_SIM design_sim: DESIGN_SIM
exclude: EXCLUDE exclude: EXCLUDE
# Topology guard. NOT YET WIRED - no code reads these, and the measured topology is
# 1034/1977. Unverified until connected to the export manifest; see
# docs/design-parameters.md part 5.
expected:
sensing_vertices: 1032
sensing_triangles: 1974
# Camera-space artwork on UV unwraps (`orisys-design texture`). # Camera-space artwork on UV unwraps (`orisys-design texture`).
# See docs/design-parameters.md part 1. # See docs/design-parameters.md part 1.
texture_patch: texture_patch: