feat: add native road compiler workbench

README.md

@@ -96,6 +96,30 @@ npm run preflight:area -- --config config/areas/nantaizi-lake-innovation-valley.
 预检有 error 时退出非零且不会更新记录；通过后写 `preflight.manifest.json`，保留本次
 验证的 config / OSM 文件摘要和检查结果。
 
+## Native Road Workbench
+
+`road:compile` 是独立于 osm2streets 的实验性道路编译器入口。它从 OSM 生成可追溯的
+道路模型、基础道路面、诊断与对比摘要，写入 `outputs/<area-id>/native-road/`，不会覆盖
+`osm2streets_web_out/` 或影响现有 Blender/Cesium 构建：
+
+```bash
+npm run road:compile -- --config config/areas/nantaizi-lake-innovation-valley.json
+```
+
+启动本地浏览器工作台：
+
+```bash
+npm run road:workbench -- --config config/areas/nantaizi-lake-innovation-valley.json
+```
+
+工作台默认先编译，并在 `http://127.0.0.1:8787/` 展示 OSM 道路、原生结果、诊断和每个值的
+来源。可编辑道路宽度、车道数、两侧人行道，以及候选路口端点连接。保存写入
+`outputs/<area-id>/native-road-overrides.json`；此文件是版本化的可审查输入，下一次编译和
+启动工作台时会自动加载。编辑不会直接修改最终 polygon。
+
+道路按行驶方向显示：点击道路的任意线段后，右侧“路口连接”只列出该方向到达终点路口后
+可驶入的目标道路，并标记为左转、直行、右转或掉头；每一个目标道路只出现一次。
+
 诊断会输出 OSM bounds、building way / multipolygon relation、显式高度、植被数量、
 现有产物状态，以及 GLB 的 size / nodes / meshes / materials / images / extensions。
 缺少已期望的基线产物、异常 building relation、GLB 超过保守预算等会进入 `Warnings`。