docs: record the crosswalk inset dead zone
Sweeping the declared [0, 8] range and measuring where the group actually lands: 0 to 3.2 tracks one-to-one, and 3.2 to 8 does not move at all. No diagnostic, no feedback — roughly 60% of the advertised range is inert. crossingJunctionInset() drives it. targetDistance bottoms out once inset reaches the approach's cutback, and a 4m cap sits above that, so the real ceiling varies per approach while the manifest publishes a flat 8 for all of them. This is worse than the edge-offset case already on file. That one refuses and says so; this one silently does nothing, which is indistinguishable from a broken control — the exact failure the interval flag exists to prevent, occurring in the upper half of a range rather than across a whole handle. A user whose first drag lands in the dead zone concludes direct editing does not work. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
1 parent
7b5bb753a7
commit
4b70b0221d
2 files changed
+57
-4
No files matched your search
@@ -4,12 +4,15 @@
|
||||
|
||||
让 manifest 声明的取值范围与求解器实际接受的可行域一致,并让保存后因几何变化而越界的约束按既有 status 机制转 `stale`,而不是静默产出畸形几何。
|
||||
|
||||
缺口有**两个方向**,实测确认(见 `08-31-parameter-panel-binding/research/manifest-range-vs-solver.md`):
|
||||
缺口有**三种表现**,均已实测确认(证据见 `08-31-parameter-panel-binding/research/manifest-range-vs-solver.md`):
|
||||
|
||||
1. **过松**——manifest 宣告的范围比求解器接受的宽。实测某 6.5m 道路的外缘偏移手柄声明 `±2.925`,但超过约 `±1` 即返回 `direct-edit-outer-edges-cross`。宣告范围约为可行域的 3 倍。
|
||||
2. **无校验**——求解器不检查 manifest 的 `min`/`max`,范围目前仅由客户端夹值实际约束。
|
||||
1. **过松且会被拒**——manifest 宣告的范围比求解器接受的宽。某 6.5m 道路的外缘偏移手柄声明 `±2.925`,超过约 `±1` 即返回 `direct-edit-outer-edges-cross`。宣告范围约为可行域的 3 倍。
|
||||
2. **过松且静默无效**——比上一种更糟,因为没有任何反馈。`junction-crosswalk-inset` 声明 `[0, 8]`,实测 `0 → 3.2` 线性响应,`3.2 → 8` **位移增量全为 0**。成因是 `crossingJunctionInset()` 中 `targetDistance = max(0, cutbackMeters - inset)` 在 inset 达到 `cutbackMeters` 后触底,外加 `CROSSWALK_MAX_JUNCTION_INSET_METERS = 4` 的封顶。声明范围里约 60% 是死区。
|
||||
3. **无校验**——求解器不检查 manifest 的 `min`/`max`,范围目前仅由客户端夹值实际约束。
|
||||
|
||||
方向 1 是用户可直接感知的(拖到一半几何就冻结),优先级高于方向 2。
|
||||
第 2 种最需要优先修:手柄在死区里拖动毫无反应,与「控件坏了」无法区分,
|
||||
正是 `flag.ts` 为 `profile.interval` 立下的那条规矩要避免的情形
|
||||
(「一个拖了没效果的控件比没有控件更糟」),只是它发生在量程的上半段而非整个控件。
|
||||
|
||||
## 已确认的事实
|
||||
|
||||
|
||||
Reference in new issue
Block a user