cesium_dev_kit 1.1.22 → 1.1.24

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (107) hide show
  1. package/CHANGELOG.md +90 -0
  2. package/README.md +299 -291
  3. package/README.zh-CN.md +279 -0
  4. package/SECURITY.md +21 -0
  5. package/dist/Analysis-BLpVrGfg.d.mts +143 -0
  6. package/dist/Analysis-DmO1gtgS.d.ts +143 -0
  7. package/dist/Base-DH8H9suE.d.mts +635 -0
  8. package/dist/Base-DH8H9suE.d.ts +635 -0
  9. package/dist/Base-_BOXyMdS.d.ts +43 -0
  10. package/dist/Base-skqjcPfo.d.mts +43 -0
  11. package/dist/Control-B7AMFmHe.d.ts +98 -0
  12. package/dist/Control-BrpRU7RP.d.mts +98 -0
  13. package/dist/CustomCesiumPlugin-BqgAvlhi.d.ts +29 -0
  14. package/dist/CustomCesiumPlugin-CKYQ-7i9.d.mts +29 -0
  15. package/dist/Draw-1NhPP8z3.d.mts +490 -0
  16. package/dist/Draw-DRh7yNzc.d.ts +490 -0
  17. package/dist/Graphics-CuFNsQ3b.d.ts +1565 -0
  18. package/dist/Graphics-QE3Gb43w.d.mts +1565 -0
  19. package/dist/Material-CeZ4l-tY.d.mts +165 -0
  20. package/dist/Material-Cqbyf2Pn.d.ts +165 -0
  21. package/dist/Math3d-0nO-vFbT.d.mts +179 -0
  22. package/dist/Math3d-t635PYzU.d.ts +179 -0
  23. package/dist/PassEffect-DEFyytQZ.d.ts +41 -0
  24. package/dist/PassEffect-DEgElnVk.d.mts +41 -0
  25. package/dist/Plugin-BPCX0zTu.d.mts +197 -0
  26. package/dist/Plugin-DnYT0bue.d.ts +197 -0
  27. package/dist/Primitive-BNXp-9_6.d.mts +199 -0
  28. package/dist/Primitive-UEAuUimH.d.ts +199 -0
  29. package/dist/ThreeJs-BAlEWxa1.d.mts +44 -0
  30. package/dist/ThreeJs-DpAcw_qf.d.ts +44 -0
  31. package/dist/analysis.cjs +145 -0
  32. package/dist/analysis.cjs.map +1 -0
  33. package/dist/analysis.d.mts +6 -0
  34. package/dist/analysis.d.ts +6 -0
  35. package/dist/analysis.mjs +145 -0
  36. package/dist/analysis.mjs.map +1 -0
  37. package/dist/control.cjs +140 -0
  38. package/dist/control.cjs.map +1 -0
  39. package/dist/control.d.mts +4 -0
  40. package/dist/control.d.ts +4 -0
  41. package/dist/control.mjs +140 -0
  42. package/dist/control.mjs.map +1 -0
  43. package/dist/custom-cesium-plugin.cjs +507 -0
  44. package/dist/custom-cesium-plugin.cjs.map +1 -0
  45. package/dist/custom-cesium-plugin.d.mts +4 -0
  46. package/dist/custom-cesium-plugin.d.ts +4 -0
  47. package/dist/custom-cesium-plugin.mjs +507 -0
  48. package/dist/custom-cesium-plugin.mjs.map +1 -0
  49. package/dist/default-static.cjs +3 -0
  50. package/dist/default-static.cjs.map +1 -0
  51. package/dist/default-static.d.mts +37 -0
  52. package/dist/default-static.d.ts +37 -0
  53. package/dist/default-static.mjs +3 -0
  54. package/dist/default-static.mjs.map +1 -0
  55. package/dist/draw.cjs +140 -0
  56. package/dist/draw.cjs.map +1 -0
  57. package/dist/draw.d.mts +6 -0
  58. package/dist/draw.d.ts +6 -0
  59. package/dist/draw.mjs +140 -0
  60. package/dist/draw.mjs.map +1 -0
  61. package/dist/graphics.cjs +140 -0
  62. package/dist/graphics.cjs.map +1 -0
  63. package/dist/graphics.d.mts +19 -0
  64. package/dist/graphics.d.ts +19 -0
  65. package/dist/graphics.mjs +140 -0
  66. package/dist/graphics.mjs.map +1 -0
  67. package/dist/index.cjs +1112 -0
  68. package/dist/index.cjs.map +1 -0
  69. package/dist/index.d.mts +674 -0
  70. package/dist/index.d.ts +674 -0
  71. package/dist/index.mjs +1112 -0
  72. package/dist/index.mjs.map +1 -0
  73. package/dist/material.cjs +391 -0
  74. package/dist/material.cjs.map +1 -0
  75. package/dist/material.d.mts +4 -0
  76. package/dist/material.d.ts +4 -0
  77. package/dist/material.mjs +391 -0
  78. package/dist/material.mjs.map +1 -0
  79. package/dist/pass-effect.cjs +416 -0
  80. package/dist/pass-effect.cjs.map +1 -0
  81. package/dist/pass-effect.d.mts +4 -0
  82. package/dist/pass-effect.d.ts +4 -0
  83. package/dist/pass-effect.mjs +416 -0
  84. package/dist/pass-effect.mjs.map +1 -0
  85. package/dist/plugin.cjs +141 -0
  86. package/dist/plugin.cjs.map +1 -0
  87. package/dist/plugin.d.mts +4 -0
  88. package/dist/plugin.d.ts +4 -0
  89. package/dist/plugin.mjs +141 -0
  90. package/dist/plugin.mjs.map +1 -0
  91. package/dist/primitive.cjs +370 -0
  92. package/dist/primitive.cjs.map +1 -0
  93. package/dist/primitive.d.mts +4 -0
  94. package/dist/primitive.d.ts +4 -0
  95. package/dist/primitive.mjs +370 -0
  96. package/dist/primitive.mjs.map +1 -0
  97. package/dist/three.cjs +140 -0
  98. package/dist/three.cjs.map +1 -0
  99. package/dist/three.d.mts +4 -0
  100. package/dist/three.d.ts +4 -0
  101. package/dist/three.mjs +140 -0
  102. package/dist/three.mjs.map +1 -0
  103. package/package.json +290 -46
  104. package/dist/index.js +0 -1
  105. package/dist/index.min.js +0 -1
  106. package/dist/index.umd.js +0 -1
  107. package/index.js +0 -37
