Refactor area preview orchestration

2026-08-04 12:55:20 +08:00
parent 0ce7d1ea5e
commit 396df5127c
16 changed files with 541 additions and 455 deletions
--- a/docs/changelog.md
+++ b/docs/changelog.md
@@ -2,6 +2,12 @@

 ## 2026-08-04

+- 重构区域构建入口的 preview 实现边界：`build-area.js` 现在只调度阶段、写 preview
+  文件并拥有 manifest；OSM 巡航路线、轻量车辆 glTF、preview runtime copy / HTML 模板 /
+  安全转义分别位于 `scripts/lib/vehicle-route.js`、`vehicle-model.js` 和
+  `area-preview.js`。CLI、stage aliases、文件名、manifest 字段和浏览器运行时不变；新增
+  `npm run test:preview-assets` 覆盖路线、glTF buffer/schema 和 HTML/script 注入转义，
+  并通过南台子 standalone preview、诊断和质量门验证。
 - GLB 预算现在由区域配置契约化：`budget.glbSizeMb`、`nodes`、`images`、`triangles` 和
  `embeddedImageBytesMb` 可覆盖默认限制；任何放宽必须有 `budget.reason`。共享 digest 新增
  静态/实例化 render triangles、嵌入贴图字节、节点来源和最大贴图摘要，`diagnose:area`、