Files
road-compiler/.trellis/tasks/09-17-junction-layer-seams/evidence.md
T

4.8 KiB

接缝专项验收证据

2026-09-17。实现与专项验收完成,用户已确认 Phase 3.4 提交及归档;父任务 junction-reference-fidelity 保持归档。本次没有实施复杂绕障规划。

实际修复

真实 OSM 的两条相邻路口连接道路只选取一个端点所属 cluster 进行裁切。 另一端的面边界没有真正形成接边,边线与车道线端点偏离约 28.9 / 34.4 m。 旧顶点检查仍能通过,因为道路两条长边经过了应有接缝的两个端点。

native-road.js 现在从原始道路分别计算两端 station,一次裁切;道路面、 边线、中心线、车道中心线和人行道共同使用这一规则,保留中间弯折。 角部人行道的自交拒绝诊断改为具体 corner 身份,避免一个角部的拒绝 掩盖另一个角部的意外缺失。设施省略规则没有更改。

测量矩阵与结果

完整契约见 .trellis/spec/backend/junction-layer-seams.md。

图层/接口 checked failed notApplicable 最大位置误差 m 最大未覆盖长度 m
道路面 / 进口 / 最终铺装 172 0 0 0.003285 0.000262
核心 / 进口 86 0 0 0 < 0.000001
道路边线 172 0 8 0.006183 < 0.000001
道路中心线 26 0 86 0.000005 < 0.000001
车道中心线 560 0 0 0.006149 0
车道分隔线 362 0 194 0.000004 0.000002
人行道 68 0 28 0 0

以上最大值向上取整。共 13 个场景、1,446 个测量记录,阈值始终 为 0.01 m。checked 是接口记录数,包含同一图层不同接口及多场景, 不是互不重复的道路数量。notApplicable 可与同一对象的有效测量并存, 用于说明不要求连续白漆或不发布中心标线的接口。

场景包含单向直线/曲线、双向直线/曲线、真实 OSM 单路口/相邻路口、 真实道路显式开启人行道、双向曲线相邻路口、单向/双向局部展宽、 岛体位移、道路与 cluster 输入重排、虚线边线。

测试锁定每个场景各图层的 checked 数量,所有应连续接口须通过。 每个图层有非空覆盖;源数据没有人行道的真实场景明确标记不适用, 由显式开启人行道的真实场景提供角部接边验证。

负向测试验证:精确向东平移 2 cm、删除单个/整组必需对象、错误道路 来源、交换车道序号、缺失外部人行道/分隔线、缺失起始锚定虚线、 接边中部 2 cm 缺口及穿过接边的孔洞。原实现子代理中断留下的审计器 还存在双向/驶出车道序号误配及缺失车道时异常,这些问题均已修正。

可复现命令

node test/junction-layer-seams.js --report /private/tmp/junction-layer-seams.json
node test/junction-island-offset.js
npm test
npm run test:client
npx prettier --check src/compile/native-road.js src/compile/complex-junction-facilities.js test/helpers/junction-seams.js test/junction-layer-seams.js package.json
git diff --check

报告按场景和图层保存 checked/failed/notApplicable、对象身份、feature IDs、 位置误差、未覆盖长度、虚线端部间隙及省略原因;临时报告可随时重建, 不把大型机器报告作为仓库快照。

质量检查

  • 专项最终 13 场景 / 1,446 接口通过;已加入 npm test。
  • npm test 中编译、结构、轨迹、投影、反例、设施、铺装、标线、 接缝、编辑文档、修订存储、编辑 solver、Workbench API 和导入测试通过。 最终 test/fixtures.js:18 仍因既有当前 OSM / 旧基线差异失败。 全量运行时为 11 场景,后续新增的 2 场景及强化反例已单独完整重跑通过; 此后没有修改生产几何代码。
  • TypeScript 检查、独立岛体位移回归、变更文件 Prettier、diff 检查通过。
  • 全仓 format:check 仅报告既有未改动的 src/compile/junction-facility-composition.js 格式问题。
  • 独立 trellis-check 已复核裁切、来源匹配、面积完整接边、缺对象、 车道映射及明确省略契约;未发现阻断问题。

明确限制

不把每个角部都能生成设施作为接缝验收条件。两个单向合成角部因自交被 生成器明确拒绝;这些记录携带对应 corner 的拒绝原因,其他已发布角部 仍必须完整接边。未实现新的角部设施语义。

虚线按接缝附近支撑线及合法端部间隙测量,起始锚点不能丢失;不声称 验证整条道路的每根白条、双实/虚线每一组成部分或复杂核心内不存在的 中心标线。路口外的所有内部标线连续性不是本审计的对象。

排除区最终铺装孔洞保留风险仅完成代码初审,尚未运行最终发布面的反例; 保留在 09-17-junction-exclusion-routing/research.md,不能当成已修复。