vis-core 0.33.18 → 0.33.20

package/README.md

@@ -1,10 +1,14 @@
 # vis-core
 
+资源地址统一通过 `vis-core/io` 的 `resolveResourceUrl(source, assetsPrefix)` 解析：完整 URL、协议相对 URL、`blob:`、`data:` 保持原样；相对路径与非空前缀之间保留一个斜杠，已带前缀的路径不重复添加，空前缀保留原相对路径。城市、地图边界、媒体加载与平台导出使用同一规则。`runtimeAssets.entries[].sources` 匹配原始请求，`path` 指向包内文件；ZIP 使用包内字节，解压部署的文件相对于 manifest URL 解析，不再叠加宿主前缀。SDK 默认 `strictBundleAssets: true`，仅允许包内资源或显式 `externalSources`；编辑器设为 `false`，未命中时使用规范化的外部地址，命中文件损坏仍报错。
+
 运行时使用 ZIP 分包：`manifest.json` 引用场景 JSON 和独立资源文件，场景沿用 Three.js 的 `images`、`textures`、`materials` 结构；`images[].url` 直接写相对文件路径（立方体贴图为路径数组），纹理保留原生采样参数。SHA-256、MIME、文件大小及 HDR／像素解码信息统一放在 `manifest.assets`。平台预览使用同一分包结构，资源文件保存在 IndexedDB。
 
-平台导出明确选择用途，默认“固定场景展示”：使用保存的地图和城市几何，不重复打包行政边界或建筑、道路、河流、绿地源数据；支持已保存场景之间的 `switchScene`，禁止运行时切换区域或重建。含区域切换交互的项目需要改选动态模式或移除该交互。未完成几何创建的对象仍会收集初始化所需资源。
+平台通过“地图下钻”统一配置预览与导出的导航。关闭时使用保存的地图和城市几何，不重复打包行政边界或建筑、道路、河流、绿地源数据。宿主仍可通过 SDK 的 `switchScene` / `back` 控制已保存场景。未完成几何创建的对象仍会收集初始化所需资源。
+
+下钻路径为世界 → 中国 → 省 → 市 → 区，模板按目标区域的实际行政层级选择。世界范围仅展开中国及其行政区；北京、天津、上海、重庆直接从省进入区模板。配置起始区域、最深层级与模板后，导出枚举全部目标区域。启用下钻后统一接管所选模板主地图的点击下钻与地图外部返回。到达终点或范围之外的点击不再导航；SDK 的显式区域切换仍严格检查范围。旧的 `scene.interactions` 配置直接忽略，导入和导出时移除，不迁移为新的导航规则。
 
-“支持运行时区域切换”需要配置根区域、最深层级，以及各层级使用的地图场景模板；同一模板可以用于多个层级。导出按照这份配置枚举目标区域，收集所选模板重建需要的行政边界和城市数据；未选作模板的场景仍按固定场景保存。数据可随 ZIP 打包，或显式选择由宿主部署共享目录。
+导出页只选择“完整离线包”或“共用地图目录”，直接复用项目下钻配置。同一模板可以用于多个层级；未选作模板的场景按固定场景保存。层级模板键为 `world`、`country`、`province`、`city`、`district`；`scope.rootAdcode` 为 0 时表示世界，100000 表示中国。
 
 配置保存在 `manifest.json` 的 `runtimeAssets.mapNavigation`，`runtimeAssets.regions` 列出每个模板允许切换的行政区。宿主调用 `manager.switchMapRegion(templateSceneId, adcode)`、`loadMapRegion` 或 `requestMapRegion` 时必须使用配置内的模板和区域；超出范围会在创建场景前报错，`strictBundleAssets: false` 也不会放开范围。SDK 不会根据未来的宿主调用自动扩大导出范围。预览沿用同一配置，自定义脚本也不能突破该范围，脚本额外请求的文件仍需登记。重新导出会移除旧包中不再需要的原始地理数据。
 
@@ -19,3 +23,5 @@
 SDK 仅接受当前场景 schema 6 和运行清单 schema 5，旧资源池和旧清单的迁移只在平台导入入口执行。`packSceneDocumentResources`、`expandSceneDocumentResources` 和 `ScenePackingCache` 已移除。普通所有权拷贝使用 `cloneSceneDocument`。
 
 平台模板、物体库和跨项目复制均使用含 `manifest.json` 与 `files/<sha256>` 的可编辑 ZIP；模板包括静态资源包和项目设置，复制包只携带选中资产的依赖。`ProjectResourceRepository` 统一管理媒体、地图数据、长脚本与静态资源包，历史差异仅持有路径。
+
+地图导出和模板保存按场景、材质及预制体的实际图片引用收集水面纹理。`assetSources.waterNormalMaps` 只是编辑默认配置，不会让默认 JPG 自动进入 ZIP；程序波浪水面无需图片，材质已引用的 `normalMap` 仍随包保存。重新导出会移除旧包中未再引用的默认水面文件，显式登记的额外资源仍会保留。