Add optional GLB compression stage

README.md

@@ -11,6 +11,7 @@
 - `<area-id>.glb`：Cesium 可加载的 3D 模型
 - `<area-id>.json`：Cesium 放置元数据和示例代码
 - `<area-id>-cesium-preview.html`：Cesium 本地预览页
+- `<area-id>-compressed-webp768.glb/json/html`：显式 `compress` 阶段生成的可选压缩预览产物
 - `osm2streets_web_out/`：osm2streets GeoJSON 中间层
 - `<area-id>.gpkg` / `<area-id>.qgz` / `<area-id>-preview.png`：QGIS 调试资产
 
@@ -50,10 +51,17 @@ npm run build:area -- --config config/areas/nantaizi-lake-innovation-valley.json
 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
+npm run build:area -- --config config/areas/nantaizi-lake-innovation-valley.json --stages compress
 npm run build:area -- --config config/areas/nantaizi-lake-innovation-valley.json --stages reimport
 ```
 
-`intermediates` 会生成 osm2streets GeoJSON、GeoPackage、QGIS 工程和 QGIS 预览图。`blender` 使用 OSM 和 osm2streets GeoJSON 生成 `.blend`/`.png`。`cesium` 从 `.blend` 导出 `.glb`/`.json`，并生成 Cesium 预览 HTML。`preview` 只在已有 `.glb/.json` 时补生成 HTML。`reimport` 把手工编辑过的 GeoPackage 回导为 GeoJSON，不含在 `all` 里，详见 [QGIS 手工修正工作流](#qgis-手工修正工作流)。
+`intermediates` 会生成 osm2streets GeoJSON、GeoPackage、QGIS 工程和 QGIS 预览图。`blender` 使用 OSM 和 osm2streets GeoJSON 生成 `.blend`/`.png`。`cesium` 从 `.blend` 导出 `.glb`/`.json`，并生成 Cesium 预览 HTML。`preview` 只在已有 `.glb/.json` 时补生成 HTML。`compress` 从已有 `.glb/.json/html` 生成并列压缩产物，不覆盖默认 GLB。`reimport` 把手工编辑过的 GeoPackage 回导为 GeoJSON，不含在 `all` 里，详见 [QGIS 手工修正工作流](#qgis-手工修正工作流)。
+
+`compress` 不含在 `all` 里，也不能从配置文件默认开启。需要重导出 Cesium 后立刻生成压缩产物时，显式跑：
+
+```bash
+npm run build:area -- --config config/areas/nantaizi-lake-innovation-valley.json --stages cesium,compress
+```
 
 ## 区域配置
 
@@ -92,6 +100,12 @@ cp config/examples/template.json config/areas/my-area.json
   "blender": {
     "treeStyle": "natural",
     "officeOverrides": ""
+  },
+  "compress": {
+    "textureSize": 768,
+    "quality": 82,
+    "effort": 80,
+    "meshopt": false
   }
 }
 ```
@@ -111,7 +125,8 @@ QGIS road-layer knobs:
     "areaDir": "/absolute/path/to/custom-area",
     "blend": "/absolute/path/to/custom.blend",
     "glb": "/absolute/path/to/custom.glb",
-    "cesiumPreview": "/absolute/path/to/custom-preview.html"
+    "cesiumPreview": "/absolute/path/to/custom-preview.html",
+    "compressedGlb": "/absolute/path/to/custom-compressed.glb"
   }
 }
 ```
@@ -174,6 +189,32 @@ Cesium GLB 低层导出：
 
 详见 [blender/README.md](blender/README.md)。
 
+## 压缩 GLB
+
+推荐使用显式 `compress` 阶段。它不会覆盖默认 `<area-id>.glb`，只生成并列的压缩 GLB、
+metadata 和预览页：
+
+```bash
+npm run build:area -- \
+  --config config/areas/nantaizi-lake-innovation-valley.json \
+  --stages compress
+```
+
+底层脚本也可以单独调用：
+
+```bash
+npm run compress:glb -- \
+  --input outputs/nantaizi-lake-innovation-valley/nantaizi-lake-innovation-valley.glb \
+  --output outputs/nantaizi-lake-innovation-valley/nantaizi-lake-innovation-valley-compressed-webp768.glb \
+  --texture-size 768 \
+  --metadata outputs/nantaizi-lake-innovation-valley/nantaizi-lake-innovation-valley.json \
+  --preview outputs/nantaizi-lake-innovation-valley/nantaizi-lake-innovation-valley-cesium-preview.html
+```
+
+该脚本通过 `npx @gltf-transform/cli@4.1.4` 执行 `resize -> webp`。如需进一步压几何，
+可追加 `--meshopt`，但会引入 `EXT_meshopt_compression` / `KHR_mesh_quantization`，
+应先确认目标 Cesium 版本加载正常。
+
 ## QGIS 手工修正工作流
 
 如果已经在现成的 `.qgz` 项目里直接编辑了 `gpkg` 图层，不要再重跑 `intermediates`，否则会把手工修改覆盖掉。推荐流程是：