feat(preview): add continuous vehicle turn routes

This commit is contained in:
2026-08-05 14:58:24 +08:00
parent eb9e510e13
commit 30846b6df9
11 changed files with 573 additions and 98 deletions

View File

@@ -0,0 +1 @@
{"_example": "Fill with {\"file\": \"<path>\", \"reason\": \"<why>\"}. Put spec/research files only — no code paths. Run `python3 .trellis/scripts/get_context.py --mode packages` to list available specs. Delete this line once real entries are added."}

View File

@@ -0,0 +1,31 @@
# 设计:车辆连续巡航与转弯
## 数据与图模型
`vehicle-route.js` 继续只读取 OSM XML但解析改为保留 node ID、坐标、way 标签和 node
引用。每条可行驶 way 产生一个或两个有向 edge`oneway=yes` 只保留原始方向,其他道路增加
反向 edge。edge 的终点 node 连接其他以该 node 为起点的 edge。
入边在路口前的最后一个线段给出入射方位,出边第一个线段给出离去方位。二者的有符号夹角
分类为 `left``through``right`;接近 180 度的 U-turn 一律排除。读取去程入边方向对应的
`turn:lanes:forward/backward`,拆分 `|``;` 后得到允许动作集合。无 `turn:lanes`
道路保守允许三种非 U-turn 动作,避免未标注区域没有路线。返程沿反向 edge 回走,不用反向
`turn:lanes` 过滤;这是一项预览展示边界,不是交通规则模拟。
## 路线选择与几何
南台子湖主道路图是树状网络,不能生成真实 cycle。改为枚举连接两个端点、长度足够的有向
道路路径,并按稳定的 road ID / maneuver 序列排序。选择彼此不完全相同、且合计覆盖
left / through / right 的前 5 条。路径在两个端点各接一段平滑调头曲线,再沿反向道路返回;
这使得路线可循环播放而不在端点瞬移。
每个路口连接把入边末段和出边首段裁去固定距离,用三次 Bezier 采样 6 个点衔接。偏移在
整条连续路线完成后计算,避免每个 way 单独偏移在路口产生断裂。
route JSON 升级为 `routes`,每项有 `id``maneuvers``coordinates``lengthMeters`;同时
继续写 `segments` 作为旧预览的兼容别名。Cesium 运行时优先读取 `routes`,退回 `segments`
## 边界
没有 `restriction` relation 时不能声称交通法规完全正确。它只影响未来候选出口过滤,不改变
路线格式或 Cesium 播放逻辑。路口曲线是视觉轨迹,车道级精确曲率与道路 polygon 不在首版。

View File

@@ -0,0 +1 @@
{"_example": "Fill with {\"file\": \"<path>\", \"reason\": \"<why>\"}. Put spec/research files only — no code paths. Run `python3 .trellis/scripts/get_context.py --mode packages` to list available specs. Delete this line once real entries are added."}

View File

@@ -0,0 +1,10 @@
# 实施计划:车辆连续巡航与转弯
1. 重构 `vehicle-route.js` 的 OSM 读取和纯几何 helper构造有向 road graph、动作分类与
`turn:lanes` 过滤。
2. 枚举稳定的端点间道路路径、选择不重复且覆盖三种动作的至多 5 条路线;在端点添加
平滑调头并生成路口连接。
3. 扩展 route JSON保留 `segments` 兼容字段预览优先消费新路线数组UI 标识路线及动作。
4.`test-preview-assets.js` 增加单行、标签过滤、左直右分类、闭环和曲线连续性夹具。
5. 运行 Node 语法检查、预览测试、现有箭头测试和目标区域 `preview` 重建;在浏览器观察
普通与压缩预览的多车转弯。

View File

@@ -0,0 +1,49 @@
# 车辆连续巡航与转弯
## Goal
让 Cesium 预览中的车辆沿连续道路路线穿越路口,并以可见的平滑曲线完成左转、右转和直行;
同屏展示多条确定性路线以核对效果。
## Confirmed Facts
- 当前 `scripts/lib/vehicle-route.js` 将每条可行驶 OSM way 独立导为折返巡航段;车辆不会跨
way 行驶。
- Cesium 预览最多加载 5 辆车辆,已有位置插值、朝向计算、路线可见性和 Follow 控制。
- 南台子湖 OSM 使用单引号 XML 属性,含 15 处 `turn:lanes:forward`、15 处
`turn:lanes:backward` 和 4 条 `oneway=yes`
- 没有 `restriction` relation首版不能承诺处理禁止左转等限制关系。
- 路口 `1140799725``1140799919` 各连接四条道路,另有多个三岔连接,足以形成多条
左转、右转、直行的连续候选路线。
## Requirements
1. 从 OSM 可行驶 way 构建有向道路图:单行道只能按 tag 方向通行,双向道路提供两个方向。
2. 在共享端点连接道路,依据入射和出射方向将候选动作分类为 left、through、right去程
只有动作出现在该方向 `turn:lanes:*` 的任一车道时才可通行。返程原路返回,不用反向
`turn:lanes` 二次否决路线。
3. 确定性地产生至多 5 条连续往返路线,覆盖至少一条左转、一条右转和一条直行路线。
4. 路口与路线端点均用平滑连接补充路线点;车辆位置、朝向和可见路线必须连续,不能在
way 端点跳回起点。
5. 保持现有路线 JSON 是预览的可选输入,旧 route JSON 仍可由预览加载。
## Out of Scope
- 不做实时交通仿真、避碰、红绿灯、变道或速度控制。
- 不使用 QGIS 图层或改动 Blender/GLB。
- 不支持 OSM `restriction` relation后续数据具备时再接入。
- 不承诺为每条车道生成独立精确轨迹;`turn:lanes` 首版用于许可转向过滤。
## Acceptance Criteria
- [ ] 输出最多 5 条连续往返路线,且每条均有多个跨 way 的路口连接和端点平滑调头。
- [ ] 南台子湖预览同屏可见左转、右转、直行三类路口动作,车辆不在路口或 way 端点瞬移。
- [ ] `oneway=yes` 的路段不会逆向进入;去程没有匹配 `turn:lanes` 动作的出口不会被选入路线。
- [ ] 路线生成对同一 OSM 输入稳定,自动化测试覆盖单行、动作过滤、转向分类、曲线连接和闭环。
- [ ] 旧 route JSON 的预览兼容性不回归,现有 Pause、Follow、路线开关和车辆选择仍可用。
## Open Questions
已决南台子湖可行驶道路主连通分量是树状网络23 个端点节点、19 条道路连接),没有
真实闭环;首版以端点平滑调头的往返路线替代闭环。为展示多条路线,返程不以反向
`turn:lanes` 过滤,但仍不允许逆行单行道。

View File

@@ -0,0 +1,26 @@
{
"id": "vehicle-turn-routes",
"name": "vehicle-turn-routes",
"title": "车辆连续巡航与转弯",
"description": "",
"status": "in_progress",
"dev_type": null,
"scope": null,
"package": null,
"priority": "P2",
"creator": "dingkang",
"assignee": "dingkang",
"createdAt": "2026-08-05",
"completedAt": null,
"branch": null,
"base_branch": "main",
"worktree_path": null,
"commit": null,
"pr_url": null,
"subtasks": [],
"children": [],
"parent": null,
"relatedFiles": [],
"notes": "",
"meta": {}
}