package/CHANGELOG.md ADDED
@@ -0,0 +1,90 @@
1
+ # Changelog
2
+
3
+ 本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/) 规范。
4
+
5
+ ## [Unreleased]
6
+
7
+ ### 新增(Added)
8
+ - 示例页新增**源码面板**:每个 Demo 右下角多了一个 `</>` 图标,点开即在右侧展开与窗口等高的代码抽屉,顶部按目录展示当前示例的文件路径(如 `src/views/example/terrain/terrainEdit.vue`)、语言与行数,正文带行号与语法高亮(关键字、方法名、类名、变量、字符串、数字、注释分色),并支持一键复制全文;面板宽度可拖拽、`Esc` 关闭,首页 / 系统管理等非示例页面不显示入口。源码通过 `import.meta.glob('src/views/example/**/*.vue', { as: 'raw' })` 收集,新增示例无需维护映射表。
9
+ - 新增 **`TerrainEdit`(地形笔刷)** 模块:`setArea()` 就地铺一块可编辑区域后,**按住左键拖动即可连续涂抹**(下沉 / 抬升 / 整平 / 平滑,笔刷半径、强度、单笔高度、硬边均可调),实时改地形并即时重绘;同时保留多边形框选 + 一次成型的 `setPolygon()` + `apply()` 用法(塌陷/堆高/平整/平滑、台阶量化、坑底水面、土方统计)。`createKit()` 返回值新增 `terrainEdit` 字段,也可 `new TerrainEdit(viewer)` 单独使用。
10
+ 为了让编辑区「不像贴片」:地表直接向当前影像图层取瓦片拼成纹理贴到网格上(`buildImageryTexture`),保留原卫星影像;等高线改为 marching squares 按固定等高距生成(缓坡稀疏、陡坡密集)并随涂抹实时重画;编辑区边缘用 `alphaMap` 羽化进原地表,羽化带按像素距离叠加低频扰动,避免四条边是笔直的「贴片线」。
11
+ 由于 Cesium 的 `terrainProvider` 只读,实现方式为「先采样真实地形高度,再用 Three.js 局部规则格网覆盖多边形范围」,因此不污染全局地形,可随时 `undo()` / `clear()` 还原,也不影响范围外的地表。
12
+ - 新增纯算法层 `libs/terrain/terrainGrid.ts`:规则格网构建、到边界距离加权形变扩散(`smoothstep` 羽化)、台阶量化、多边形耳切三角剖分、土方量与顶点着色;不依赖 Cesium / Three,可独立单测与复用。
13
+ - 新增配套示例 `src/views/example/terrain/terrainEdit.vue`(菜单「地形编辑 → 地形开挖(塌陷/台阶/水面)」),含绘制范围、示例范围、模式/深度/台阶/水位调节、执行与撤销、统计面板。
14
+ - 新增单测 `tests/terrainGrid.test.ts`:覆盖点在多边形、面积误差、正负距离、格网 `stride`/`inside`/`weight`、四种形变模式、台阶量化不超过设定深度、挖填方统计、三角剖分与顶点去重。
15
+ - GitHub Pages 站点同时托管**在线 Demo**:文档在根路径、示例站发布在 `/demo/`,文档页顶部与侧边栏新增「在线 Demo」入口;演示站支持 `?auto=1` 用内置模拟账号直达,不再先落在登录页。
16
+ - 新增 `npm run build:demo:pages`:把示例站构建到 `docs/demo/`(`base: './'`,可直接挂在任意子路径下)。
17
+ - 新增 `cesium_dev_kit/default-static` 子路径,导出 `defaultStatic`、`createDefaultStatic()`、`DEFAULT_STATIC_BASE`:未显式传入 `defaultStatic` 时库内自动回退到默认 CDN,避免默认图片静默 404;支持一行代码切换到自有 CDN 或相对路径自托管。
18
+ - 发布现代化库产物:ESM(`*.mjs`)、CJS(`*.cjs`)、类型声明(`.d.ts` / `.d.mts`)与 sourcemap。
19
+ - `package.json` 增加 `main` / `module` / `types` / `exports` / `typesVersions` / `files` / `sideEffects`,支持按需引入子路径:`cesium_dev_kit/graphics`、`/primitive`、`/analysis` 等。
20
+ - 新增 `tsup.config.ts` 与 `npm run build:lib`,每个子路径入口自包含,避免 `graphics` 连带引入 `echarts` / `dat.gui`。
21
+ - 新增 `dispose()`:`initCesium` 与 `singleImport` 各模块均可释放由 kit 自己创建的 viewer;外部传入的 viewer 不会被销毁。
22
+ - 新增 `scripts/check-exports.mjs` 与 CI 校验,防止 `package.json` 导出路径与构建产物不一致。
23
+ - CI 升级为 Node 20/22/24 矩阵,并加入单测、类型检查、库构建、导出校验和 demo 构建。
24
+
25
+ ### 变更(Changed)
26
+ - CI 矩阵收敛为 **Node 20 / 22 / 24**,移除已停止维护的 18.x;`Release` 与 `Docs` 工作流统一使用 Node 24(自带 npm 11,可直接启用 Trusted Publishing)。
27
+ - `package-lock.json` 纳入版本管理,三个工作流的安装步骤由 `npm install` 改为 `npm ci`,构建可复现、不再因依赖浮动而出现「本地能跑、CI 挂掉」;`.gitignore` 不再忽略 lockfile(仅挡 `pnpm-lock.yaml` / `yarn.lock`)。
28
+ - **(破坏性)** 移除库内置的 Cesium Ion token。请通过 `extraConfig.AccessToken` 传入,或在应用入口设置 `Cesium.Ion.defaultAccessToken`。
29
+ - 运行依赖降为可选 peer 依赖:`dat.gui`、`echarts`、`libgif` 已移入 `peerDependencies` 并标记 `optional`,仅在用到控制面板 / 坡度剖面图 / GIF 导出时需安装;Vue / Element Plus / axios / OpenLayers 等演示站依赖移至 `devDependencies`。
30
+ - `dat.gui`、`echarts`、`libgif` 改为惰性 `import()` 加载:根入口 `import 'cesium_dev_kit'` 在 Node / SSR 环境不再因 `window` / `document` 未定义而报错。
31
+ - `three` 标记为可选 peer 依赖(`peerDependenciesMeta.three.optional = true`),只在 Three.js 集成场景需要安装。
32
+ - 高德/谷歌/百度影像的 7 个 `http://` 瓦片地址改为 `https://`,避免 HTTPS 站点混合内容被拦截。
33
+ - `cesium` 与 `three` 由 `dependencies` 调整为 `peerDependencies`,避免使用方重复打包、版本冲突。
34
+ - 放宽 `engines`:`node` 由 `==16.0.0` 调整为 `>=16.0.0`,`npm` 由 `==8.19.4` 调整为 `>=8.0.0`。
35
+ - `package.json` 补充 `description`、`keywords`、`repository`、`homepage`、`bugs` 等元数据,提升 npm 可发现性。
36
+
37
+ ### 变更(Changed)
38
+ - **地形笔刷内核重写:从「按权重减量」改成「目标标高平台」**。以前每笔按 `w × maxDelta` 逐次减,一阶导永远连续,刷出来只是原曲面整体压低一点的缩放版 —— 这才是「模糊、不像地形」的根因,换贴图和加开关都补不回来。现在每次落笔把笔刷核心(默认占半径 0.9)**压到同一个绝对标高**,核心到外沿只留一圈宽度跟着台阶落差走的窄过渡带(`BRUSH_WALL_PER_STEP`),不用 `smoothstep`(两端零斜率会把坑底和坑沿都抹圆);超过 34° 安息角的壁由 `relaxTalus` 限坡侵蚀成一圈直的塌方坡。于是单笔就是「平底 + 直壁 + 两道硬坡折」。实测斜坡上 281 个平台顶点高度极差 0、全部落在目标标高;按住 12 级后 101m 处出现清晰坡折。
39
+ - **整条笔画锁定目标标高**:`beginStroke()` 按第一笔落笔处对齐到台阶标高,拖动时沿途所有落笔共用它(`applyBrush` 也支持显式 `targetHeight`);只有指针停住不动时,喷洒定时器每拍把锁定标高再推进一级。于是「拖动 = 平底平台」「按住 = 一层层往下掉」两种手感都成立。实测沿缓坡拖 6 笔锁同一标高,沟底 21 点极差 0。
40
+ - **默认参数收敛,示例页不再靠开关规避劣质效果**:`strength` 默认 1(小于 1 坑底永远压不平)、`hardness` 默认 0.9、`roughness` 默认 0.28(只轻微揉边界,不再承担「让笔迹显形」);程序化岩土材质默认关闭 —— 立面只有几米宽,影像几乎不被拉伸,台阶层次改由几何坡折 + 不依赖开关的方向性明暗(迎光/背光)表现。示例页删掉「笔刷强度」「边缘棱角」「开挖面岩土」三个控件,只留笔刷半径、台阶落差、目标高程与两个显示选项;`setCutSurfaceEnabled()` / `setArea({ cutSurface })` / `roughness` 保留为高级 API。
41
+ - 喷洒节拍由 **80ms 放缓到 140ms**:现在每拍推进一级台阶而不是连续磨高度,太快会把层次糊成一片。`maxDelta` 的语义由「单次施加强度」改为「一级台阶的落差」(默认 3m)。
42
+ - 地形笔刷的**地表贴图分辨率按范围自适应**:2400m 范围由 2048(约 1.2m/像素)提到 3072(约 0.8m/像素),超大范围给到 4096 / 256 张瓦片,并让画布分辨率与瓦片原生分辨率对齐;同时把 mipmap 与各向异性过滤开到显卡上限,斜视角不再糊成一片。
43
+ - 地形笔刷交互改为**「按住左键不放就持续开挖 / 抬高」**:指针停住不动由固定节拍逐级下挖,松开左键立即停止;移动时**按走过的地面距离**施加(每 `radius × 0.1` 刷一次),涂抹密度只与路程有关,快拖慢拖深浅一致。
44
+
45
+ ### 修复(Fixed)
46
+ - 修复**挖深之后坑壁糊成一片、越挖越不像**:地表贴图是按经纬度平面投影取样的,坡面越陡被拉得越长(拉伸比 = `sqrt(1 + 坡度²)`)。实测挖到 480m 深、坑口半径只有 150m 时,坑壁接近垂直,影像被拉长十几倍,整面墙成了一团放射状色带——这不是分辨率不够,把贴图提到 8192 也治不了,因为要摊薄的是同一批像素。现在按「坡度 + 挖填深度」把这类坡面渐变成程序化岩土(三维噪声 + 层理 + 碎屑凹凸,用 `fwidth` 做距离淡出避免远处变成毛毡),影像只在缓坡与未改动的地表保留。(后续笔刷改为「目标标高平台」模型后,立面只剩几米宽,投影拉伸自然消失,这项程序化岩土已降级为默认关闭的高级选项。)
47
+ - 修复**下沉后坑底「顶出一块原地面」,看起来像叠加层被戳穿**:手绘范围一旦折返/自交,射线法的奇偶规则会把交点旁的一小块判成「区域外」,这块在格网里既没有面、笔刷也刷不到,于是它一直停在原始高度,周围挖下去之后就成了一块顶着原地面的孤岛。现在 `buildTerrainGrid` 默认做一次「从格网边界洪水填充」把被包住的内部空洞补成实心(补出来的点按内圈处理、给满权重、参与高度采样与笔刷),`setPolygon()` / `setArea()` 新增 `fillHoles` 开关(默认 `true`,需要镂空时显式关掉)。单测覆盖:`fillHoles: false` 复现空洞(`inside = 0`),默认情况下洞心被填平且能被笔刷挖动。
48
+ - 修复**一笔涂抹被重复叠加**:按住左键拖动时 `strokeAt()` 会被调用几十上百次,同一顶点只要还在笔刷范围内就每次再减一个 `maxDelta`,实测拖三趟能把中心点挖到 **376m** 深,坑壁近乎垂直、贴图被拉成竖条,从斜角看就像坑底「脱离」了地面。现在移动时按路程节流(`strokeBase` + 可选 `strokeLimit` 仍可用于限制单笔总深度,默认 0 不限制)。
49
+ - 修复笔刷**「按了没反应」**:此前把「一整笔的总量」压成了「单次施加」的量级,拖一整笔和单击一样深(实测均为 12m)。现在按住即持续累加,实测按住 1.5 秒下沉约 43m、抬升约 15m。
50
+ - 修复指针**滑出地形后定时器仍在旧位置继续挖**:`MOUSE_MOVE` 里拾取不到地表时直接 `return`,没更新「最后移动时间」,于是被判定为静止。现在只要指针真的动过就先记账,拾取不到则停掉持续施加。
51
+ - 修复 `level` 模式**第二次落笔沿用上一笔目标高度**、看起来像整平失效:自动推断出的 `targetHeight` 现在只在本次笔画内有效,`endStroke()` / `clear()` 时清掉,外部显式传入的目标高度不受影响。
52
+ - 修复 `enableBrush(false)` **关不掉笔刷**:原先只把开关置 false,`ScreenSpaceEventHandler` 从未销毁,左键拖地图时仍在落笔;现在关闭时会 `destroy()` 掉涂抹事件、把未结束的一笔 `endStroke()` 收尾并移除笔刷光标。
53
+ - 修复关闭笔刷后**左键拖不动地图**:Cesium 的 `rotateEventTypes` 默认是单个枚举值 `0`(不是数组),原先用 `if (prev.rotateEventTypes)` 判断为假而跳过恢复,左键就一直被留在笔刷上;改为统一按数组存取,并在恢复后兜底确保左键回到旋转事件里。`enableBrush` 也改为幂等,重复开启不会覆盖已保存的相机配置。
54
+ - 修复 Three 与 Cesium 合成时编辑区「随镜头上下浮动」:`ThreeScene.update()` 原顺序是先取相机矩阵再渲染 Cesium,导致 Three 永远用上一帧的矩阵,相机一动贴地内容就整体漂移;改为 `renderCesium() → updateCameraMatrix() → renderThree()` 后,拖拽/缩放实测逐帧误差 0 像素。
55
+ - 修复画完地形后坑体「看着是平的」:涂抹只改高度,法线重算后顶点色里的明暗仍是旧的;现在从 `_baseColors` 底色按新法线重烘一次(顶点色是破坏性相乘,不能在上次结果上叠加)。
56
+ - 修复 Demo 链接失效:`benpaodehenji.com` 域名已过期,README、文档导航(原 “Demo” 项)与首页全部改指 GitHub Pages 上的 `/demo/`。
57
+ - 修复 `getDfSt()` 在目标字段不存在时返回 `baseService + undefined` 的问题;绝对地址、`data:` URI 和站点根路径不再被错误拼接 `baseService`。
58
+ - 修复 README 示例中泄漏的真实天地图 token、失效的 `/src/views/...` 绝对路径、不存在的 `sceneMang` 字段,以及 `http://` 瓦片地址。
59
+ - `package.json` 的 `files` 改为包含整个 `dist`,修复 sourcemap 与 `.d.mts` 实际未发布的问题。
60
+ - CI 与 CHANGELOG 对齐:改为 Node 20/22/24 矩阵,执行 `typecheck`、`test`、`build:lib`、`check:exports`、`npm pack --dry-run`,移除 `strict-ssl false` 与不安全的 http registry 配置。
61
+ - 修正原型混入时使用 `instance.constructor` 作为 `Reflect.construct` newTarget 的问题:旧模块的 `X.prototype = { ... }` 会继承 `Object.prototype.constructor`,导致临时实例原型错误、`this._installXxx is not a function`。
62
+ - 修复 `Plugin.ts` 中 `setTimeout` 回调参数隐式 `any`,使 `tsup --dts` 可以正常生成类型声明。
63
+ - 修复 `dragDialog.ts`、`localstorage.ts` 的类型错误,`npm run typecheck` 现已通过。
64
+ - 移除 `package.json` 中的自我依赖 `cesium_dev_kit`。
65
+ - `Primitive` 模块 XyzAxisPrimitive `remove()` 中 `this._handler.distory()` 拼写错误修正为 `destroy()`。
66
+ - `Math3d.getPositionsAngle()` 中 `"heading "`(尾部多一个空格)修正为 `"heading"`,使偏航角分支真正生效。
67
+ - `Math2d.getFactorial2d()` 移除永远不命中的 `switch` 死分支,直接按阶乘计算(行为不变)。
68
+ - `Math2d.isClockWise` 此前只在接口声明、未实现,现补为 `isClockWise2d` 的别名(`getBisectorNormals2d` 调用处修复)。
69
+ - `Analysis` 方量分析中 `new Cesium.PolygonGeometry.fromPositions(...)` 误加 `new`(会抛 “not a constructor”)修正为直接调用。
70
+ - `Analysis` 坡度分析中 `appendChild(el, "dark", {...})` 多余参数移除。
71
+
72
+ ### 重构(Refactor)
73
+ - `Math2d`、`Math3d` 由「构造函数 + 原型赋值 + `as unknown as` 强转」重构为真正的 ES6 `class`(保留 `XxxInstance` / `XxxConstructor` 类型别名兼容旧引用)。
74
+ - 新增 `mixinPrototype(target, source)` 工具(`libs/Base.ts`),替代 `X.prototype = { ...X.prototype, ...Base.prototype }` 原型重写。
75
+ - `indexOld.ts` / `singleImport/Base.ts` 的 `exeClone` 由 `Object.keys` 改为 `Object.getOwnPropertyNames`(兼容 class 的非枚举方法)。
76
+ - 消除模块级全局状态:核心模块的 Cesium/dfSt 与拖拽等交互状态改为按实例隔离的闭包,新增 createScopedConstructor 包装器,多 viewer 并存互不覆盖。
77
+ - 标绘(plot)模块的 BasePlot / AttackArrow / StraightArrow / PincerArrow 也改为按实例隔离的 Cesium(`this._Cesium`),每个箭头实例使用各自传入的 `cesiumGlobal`;Sensor 入口移除冗余的模块级 `let Cesium`,直接使用 `cesiumGlobal` 参数。
78
+
79
+ ### 测试(Tests)
80
+ - 新增基于 `tsx` + Node 内置 `assert` 的单元测试,覆盖纯几何模块 `plot/plotUtil` 与 `Math2d`(无 Cesium 依赖)。
81
+ - `package.json` 新增 `test` 脚本与 `tsx` 开发依赖。
82
+
83
+ ### 类型(Types)
84
+ - 修正公开 API 拼写并提供向后兼容别名(旧名标记 `@deprecated`):`bindHandelEvent` → `bindHandleEvent`、`getHandelPosition` → `getHandlePosition`、`cluserColors( Type )` → `clusterColors( Type )`、`barLableType` → `barLabelType`。聚合图层同时兼容 `clusterColors` 与旧的 `cluserColors`。
85
+ - 为 `cesiumPluginsExtends` 下所有模块补齐 `XxxInstance` / `XxxConstructor` 接口与各方法 options 类型,消除约 1600 处 `any`。
86
+ - 集中 Cesium 类型引用:各模块不再各自 `import 'cesium'`,统一通过 `cesiumGlobal` 传入的 Cesium 对象,`CesiumGlobal` / `Viewer` 等类型由 `libs/Base.ts` 统一导出。
87
+
88
+ ## [1.1.23]
89
+
90
+ - 历史版本。详见 [GitHub releases](https://github.com/dengxiaoning/cesium_dev_kit/releases)。