Refactor area preview orchestration

This commit is contained in:
que01 committed 2026-08-04 12:55:20 +08:00
1 parent 0ce7d1ea5e
commit 396df5127c
16 files changed
+541 -455

No files matched your search

+11 -6
View File
@@ -1,6 +1,7 @@
# Preview:Cesium 预览层
> 覆盖 `scripts/lib/cesium-preview.js`(672 行)与 `cesium-preview.css`(230 行)。
> 覆盖浏览器运行时 `scripts/lib/cesium-preview.js`(672 行)与
> `cesium-preview.css`(230 行),以及 Node 侧的 `scripts/lib/area-preview.js`。
> 运行时:浏览器。全仓唯一的 DOM 环境。
---
@@ -19,9 +20,9 @@
```
scripts/lib/cesium-preview.js ─── 原样 copyFileSync ──▶ outputs/<area>/cesium-preview.js
scripts/lib/cesium-preview.css ─── 原样 copyFileSync ──▶ outputs/<area>/cesium-preview.css
(build-area.js:328-335)
(area-preview.js:writeCesiumPreviewSupportFiles)
<area>-cesium-preview.html ─── 模板字符串生成 ────▶ 同目录
(build-area.js:697)
(area-preview.js:cesiumPreviewHtml)
```
所以:**没有打包、没有转译、没有 npm 依赖、没有模块系统**。浏览器直接吃。
@@ -40,18 +41,22 @@ const config = window.OSM_ASSET_PREVIEW_CONFIG || {}; // :4
// config.areaId / .glbName / .metadataName / .routeName / .vehicleModelName
```
生成侧在 `build-area.js:697 cesiumPreviewHtml()`,注入时**必须转义**:
生成侧在 `scripts/lib/area-preview.js` 的 `cesiumPreviewHtml()`,注入时**必须转义**:
| 场景 | 用 |
|---|---|
| HTML 文本/属性 | `escapeHtml()`(`build-area.js:759`) |
| `<script>` 里的 JSON | `escapeScriptJson()`(`:767`) |
| HTML 文本/属性 | `escapeHtml()` |
| `<script>` 里的 JSON | `escapeScriptJson()` |
`|| {}` 的兜底不能删——它让 JS 在没有配置块时也不至于在第一行就崩。
**加一个新的可配置项**:`cesiumPreviewHtml()` 里加进注入的 JSON,JS 侧从 `config` 读,
两边都要动。
`build-area.js` 只保留 GLB / metadata 依赖检查、写入顺序和 preview manifest ownership;
不要把 HTML 模板、runtime copy 或转义实现移回阶段调度器。路线 JSON 与车辆 glTF 分别由
`vehicle-route.js` 和 `vehicle-model.js` 生成,二者都是不启动外部工具的 Node 模块。
---
## 加载流程