City-Lifeline-Cockpit/.scratch/web-cockpit-decision-map/issues/06-cesium-fes-vite-integration.md

# Cesium integration into Fes and Vite

Type: research Status: resolved Labels: wayfinder:research Blocked by: None

进度：100%

已关闭。结论见下方 Answer；调研资产 cesium-fes-vite.md。

Question

在当前 TvT.js / Fes.js / Vite 工程里，怎样引入原生 CesiumJS，才能支撑常驻 MapCanvas、替换默认相机，并且不把驾驶舱做成插件？

必须查清：

• package.json 目前没有 cesium；应使用哪个包和哪个加载方式
• 与现有 TresJS / Three.js / Vite federation / publicPath ./ 的冲突
• worker、静态资源、CESIUM_BASE_URL 如何配置
• 现有 simpleGIS 等插件案例哪些可参考、哪些不能当驾驶舱主体依赖
• 对实现票 02、03、21 的约束（结论，不是实现）

发现写入本票链接的调研资产，不要改生产代码。

Answer

Add official npm package cesium and ESM-import it from a cockpit map service under src/modules/cockpit — not a TvT plugin, not CDN, not vue-cesium, not vite-plugin-cesium as the primary path.

Copy node_modules/cesium/Build/Cesium/{Workers,ThirdParty,Assets,Widgets} to cesium/ and set window.CESIUM_BASE_URL before importing cesium, resolved from publicPath: './' (Fes → Vite base) with a trailing slash. Under qiankun, use __INJECTED_PUBLIC_PATH_BY_QIANKUN__. Do not hardcode /cesium/. Hash routing (Fes default) keeps ./cesium/ valid; do not add cesium to federation shared.

MapCanvas is a persistent DOM host for one Viewer; it is not a TresCanvas. simpleGIS / geokit / 3d-tiles-renderer / three-tile are reference-only. simpleGIS cesiumIon is 3d-tiles-renderer plus a hardcoded Ion token — forbidden as runtime.

Constraints: 02 create Viewer once, resize() on panel layout, destroy() only on leaving /cockpit. 03 turn off SSCC enableRotate/Zoom/Tilt/Look (defaults are left-drag rotate, wheel/right-drag zoom) and own spring-arm via lookAtTransform + HeadingPitchRange. 21 Cesium3DTileset.fromUrl / CesiumTerrainProvider.fromUrl from config; no Terrain.fromWorldTerrain / Ion token.

Asset: cesium-fes-vite.md on branch research/cesium-fes-vite.