LaneFlow

可嵌入、引擎无关、确定性的道路交通运行时与工具链

确定性固定步进 · 共享静态路网 · 引擎适配

LaneFlow 把受检静态路网转换为可共享修订，并在宿主控制下推进道路机动车交通。

Important

LaneFlow 仍处于 1.0 前。 当前工作区 crate 均为 0.0.0 且 publish = false，仅支持从源码集成；API 与格式可能直接调整。

快速开始

需要 Git、rustup 和 Rust 1.99.1：

git clone https://github.com/illusion-tech/laneflow.git
cd laneflow
cargo +1.99.1 run --locked -p laneflow-bevy --example quickstart --features native-example

窗口中可以看到两辆车沿车道移动，浅色车头标记显示行驶朝向；关闭窗口结束。 车道来自同一共享路网修订的 Spatial 中心线，车辆通过 Session 绑定并同步完整位姿。 这是有限路线夹具：车辆会等待信号，行程结束后不回流；重新运行可重播。

无窗口验证与完整 workspace 检查

cargo +1.99.1 test --locked -p laneflow-bevy --test quickstart_smoke
cargo +1.99.1 test --workspace --locked

当前能力

组件	已交付能力
静态路网工具链	编译并检查 LFCA，构建可跨世界共享的 SharedNetworkRevision
Traffic Runtime	固定步进推进跟驰与信号；停车状态转换由宿主命令驱动
Spatial	可选地将规范进度采样为引擎无关位姿
Reference Adapter	提供 Bevy 0.20 接入、无窗口测试与信号化走廊集成夹具
Reference Scenario	提供 catalog 0.4 与 prepare 绑定；要求显式 policy_selection

宿主负责交通需求、出发计划、路线选择策略，以及引擎生命周期与最终表现。

架构

Authoring Sources
        ↓
laneflow-compiler
        ↓
LFCA / Format Check
        ↓
SharedNetworkRevision
    ├─→ TrafficWorld ────────────┐
    └─→ SpatialSession（可选）───┴─→ Adapter / Presentation

• TrafficWorld 与 SpatialSession 消费同一份共享路网修订。
• 路线不写入静态制品；每个世界通过 TrafficWorld::register_route 注册路线。

详细职责与依赖方向见架构说明和 Traffic Runtime 共享静态路网消费契约。

当前边界

• 当前唯一可运行特化是道路机动车。
• 当前唯一已交付 Adapter 是 Bevy 0.20 Reference Adapter。
• 原生示例提供最小可视入门与复杂路口诊断。
• LaneFlow 不内置交通需求、路线选择或专业交通工程分析。

交通参与单元与交通执行域是长期抽象方向，不代表已经支持其他执行域， 也不构成交付时间承诺。

继续阅读

文档索引 · 架构说明 · 定位与宿主边界 · laneflow-bevy 接入 · 贡献指南 · 品牌标记 · Issue Tracker

许可证

LaneFlow 采用 Apache License 2.0。品牌名称与标记的使用边界见 品牌标记使用说明。