diff --git a/.trellis/tasks/08-31-constraint-range-validation/prd.md b/.trellis/tasks/08-31-constraint-range-validation/prd.md index 6265f04..276d0e8 100644 --- a/.trellis/tasks/08-31-constraint-range-validation/prd.md +++ b/.trellis/tasks/08-31-constraint-range-validation/prd.md @@ -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` 立下的那条规矩要避免的情形 +(「一个拖了没效果的控件比没有控件更糟」),只是它发生在量程的上半段而非整个控件。 ## 已确认的事实 diff --git a/.trellis/tasks/08-31-parameter-panel-binding/research/manifest-range-vs-solver.md b/.trellis/tasks/08-31-parameter-panel-binding/research/manifest-range-vs-solver.md index 4f9cfca..02f3530 100644 --- a/.trellis/tasks/08-31-parameter-panel-binding/research/manifest-range-vs-solver.md +++ b/.trellis/tasks/08-31-parameter-panel-binding/research/manifest-range-vs-solver.md @@ -56,3 +56,53 @@ 不是静默破坏。 已并入 `08-31-constraint-range-validation` 的需求。 + +--- + +# 追加:`junction-crosswalk-inset` 的静默死区 + +日期:2026-08-31,区域 `nantaizihu-9PTsZg`。 + +手柄 `handle:junction-crosswalk-inset:node/1140799725:segment:way/-3246/0` +声明 `value.min = 0`、`value.max = 8`。逐值提交预览并测量该组 6 条斑马线的中心位移: + +| inset | 相对 inset=0 的位移 | 增量 | +| --- | --- | --- | +| 0 | 0.00 | — | +| 0.5 | 0.50 | +0.50 | +| 1.0 | 1.00 | +0.50 | +| 2.0 | 2.00 | +0.50 | +| 3.0 | 3.00 | +0.50 | +| 4.0 | 3.20 | +0.20 | +| 5.0 | 3.20 | **+0.00** | +| 6.0 | 3.20 | **+0.00** | +| 8.0 | 3.20 | **+0.00** | + +`0 → 3.2` 是干净的 1:1 线性响应;`3.2 → 8` **完全无响应,且无任何诊断**。 + +## 成因 + +`crossingJunctionInset()`(`native-road.js:1325`): + +```js +const targetDistance = Math.max(0, plan.cutbackMeters - inset); +return Math.min(CROSSWALK_MAX_JUNCTION_INSET_METERS, + Math.max(0, candidate.junctionDistanceMeters - targetDistance)); +``` + +inset 增至 `plan.cutbackMeters` 后 `targetDistance` 触底为 0,再增无效; +外层 `CROSSWALK_MAX_JUNCTION_INSET_METERS = 4` 另有封顶。 +因此有效上界是 `min(cutbackMeters, …)` 的某个函数,**逐进口不同**, +而 manifest 对所有进口一律发布固定的 `max: 8`。 + +## 为何比外缘偏移那例更严重 + +外缘偏移越界会返回阻塞诊断——用户看得到"不行"。 +本例越界**什么都不发生**:拖动手柄,几何纹丝不动,没有诊断、没有提示。 +与「控件坏了」无法区分。 + +这正是 `flag.ts` 为 `profile.interval` 立下的规矩所要避免的 +(「一个拖了没效果的控件比没有控件更糟」),区别只在于它发生在量程的上半段, +而不是整个控件。 + +若用户在已处于死区的进口上首次尝试拖拽,得到的印象就是"直接编辑不工作"。