diff --git a/.trellis/tasks/08-28-crosswalk-element-editor/implement.md b/.trellis/tasks/08-28-crosswalk-element-editor/implement.md index 39a973c..c23eed8 100644 --- a/.trellis/tasks/08-28-crosswalk-element-editor/implement.md +++ b/.trellis/tasks/08-28-crosswalk-element-editor/implement.md @@ -89,3 +89,24 @@ npm run build - `workbench/server.js`:element manifest 查询与 preview 不得写入磁盘。 - `workbench/client/src/App.tsx`、`edit/`、`components/`:元素控件必须接既有三出口;选中框是临时 UI,不得写 baseline layer。 - `test/fixtures.js`:默认跨度改由路宽推导会改动 fixture 基线,需显式更新而非静默接受。 + +--- + +## 交付进度(2026-08-31) + +| 步骤 | 状态 | +| --- | --- | +| 0 建立事实与测试夹具 | ✅ | +| 1 元素选择 | ✅ `edit/element.ts`,浏览器已确认 | +| 2 选中框与移动 | ✅ 虚线框可直接拖拽 | +| 3 修正 `affects` | ⬜ 未开始 | +| 4 编译器尺寸参数化 | ⬜ 未开始 | +| 5 四角尺寸抓手 | ⬜ 未开始 | +| 6 复盘 | 部分:推广分析见 `research/generalising-to-other-markings.md` | + +第 1–2 步之外另修了两处既有缺陷:`MapCanvas` 的陈旧闭包与空白点击不上报, +以及 `junction-crosswalk-inset` 的上界(44%~88% 死区,见 +`08-31-parameter-panel-binding/research/manifest-range-vs-solver.md`)。 + +手测确认:选中、虚线框、拖拽均可用。**尚未手测**:框跟随修复后的表现、 +上界修复后的拖拽手感——两者都需重启工作台进程才能生效。 diff --git a/.trellis/tasks/08-28-crosswalk-element-editor/research/generalising-to-other-markings.md b/.trellis/tasks/08-28-crosswalk-element-editor/research/generalising-to-other-markings.md new file mode 100644 index 0000000..80d53cf --- /dev/null +++ b/.trellis/tasks/08-28-crosswalk-element-editor/research/generalising-to-other-markings.md @@ -0,0 +1,84 @@ +# 元素模型能推广到哪些标线 + +日期:2026-08-31 +来源:`08-28-crosswalk-element-editor` 第 1–2 步交付后,对 `nantaizihu-9PTsZg` 的实测。 + +## 各元素的分组结构(实测) + +| 图层 | provenance | 分组键 | feature | 组数 | 每组大小 | +| --- | --- | --- | --- | --- | --- | +| `crosswalks` | `native-road-crosswalk/v1` | `crossing_node_id` | 48 | 8 | 恒 6 | +| `vehicleStopLines` | `native-road-stop-line/v1` | `crossing_node_id` | 8 | 8 | 恒 1 | +| `turnArrows` | `native-road-turn-arrow/v1` | `lane_id` + `maneuver` | 108 | 28 | 3 或 5 | +| `directionArrows` | `native-road-direction-arrow/v1` | `lane_id` | 324 | 50 | 2~28 | +| `laneSeparators` | `native-road-lane-separator/v1` | `road_id` + 车道对 | 731 | 9 | 26~230 | + +## 关键陷阱:斑马线与停止线共用 `crossing_node_id` + +交集 **8/8**——两者由同一个 `controlFeature()` 构造,`crossing_node_id` 完全重合。 +只按该字段分组会把一组斑马线和它的停止线并成一个"元素"。 + +**必须先按 `provenance` 判类型,再取分组键。** `element.ts` 已如此实现并有测试守着 +(`rejects a stop line, which shares the same feature builder`)。任何推广都不能绕过这一步。 + +## 可编辑性就绪度 + +| 元素 | 约束 kind | 编译器是否消费 | 实测响应 | 成本 | +| --- | --- | --- | --- | --- | +| 斑马线 | `junction-crosswalk-inset` | ✅ | 已修正上界,全程有效 | **已完成** | +| 停止线 | `junction-stop-line-offset` | ✅ | **全程线性,零死区** | **几乎免费** | +| 转向箭头 | ❌ 无 | ❌ | — | 新 kind + 编译器 | +| 方向箭头 | ❌ 无 | ❌ | — | 新 kind + 编译器 | +| 车道分隔线 | v1 overrides,仅样式 | 仅样式 | 位置不可编辑 | 另一类问题 | + +停止线实测:offset `0.5 → 126` 位移 `0 → 125.36m`,增量始终 1:1。 +**没有斑马线那种死区**,可以直接接入。 + +但它有反向的毛病:声明范围 `[0.5, 126.28]`(`approach.length * 0.45`), +允许把停止线推到离路口 126 米——而 `native-road.js` 有 +`STOP_LINE_MAX_APPROACH_DISTANCE_METERS = 25`。范围过宽同样是缺陷, +见 `.trellis/spec/backend/direct-edit-api.md` §12。 + +## 值得建立的抽象(仅此而已) + +一个按 provenance 索引的小注册表: + +```ts +interface ElementSpec { + provenance: string; + kind: ElementKind; + groupKey(properties: Record): string | null; + constraintKind: ConstraintKind; +} +``` + +`element.ts` 现有的 `crosswalkElementIdOf` / `groupMembers` / `elementSelectionFor` +改为查表即可,选中、选框、拖拽三条链路无需改动。 + +**不要**据此建立"所有元素"的通用协议——PRD 明确禁止 +(「不提前建立『所有元素』的大而全抽象」)。理由在上表里: +分组键的形态各不相同(单字段 / 双字段 / 派生), +每组大小从 1 到 230,箭头类连约束 kind 都还不存在。 +现在能证明的只有「provenance + 分组键 → 组」这一条,注册表恰好只承诺这一条。 + +## 推荐顺序 + +1. **停止线**——注册表 + 一条 spec 条目。约束现成、编译器已消费、响应已验证。 + 同时暴露注册表是否够用:它的每组只有 1 个 feature,而斑马线是 6 个, + 能验证分组逻辑不依赖"多 part"这个偶然属性。 +2. **修 `affects`**(原第 3 步)——目前 `junctionAffects()` 不含任何标线, + 拖拽高亮会亮错一片。停止线接入后这个问题会更明显。 +3. **转向箭头**——需要新 constraint kind,且必须先证明 `compileGeometry()` 读它。 + 分组键 `lane_id + maneuver` 已验证(28 组,每组 3 或 5 个 part)。 +4. **方向箭头**——最贵。分组语义本身待定:按 `lane_id` 是 50 组(编辑间距/整体偏移), + 按 `lane_id + sequence` 是 324 组(逐个箭头独立摆放)。 + 这是产品决策,不是实现细节,需先定。 +5. **车道分隔线**——不同类问题。已有 v1 样式 override,缺的是位置, + 而位置由 `road-lane-divider` 约束管,属道路横断面而非元素级。 + +## 与复杂路口的关系 + +停止线和转向箭头都是**位置类**元素,与斑马线同属一个几何类别: +移动它们不改变路口多边形。所以第 1、3 步不会为形状类元素 +(`approach-width` / `cutback` / `corner-radius`)提供任何背书—— +那仍是独立的、未验证的一类,见 `prd.md`「试验对象的覆盖边界」。