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,不能当成已修复。