Generate Cesium preview pages from area builds

README.md

@@ -10,6 +10,7 @@
 - `<area-id>.png`：Blender 预览渲染
 - `<area-id>.glb`：Cesium 可加载的 3D 模型
 - `<area-id>.json`：Cesium 放置元数据和示例代码
+- `<area-id>-cesium-preview.html`：Cesium 本地预览页
 - `osm2streets_web_out/`：osm2streets GeoJSON 中间层
 - `<area-id>.gpkg` / `<area-id>.qgz` / `<area-id>-preview.png`：QGIS 调试资产
 
@@ -48,9 +49,10 @@ npm run build:area -- --config config/areas/hanyang-block.json
 npm run build:area -- --config config/areas/nantaizi-lake-innovation-valley.json --stages intermediates
 npm run build:area -- --config config/areas/nantaizi-lake-innovation-valley.json --stages blender
 npm run build:area -- --config config/areas/nantaizi-lake-innovation-valley.json --stages cesium
+npm run build:area -- --config config/areas/nantaizi-lake-innovation-valley.json --stages preview
 ```
 
-`intermediates` 会生成 osm2streets GeoJSON、GeoPackage、QGIS 工程和 QGIS 预览图。`blender` 使用 OSM 和 osm2streets GeoJSON 生成 `.blend`/`.png`。`cesium` 从 `.blend` 导出 `.glb`/`.json`。
+`intermediates` 会生成 osm2streets GeoJSON、GeoPackage、QGIS 工程和 QGIS 预览图。`blender` 使用 OSM 和 osm2streets GeoJSON 生成 `.blend`/`.png`。`cesium` 从 `.blend` 导出 `.glb`/`.json`，并生成 Cesium 预览 HTML。`preview` 只在已有 `.glb/.json` 时补生成 HTML。
 
 ## 区域配置
 
@@ -97,11 +99,21 @@ cp config/examples/template.json config/areas/my-area.json
   "outputs": {
     "areaDir": "/absolute/path/to/custom-area",
     "blend": "/absolute/path/to/custom.blend",
-    "glb": "/absolute/path/to/custom.glb"
+    "glb": "/absolute/path/to/custom.glb",
+    "cesiumPreview": "/absolute/path/to/custom-preview.html"
   }
 }
 ```
 
+预览 Cesium 页面时，需要在输出目录启动 HTTP 服务，避免浏览器拦截本地文件请求：
+
+```bash
+cd outputs/my-area
+python3 -m http.server 8765
+```
+
+然后打开 `http://localhost:8765/my-area-cesium-preview.html`。
+
 ## 已沉淀区域
 
 - `config/areas/nantaizi-lake-innovation-valley.json`