@yangyongtao/gaea 1.1.34 → 1.1.35

package/src/GaeaMethods.js

@@ -1,10 +1,13 @@
-/**
+/**
  * gaea-3dview npm package
  *
- * 鍒濆鍖栧湪 new GaeaApp() 鏃惰嚜鍔ㄥ畬鎴愶紝Vue 椤甸潰鍙渶閰嶇疆銆? *
- * 鐢ㄦ硶锛? *   setConfig({ serveUrl: '...', serveLocal: '...' });
+ * 初始化在 new GaeaApp() 时自动完成，Vue 页面只需配置。
+ *
+ * 用法：
+ *   setConfig({ serveUrl: '...', serveLocal: '...' });
  *   const app = new GaeaApp();
- *   await app.ready;  // 鍙€夛紝绛夊緟鍒濆鍖栧畬鎴? */
+ *   await app.ready;  // 可选，等待初始化完成
+ */
 
 import { Group, Tween, Easing } from '@tweenjs/tween.js';
 window.TWEEN = { Group, Tween, Easing };
@@ -12,7 +15,7 @@ window.TWEEN = { Group, Tween, Easing };
 import Gaea from '../public/index.js';
 
 
-// ==================== Loading 鍔ㄧ敾 ====================
+// ==================== Loading 动画 ====================
 
 (function injectLoadingStyle() {
   if (document.getElementById('gaea-loading-style')) return;
@@ -51,7 +54,7 @@ import Gaea from '../public/index.js';
       transition: background 0.2s; backdrop-filter: blur(4px);
     }
     #gaea-layertree-btn:hover { background: rgba(0,0,0,0.7); }
-    /* 灞忓箷鍥炬爣鏍峰紡锛堝榻?ht_3dview锛?*/
+    /* 屏幕图标样式（对齐 ht_3dview） */
     .gaea-locationLineStyle {
       position: absolute; overflow: hidden; z-index: 1; pointer-events: auto;
       user-select: none; -webkit-user-select: none;
@@ -114,28 +117,30 @@ function hideLoading() {
 }
 
 
-// ==================== 閰嶇疆 ====================
+// ==================== 配置 ====================
 
-/** 榛樿寮曟搸璧勬簮鏈嶅姟鍣ㄥ湴鍧€锛圙aea.pck / Gaea.wasm 绛夊ぇ鏂囦欢锛夛紝鍙湪杩愯鏃?鐜鍙橀噺瑕嗙洊 */
+/** 默认引擎资源服务器地址（Gaea.pck / Gaea.wasm 等大文件），可在运行时/环境变量覆盖 */
 const DEFAULT_ENGINE_ASSETS_URL = 'http://172.20.176.100:7072/gaea/Gaea';
 
 /**
- * 瑙ｆ瀽榛樿 executable锛? * 浼樺厛绾э細杩愯鏃跺叏灞€鍙橀噺 window.__GAEA_ASSETS_URL__锛堝涓荤珯鐐?config.js 鍙缃紝
- * 鎹㈠湴鍧€鏃犻渶閲嶆柊鎵撳寘锛? dev 鐜鏈湴 /Gaea锛堣蛋 vite dev server 涓棿浠讹紝涓嶄緷璧栫嚎涓婏級
- * > 鏋勫缓鐜鍙橀噺 VITE_GAEA_EXECUTABLE > 鍐呯疆榛樿璧勬簮鏈嶅姟鍣ㄥ湴鍧€銆? */
+ * 解析默认 executable：
+ * 优先级：运行时全局变量 window.__GAEA_ASSETS_URL__（宿主站点 config.js 可设置，
+ * 换地址无需重新打包）> dev 环境本地 /Gaea（走 vite dev server 中间件，不依赖线上）
+ * > 构建环境变量 VITE_GAEA_EXECUTABLE > 内置默认资源服务器地址。
+ */
 function resolveDefaultExecutable() {
   if (typeof window !== 'undefined' && window.__GAEA_ASSETS_URL__) {
     return window.__GAEA_ASSETS_URL__;
   }
   try {
     if (import.meta.env) {
-      // dev 寮€鍙戯細寮曟搸璧勬簮璧?vite dev server 涓棿浠讹紙鏈湴 gaea public锛夛紝鏃犻渶璁块棶绾夸笂
+      // dev 开发：引擎资源走 vite dev server 中间件（本地 gaea public），无需访问线上
       if (import.meta.env.DEV) return '/Gaea';
-      // 鏋勫缓鏃跺彲鐢ㄧ幆澧冨彉閲忚鐩栵紙濡傛湰鍦版祴璇?build 浜х墿鎸囧悜鏈湴璧勬簮鏈嶅姟鍣級
+      // 构建时可用环境变量覆盖（如本地测试 build 产物指向本地资源服务器）
       if (import.meta.env.VITE_GAEA_EXECUTABLE) return import.meta.env.VITE_GAEA_EXECUTABLE;
     }
   } catch (e) {
-    /* 闈?vite 鐜蹇界暐 */
+    /* 非 vite 环境忽略 */
   }
   return DEFAULT_ENGINE_ASSETS_URL;
 }
@@ -143,151 +148,153 @@ function resolveDefaultExecutable() {
 const defaultConfig = {
   serveUrl: '',
   serveLocal: '',
-  // Engine 閰嶇疆
+  // Engine 配置
   executable: resolveDefaultExecutable(),
   fileSizes: { 'Gaea.pck': 450751936, 'Gaea.wasm': 16580215 },
   canvasResizePolicy: 2,
   experimentalVK: false,
   focusCanvas: true,
   /**
-   * 鏈嶅姟妯″紡锛?   * 'platform' - 鏈嶅姟骞冲彴锛氬奖鍍忚蛋 serveUrl 鐨?WMTS锛屽苟鍔犺浇鍦板舰銆佽创鍦扮嚎
-   * 'online'   - 鍦ㄧ嚎锛氫粎鍔犺浇澶╁湴鍥惧奖鍍忥紝涓嶅姞杞藉湴褰㈠拰璐村湴绾?   */
+   * 服务模式：
+   * 'platform' - 服务平台：影像走 serveUrl 的 WMTS，并加载地形、贴地线
+   * 'online'   - 在线：仅加载天地图影像，不加载地形和贴地线
+   */
   serviceMode: 'platform',
-  /** 澶╁湴鍥?token锛堝湪绾挎ā寮忎娇鐢級 */
+  /** 天地图 token（在线模式使用） */
   tiandituToken: '63201cfd7df1e1bff7d88bb8baa32151',
-  /** 澶╁湴鍥炬渶灏?鏈€澶у眰绾?*/
+  /** 天地图最小/最大层级 */
   tiandituLevelRange: [0, 21],
-  /** 榛樿鍔犺浇鐨勫奖鍍忓浘灞傦紙鏈嶅姟骞冲彴妯″紡鐢熸晥锛?*/
+  /** 默认加载的影像图层（服务平台模式生效） */
   defaultLayers: [
     { layerName: 'earthland', forMat: 'image/png', min: 0, max: 18, transparency: 0.3 },
-    { layerName: '鑻嶅崡L19',  forMat: 'image/png', min: 5, max: 17 },
+    { layerName: '苍南L19',  forMat: 'image/png', min: 5, max: 17 },
   ],
-  /** 榛樿鍔犺浇鐨勫湴褰㈡湇鍔★紙璧?serveUrl锛寀rl 涓虹浉瀵硅矾寰勬垨瀹屾暣鍦板潃锛涚┖鏁扮粍鍒欎笉鍔犺浇锛?*/
+  /** 默认加载的地形服务（走 serveUrl，url 为相对路径或完整地址；空数组则不加载） */
   defaultTerrains: [
-    { name: '鑻嶅崡鍘垮湴褰?, url: 'htc/service/tms/1.0.0/鑻嶅崡鍘垮湴褰EPSG%3A4326@terrain/' },
+    { name: '苍南县地形', url: 'htc/service/tms/1.0.0/苍南县地形@EPSG%3A4326@terrain/' },
   ],
-  /** 榛樿鍔犺浇鐨勮创鍦扮嚎锛堢煝閲忕嚎鏈嶅姟锛屼緷璧?WMTS 鏈嶅姟鍒楄〃锛涚┖鏁扮粍鍒欎笉鍔犺浇锛?*/
+  /** 默认加载的贴地线（矢量线服务，依赖 WMTS 服务列表；空数组则不加载） */
   defaultGroundLines: [
-    { name: '鑻嶅崡鍘胯竟鐣?,        range: [0, 9],   color: [255, 255, 0],   index: 100 },
-    { name: '鑻嶅崡鍘块晣杈圭晫',      range: [9, 15],  color: [0, 255, 0],     index: 80 },
-    { name: '鑻嶅崡鍘挎潙杈圭晫',      range: [15, 19], color: [255, 255, 255], index: 60 },
-    { name: '娌挎郸娴峰宸ョ▼鑼冨洿绾?, range: [0, 21],  color: [0, 255, 255],   index: 120 },
+    { name: '苍南县边界',        range: [0, 9],   color: [255, 255, 0],   index: 100 },
+    { name: '苍南县镇边界',      range: [9, 15],  color: [0, 255, 0],     index: 80 },
+    { name: '苍南县村边界',      range: [15, 19], color: [255, 255, 255], index: 60 },
+    { name: '沿浦海塘工程范围线', range: [0, 21],  color: [0, 255, 255],   index: 120 },
   ],
-  /** 榛樿鍔犺浇鐨勫€炬枩鎽勫奖 3D Tiles锛堢┖鏁扮粍鍒欎笉鍔犺浇锛?*/
+  /** 默认加载的倾斜摄影 3D Tiles（空数组则不加载） */
   default3DTiles: [],
-  /** 榛樿鐩告満瑙嗚 */
+  /** 默认相机视角 */
   defaultCameraPosition: '27.3680928977018,120.414139621887,0,109379.690132486,0,0',
-  /** 寮曟搸鍔犺浇杩涘害鍥炶皟 */
+  /** 引擎加载进度回调 */
   onProgress: null,
-  /** 寮曟搸鍔犺浇鎻愮ず鏂囧瓧 */
-  loadingText: 'GAEA 寮曟搸鍔犺浇涓?..',
-  /** DataHub API 鍦板潃锛堝浘灞傛爲鏁版嵁鎺ュ彛锛夛紝涓虹┖鍒欏彧鐢ㄩ粯璁ゆ暟鎹?*/
+  /** 引擎加载提示文字 */
+  loadingText: 'GAEA 引擎加载中...',
+  /** DataHub API 地址（图层树数据接口），为空则只用默认数据 */
   dataHubApiUrl: '',
-  /** 鏄惁鏄剧ず鍥惧眰鏍戞寜閽紙鍙充笂瑙掗噸缃寜閽梺杈癸級 */
+  /** 是否显示图层树按钮（右上角重置按钮旁边） */
   showLayerTreeBtn: false,
-  /** 榛樿闅愯棌鐨勫垎绫?key 鍒楄〃锛屽 ['rainStations', 'rescue'] */
+  /** 默认隐藏的分类 key 列表，如 ['rainStations', 'rescue'] */
   defaultHiddenCategories: [],
-  /** 鍥惧眰鏍戝垎绫绘暟鎹紙榛樿鏁版嵁锛屾帴鍙ｆ暟鎹細鍚堝苟杩涙潵锛?*/
+  /** 图层树分类数据（默认数据，接口数据会合并进来） */
   layerCategories: [
-    { key: 'seawall',             text: '娴峰',       visible: true,  children: [
-      { text: '娌挎郸娴峰',   level: '3', imgUrl: '/image/screenIcon/娴峰-3绾?png', position: { x: 27.220705, y: 120.457998, z: 20 } },
-      { text: '闇炲叧娴峰',   level: '3', imgUrl: '/image/screenIcon/娴峰-3绾?png', position: { x: 27.171059, y: 120.467901, z: 20 } },
-      { text: '涓夎寙娴峰',   level: '4', imgUrl: '/image/screenIcon/娴峰-4绾?png', position: { x: 27.193284, y: 120.464411, z: 20 } },
-      { text: '澶ф笖娴峰',   level: '2', imgUrl: '/image/screenIcon/娴峰-2绾?png', position: { x: 27.39027,  y: 120.599554, z: 20 } },
-      { text: '淇℃櫤娴峰',   level: '4', imgUrl: '/image/screenIcon/娴峰-4绾?png', position: { x: 27.300806, y: 120.544077, z: 20 } },
-      { text: '涓嬪湪娴峰',   level: '3', imgUrl: '/image/screenIcon/娴峰-3绾?png', position: { x: 27.215789, y: 120.445849, z: 10 } },
-      { text: '鏈ㄦ灄娴峰',   level: '5', imgUrl: '/image/screenIcon/娴峰-5绾?png', position: { x: 27.193183, y: 120.424486, z: 20 } },
-      { text: '闆惧煄娴峰',   level: '4', imgUrl: '/image/screenIcon/娴峰-4绾?png', position: { x: 27.27682,  y: 120.518917, z: 20 } },
-      { text: '娓斿矙娴峰',   level: '4', imgUrl: '/image/screenIcon/娴峰-4绾?png', position: { x: 27.403744, y: 120.557879, z: 20 } },
-      { text: '娴佸矏宀欐捣濉?, level: '4', imgUrl: '/image/screenIcon/娴峰-4绾?png', position: { x: 27.318176, y: 120.542761, z: 20 } },
+    { key: 'seawall',             text: '海塘',       visible: true,  children: [
+      { text: '沿浦海塘',   level: '3', imgUrl: '/image/screenIcon/海塘-3级.png', position: { x: 27.220705, y: 120.457998, z: 20 } },
+      { text: '霞关海塘',   level: '3', imgUrl: '/image/screenIcon/海塘-3级.png', position: { x: 27.171059, y: 120.467901, z: 20 } },
+      { text: '三茆海塘',   level: '4', imgUrl: '/image/screenIcon/海塘-4级.png', position: { x: 27.193284, y: 120.464411, z: 20 } },
+      { text: '大渔海塘',   level: '2', imgUrl: '/image/screenIcon/海塘-2级.png', position: { x: 27.39027,  y: 120.599554, z: 20 } },
+      { text: '信智海塘',   level: '4', imgUrl: '/image/screenIcon/海塘-4级.png', position: { x: 27.300806, y: 120.544077, z: 20 } },
+      { text: '下在海塘',   level: '3', imgUrl: '/image/screenIcon/海塘-3级.png', position: { x: 27.215789, y: 120.445849, z: 10 } },
+      { text: '木林海塘',   level: '5', imgUrl: '/image/screenIcon/海塘-5级.png', position: { x: 27.193183, y: 120.424486, z: 20 } },
+      { text: '雾城海塘',   level: '4', imgUrl: '/image/screenIcon/海塘-4级.png', position: { x: 27.27682,  y: 120.518917, z: 20 } },
+      { text: '渔岙海塘',   level: '4', imgUrl: '/image/screenIcon/海塘-4级.png', position: { x: 27.403744, y: 120.557879, z: 20 } },
+      { text: '流岐岙海塘', level: '4', imgUrl: '/image/screenIcon/海塘-4级.png', position: { x: 27.318176, y: 120.542761, z: 20 } },
     ]},
-    { key: 'hydrometricStations', text: '姘存枃绔?,     visible: true,  children: [
-      { text: '鐏垫邯',   stcd: '7010CK01', sttp: 'ZQ', position: { x: 27.5014, y: 120.3847, z: 100 } },
-      { text: '娴佺煶',   stcd: '7010CK02', sttp: 'ZQ', position: { x: 27.5029, y: 120.4615, z: 100 } },
-      { text: '瑙傜編',   stcd: '7050CK02', sttp: 'ZQ', position: { x: 27.4658, y: 120.364,  z: 100 } },
-      { text: '妗傚叞婧?, stcd: '7061CK68', sttp: 'ZQ', position: { x: 27.4584, y: 120.3071, z: 100 } },
+    { key: 'hydrometricStations', text: '水文站',     visible: true,  children: [
+      { text: '灵溪',   stcd: '7010CK01', sttp: 'ZQ', position: { x: 27.5014, y: 120.3847, z: 100 } },
+      { text: '流石',   stcd: '7010CK02', sttp: 'ZQ', position: { x: 27.5029, y: 120.4615, z: 100 } },
+      { text: '观美',   stcd: '7050CK02', sttp: 'ZQ', position: { x: 27.4658, y: 120.364,  z: 100 } },
+      { text: '桂兰溪', stcd: '7061CK68', sttp: 'ZQ', position: { x: 27.4584, y: 120.3071, z: 100 } },
     ]},
-    { key: 'tideStations',        text: '娼綅绔?,     visible: true,  children: [] },
-    { key: 'riverStations',       text: '娌抽亾姘翠綅绔?, visible: true,  children: [] },
-    { key: 'rainStations',        text: '闆ㄩ噺绔?,     visible: true,  children: [] },
-    { key: 'reservoirs',          text: '姘村簱',       visible: true,  children: [] },
-    { key: 'sluice',              text: '姘撮椄',       visible: true,  children: [
-      { text: '鑱旂洘姘撮椄',       position: { x: 27.200462, y: 120.465635, z: 50 } },
-      { text: '娌挎郸姘撮椄',       position: { x: 27.222987, y: 120.453175, z: 20 } },
-      { text: '涓嬪湪姘撮椄',       position: { x: 27.221816, y: 120.445182, z: 50 } },
-      { text: '涓嬪湪娴峰绾虫帓闂?, position: { x: 27.219978, y: 120.445672, z: 50 } },
-      { text: '宀熬姘撮椄',       position: { x: 27.215762, y: 120.462235, z: 40 } },
-      { text: '宀熬鏂伴椄',       position: { x: 27.210369, y: 120.458532, z: 10 } },
+    { key: 'tideStations',        text: '潮位站',     visible: true,  children: [] },
+    { key: 'riverStations',       text: '河道水位站', visible: true,  children: [] },
+    { key: 'rainStations',        text: '雨量站',     visible: true,  children: [] },
+    { key: 'reservoirs',          text: '水库',       visible: true,  children: [] },
+    { key: 'sluice',              text: '水闸',       visible: true,  children: [
+      { text: '联盟水闸',       position: { x: 27.200462, y: 120.465635, z: 50 } },
+      { text: '沿浦水闸',       position: { x: 27.222987, y: 120.453175, z: 20 } },
+      { text: '下在水闸',       position: { x: 27.221816, y: 120.445182, z: 50 } },
+      { text: '下在海塘纳排闸', position: { x: 27.219978, y: 120.445672, z: 50 } },
+      { text: '岭尾水闸',       position: { x: 27.215762, y: 120.462235, z: 40 } },
+      { text: '岭尾新闸',       position: { x: 27.210369, y: 120.458532, z: 10 } },
     ]},
-    { key: 'secData',             text: '鏂潰鏁版嵁',   visible: true,  children: [
+    { key: 'secData',             text: '断面数据',   visible: true,  children: [
       { text: 'YPDP0+600', position: { x: 27.217692, y: 120.461823, z: 30 },
         indexList: {
-          1: { label: '绱犲～鍦?, details: ['鎴愬垎: 浜哄伐鍥炲～榛忔€у湡', '鍘氬害: 绾?.5m', '浣滅敤: 琛ㄥ眰瑕嗙洊闃叉姢'] },
-          2: { label: '娣ゆ偿', details: ['绫诲埆: 娴风浉娣ゆ偿', '棰滆壊: 鐏伴粦鑹?, '鐘舵€? 娴佸', '鍚按鐜? 绾?5%'] },
-          3: { label: '6.89', details: ['绫诲瀷: 鍫ら《璁捐楂樼▼', '鏁板€? 6.89m', '浣滅敤: 闃叉椽鍫ゅ潩椤堕儴鏍囬珮'] },
-          4: { label: '6.00', details: ['绫诲瀷: 璁捐娲按浣?, '鏁板€? 6.00m', '鏍囧噯: 閲嶇幇鏈烶=5%'] },
-          5: { label: '妞嶈鎶ゅ潯', details: ['绫诲瀷: 鑽夌毊鎶ゅ潯', '鍧″害: 1:2', '浣滅敤: 闃叉鍧￠潰闆ㄦ按鍐插埛'] },
-          6: { label: '3.00', details: ['绫诲瀷: 甯告按浣?, '鏁板€? 3.00m', '浣滅敤: 鏃ュ父杩愯姘翠綅绾?] },
-          7: { label: '鐮栫煶娣峰悎鏂欏～绛?, details: ['鎴愬垎: 鐮栫煶涓庨粡鍦熸贩鍚?, '鍘氬害: 绾?.5m', '浣滅敤: 鍫よ韩濉瓚涓讳綋'] },
-          8: { label: '2.00', details: ['绫诲瀷: 鍫よ剼楂樼▼', '鏁板€? 2.00m', '浣滅敤: 鍫ゅ潩搴曢儴鍩虹鏍囬珮'] },
-          9: { label: '3.94璁捐娲按P=5%', details: ['绫诲瀷: 璁捐娲按浣?, '棰戠巼: 5%(20骞翠竴閬?', '鏁板€? 3.94m', '浣滅敤: 鍫ら槻璁捐鏍囧噯姘翠綅'] },
-          10: { label: '4.5', details: ['绫诲瀷: 璁捐楂樻疆浣?, '鏍囧噯: 50骞翠竴閬?, '鏁板€? 4.45m', '浣滅敤: 娴峰牑闃叉疆鏍囧噯'] },
-          11: { label: '50骞翠竴閬囪璁￠珮娼綅4.45m', details: ['绫诲瀷: 璁捐楂樻疆浣?, '閲嶇幇鏈? 50骞?, '鏁板€? 4.45m', '浣滅敤: 鏍℃牳鍫ら《楂樼▼'] },
+          1: { label: '素填土', details: ['成分: 人工回填黏性土', '厚度: 约1.5m', '作用: 表层覆盖防护'] },
+          2: { label: '淤泥', details: ['类别: 海相淤泥', '颜色: 灰黑色', '状态: 流塑', '含水率: 约55%'] },
+          3: { label: '6.89', details: ['类型: 堤顶设计高程', '数值: 6.89m', '作用: 防洪堤坝顶部标高'] },
+          4: { label: '6.00', details: ['类型: 设计洪水位', '数值: 6.00m', '标准: 重现期P=5%'] },
+          5: { label: '植被护坡', details: ['类型: 草皮护坡', '坡度: 1:2', '作用: 防止坡面雨水冲刷'] },
+          6: { label: '3.00', details: ['类型: 常水位', '数值: 3.00m', '作用: 日常运行水位线'] },
+          7: { label: '砖石混合料填筑', details: ['成分: 砖石与黏土混合', '厚度: 约2.5m', '作用: 堤身填筑主体'] },
+          8: { label: '2.00', details: ['类型: 堤脚高程', '数值: 2.00m', '作用: 堤坝底部基础标高'] },
+          9: { label: '3.94设计洪水P=5%', details: ['类型: 设计洪水位', '频率: 5%(20年一遇)', '数值: 3.94m', '作用: 堤防设计标准水位'] },
+          10: { label: '4.5', details: ['类型: 设计高潮位', '标准: 50年一遇', '数值: 4.45m', '作用: 海堤防潮标准'] },
+          11: { label: '50年一遇设计高潮位4.45m', details: ['类型: 设计高潮位', '重现期: 50年', '数值: 4.45m', '作用: 校核堤顶高程'] },
         },
         favorite: '27.2201168867619,120.460489990829,152.923049719807,297.140390154652,50.2192727515776,0.00126576050689737',
          secAnimation: [{x:27.217703, y:120.46207, z:32}, {x:27.217626, y:120.461815, z:32}, {x:27.217433, y:120.461448, z:32}] },
       { text: 'YPDP0+100', position: { x: 27.223027, y: 120.454653, z: 30 },
         indexList: {
-          1: { label: '娣ゆ偿', details: ['绫诲埆: 娴风浉娣ゆ偿', '棰滆壊: 鐏伴粦鑹?, '鐘舵€? 娴佸'] },
-          2: { label: '绱犲湡', details: ['绫诲埆: 澶╃劧娌夌Н鍦?, '棰滆壊: 榛勮鑹?, '鐘舵€? 鍙', '鎵胯浇鍔? 涓€鑸?] },
-          3: { label: '鐮栫煶娣峰悎鏉愭枡濉瓚', details: ['鎴愬垎: 鐮栫煶涓庨粡鍦熸贩鍚?, '鍘氬害: 绾?m', '浣滅敤: 鍫よ韩濉瓚涓讳綋'] },
-          4: { label: '6.98', details: ['绫诲瀷: 鍫ら《璁捐楂樼▼', '鏁板€? 6.98m'] },
-          5: { label: '6.00', details: ['绫诲瀷: 璁捐娲按浣?, '鏁板€? 6.00m', '鏍囧噯: P=5%'] },
-          6: { label: '3.94', details: ['绫诲瀷: 璁捐娲按浣?, '棰戠巼: 5%', '鏁板€? 3.94m'] },
-          7: { label: '2.00', details: ['绫诲瀷: 鍫よ剼楂樼▼', '鏁板€? 2.00m'] },
-          8: { label: '4.5', details: ['绫诲瀷: 璁捐楂樻疆浣?, '鏍囧噯: 50骞翠竴閬?, '鏁板€? 4.45m'] },
+          1: { label: '淤泥', details: ['类别: 海相淤泥', '颜色: 灰黑色', '状态: 流塑'] },
+          2: { label: '素土', details: ['类别: 天然沉积土', '颜色: 黄褐色', '状态: 可塑', '承载力: 一般'] },
+          3: { label: '砖石混合材料填筑', details: ['成分: 砖石与黏土混合', '厚度: 约2m', '作用: 堤身填筑主体'] },
+          4: { label: '6.98', details: ['类型: 堤顶设计高程', '数值: 6.98m'] },
+          5: { label: '6.00', details: ['类型: 设计洪水位', '数值: 6.00m', '标准: P=5%'] },
+          6: { label: '3.94', details: ['类型: 设计洪水位', '频率: 5%', '数值: 3.94m'] },
+          7: { label: '2.00', details: ['类型: 堤脚高程', '数值: 2.00m'] },
+          8: { label: '4.5', details: ['类型: 设计高潮位', '标准: 50年一遇', '数值: 4.45m'] },
         },
         favorite: '27.2241401069656,120.45184648674,114.05854266096,366.355033916145,42.1285030727423,359.999914392757',
          secAnimation: [{x:27.223145, y:120.454946, z:30}, {x:27.223085, y:120.454756, z:30}, {x:27.222844, y:120.454466, z:30}] },
       { text: 'YPDP0+200', position: { x: 27.222541, y: 120.455453, z: 30 },
         indexList: {
-          0: { label: '娣ゆ偿', details: ['绫诲埆: 娴风浉娣ゆ偿', '棰滆壊: 鐏伴粦鑹?, '鐘舵€? 娴佸'] },
-          1: { label: '绱犲湡', details: ['绫诲埆: 澶╃劧娌夌Н鍦?, '棰滆壊: 榛勮鑹?, '鐘舵€? 鍙'] },
-          2: { label: '鐮栫煶娣峰悎鏉愭枡濉瓚', details: ['鎴愬垎: 鐮栫煶涓庨粡鍦熸贩鍚?, '浣滅敤: 鍫よ韩濉瓚涓讳綋'] },
-          3: { label: '6.98', details: ['绫诲瀷: 鍫ら《璁捐楂樼▼', '鏁板€? 6.98m'] },
-          4: { label: '6.00', details: ['绫诲瀷: 璁捐娲按浣?, '鏁板€? 6.00m', '鏍囧噯: P=5%'] },
-          5: { label: '3.94', details: ['绫诲瀷: 璁捐娲按浣?, '棰戠巼: 5%', '鏁板€? 3.94m'] },
-          6: { label: '2.00', details: ['绫诲瀷: 鍫よ剼楂樼▼', '鏁板€? 2.00m'] },
-          7: { label: '4.5', details: ['绫诲瀷: 璁捐楂樻疆浣?, '鏍囧噯: 50骞翠竴閬?, '鏁板€? 4.45m'] },
+          0: { label: '淤泥', details: ['类别: 海相淤泥', '颜色: 灰黑色', '状态: 流塑'] },
+          1: { label: '素土', details: ['类别: 天然沉积土', '颜色: 黄褐色', '状态: 可塑'] },
+          2: { label: '砖石混合材料填筑', details: ['成分: 砖石与黏土混合', '作用: 堤身填筑主体'] },
+          3: { label: '6.98', details: ['类型: 堤顶设计高程', '数值: 6.98m'] },
+          4: { label: '6.00', details: ['类型: 设计洪水位', '数值: 6.00m', '标准: P=5%'] },
+          5: { label: '3.94', details: ['类型: 设计洪水位', '频率: 5%', '数值: 3.94m'] },
+          6: { label: '2.00', details: ['类型: 堤脚高程', '数值: 2.00m'] },
+          7: { label: '4.5', details: ['类型: 设计高潮位', '标准: 50年一遇', '数值: 4.45m'] },
         },
         favorite: '27.2239199251089,120.452312356798,114.058543530715,366.288499980401,42.128503423954,359.999913220015',
          secAnimation: [{x:27.222801, y:120.455528, z:30}, {x:27.222681, y:120.455458, z:30}, {x:27.22226, y:120.455318, z:30}] },
       { text: 'YPDP0+750', position: { x: 27.220289, y: 120.459753, z: 30 },
         indexList: {
-          0: { label: '娣ゆ偿', details: ['绫诲埆: 娴风浉娣ゆ偿', '棰滆壊: 鐏伴粦鑹?, '鐘舵€? 娴佸'] },
-          1: { label: '鐮栫煶娣峰悎鏂欏～绛?, details: ['鎴愬垎: 鐮栫煶涓庨粡鍦熸贩鍚?, '鍘氬害: 绾?.5m', '浣滅敤: 鍫よ韩濉瓚涓讳綋'] },
-          2: { label: '7.00', details: ['绫诲瀷: 鍫ら《璁捐楂樼▼', '鏁板€? 7.00m'] },
-          3: { label: '6.00', details: ['绫诲瀷: 璁捐娲按浣?, '鏁板€? 6.00m', '鏍囧噯: P=5%'] },
-          4: { label: '3.94', details: ['绫诲瀷: 璁捐娲按浣?, '棰戠巼: 5%', '鏁板€? 3.94m'] },
-          5: { label: '2.00', details: ['绫诲瀷: 鍫よ剼楂樼▼', '鏁板€? 2.00m'] },
-          6: { label: '4.5', details: ['绫诲瀷: 璁捐楂樻疆浣?, '鏍囧噯: 50骞翠竴閬?, '鏁板€? 4.45m'] },
-          7: { label: '妞嶈鎶ゅ潯', details: ['绫诲瀷: 鑽夌毊鎶ゅ潯', '鍧″害: 1:2', '浣滅敤: 闃叉鍧￠潰鍐插埛'] },
+          0: { label: '淤泥', details: ['类别: 海相淤泥', '颜色: 灰黑色', '状态: 流塑'] },
+          1: { label: '砖石混合料填筑', details: ['成分: 砖石与黏土混合', '厚度: 约2.5m', '作用: 堤身填筑主体'] },
+          2: { label: '7.00', details: ['类型: 堤顶设计高程', '数值: 7.00m'] },
+          3: { label: '6.00', details: ['类型: 设计洪水位', '数值: 6.00m', '标准: P=5%'] },
+          4: { label: '3.94', details: ['类型: 设计洪水位', '频率: 5%', '数值: 3.94m'] },
+          5: { label: '2.00', details: ['类型: 堤脚高程', '数值: 2.00m'] },
+          6: { label: '4.5', details: ['类型: 设计高潮位', '标准: 50年一遇', '数值: 4.45m'] },
+          7: { label: '植被护坡', details: ['类型: 草皮护坡', '坡度: 1:2', '作用: 防止坡面冲刷'] },
         },
         favorite: '27.2220502555847,120.457317110875,125.021048589548,347.301009802588,44.1512225983844,0.0020422112185327',
          secAnimation: [{x:27.220482, y:120.459976, z:30}, {x:27.220375, y:120.459853, z:30}, {x:27.220072, y:120.459602, z:30}] },
     ]},
-    { key: 'uavNests',            text: '鏃犱汉鏈哄发绔?, visible: true,  children: [] },
-    { key: 'rescue',              text: '闅愭偅',       visible: false, children: [
-      { text: '闅愭偅1', position: { x: 27.381728, y: 120.587895, z: 20 } },
-      { text: '闅愭偅2', position: { x: 27.183096, y: 120.48657,  z: 20 } },
-      { text: '闅愭偅3', position: { x: 27.313019, y: 120.538779, z: 20 } },
-      { text: '闅愭偅4', position: { x: 27.219926, y: 120.455543, z: 20 } },
-      { text: '闅愭偅5', position: { x: 27.266007, y: 120.52789,  z: 20 } },
+    { key: 'uavNests',            text: '无人机巢站', visible: true,  children: [] },
+    { key: 'rescue',              text: '隐患',       visible: false, children: [
+      { text: '隐患1', position: { x: 27.381728, y: 120.587895, z: 20 } },
+      { text: '隐患2', position: { x: 27.183096, y: 120.48657,  z: 20 } },
+      { text: '隐患3', position: { x: 27.313019, y: 120.538779, z: 20 } },
+      { text: '隐患4', position: { x: 27.219926, y: 120.455543, z: 20 } },
+      { text: '隐患5', position: { x: 27.266007, y: 120.52789,  z: 20 } },
     ]},
-    { key: 'materials',           text: '鐗╄祫浠撳簱',   visible: false, children: [
-      { text: '浠撳簱1', position: { x: 27.220674, y: 120.460029, z: 1.179 } },
-      { text: '浠撳簱2', position: { x: 27.227569, y: 120.458844, z: 4.265 } },
-      { text: '浠撳簱3', position: { x: 27.23543,  y: 120.452171, z: 3.29  } },
+    { key: 'materials',           text: '物资仓库',   visible: false, children: [
+      { text: '仓库1', position: { x: 27.220674, y: 120.460029, z: 1.179 } },
+      { text: '仓库2', position: { x: 27.227569, y: 120.458844, z: 4.265 } },
+      { text: '仓库3', position: { x: 27.23543,  y: 120.452171, z: 3.29  } },
     ]},
   ],
 };
@@ -300,7 +307,7 @@ export function getConfig() { return _config; }
 
 // ==================== GaeaApp ====================
 
-console.log('[GaeaMethods] 妯″潡宸插姞杞?- setCategoryVisible 鍙敤');
+console.log('[GaeaMethods] 模块已加载 - setCategoryVisible 可用');
 
 export class GaeaApp {
   constructor(options = {}) {
@@ -309,131 +316,134 @@ export class GaeaApp {
     this.tLayers = [];
     this.layerCategories = this.config.layerCategories || [];
     this._screenIconList = [];
-    this._markersVisible = true; // 鍏ㄥ眬鍥炬爣鍙鎬э紙2D 妯″紡涓嬪己鍒堕殣钘忥紝3D 涓嬫仮澶嶏級
+    this._markersVisible = true; // 全局图标可见性（2D 模式下强制隐藏，3D 下恢复）
     this._hiddenCategories = new Set();
-    this._tilesetMap = {}; // 宸插姞杞界殑 3D Tiles 寮曠敤锛宬ey 涓?tileset 鍚嶇О
+    this._tilesetMap = {}; // 已加载的 3D Tiles 引用，key 为 tileset 名称
     this._secIsClickArr = [];
     this._secScreenIconKeyValue = {};
     this._groundPolygonElements = [];
     this.tweenGroup = new TWEEN.Group();
     this._tourConfig = {
-      '娌挎郸姘撮椄': { direction: [-0.5, 0.3, 0.3], positionList: [
-        { name: '浣嶇疆鐐?', pos: { x: 27.222747, y: 120.453035, z: 21.4 }, lockOut: [-0.5, 0.3, 0], lockOutAngle: 1.5 },
-        { name: '浣嶇疆鐐?', pos: { x: 27.222827, y: 120.453089, z: 21.4 }, lockIn: [-0.5, 0.3, 0], lockInAngle: -1.5, lockOut: [-0.5, 0.3, 0], lockOutAngle: 1.5 },
-        { name: '浣嶇疆鐐?', pos: { x: 27.222909, y: 120.453142, z: 21.4 }, lockIn: [-0.5, 0.3, 0], lockInAngle: -1.5, lockOut: [-0.5, 0.3, 0], lockOutAngle: 1.5 },
-        { name: '浣嶇疆鐐?', pos: { x: 27.222982, y: 120.453192, z: 21.4 }, lockIn: [-0.5, 0.3, 0], lockInAngle: -1.5 },
+      '沿浦水闸': { direction: [-0.5, 0.3, 0.3], positionList: [
+        { name: '位置点0', pos: { x: 27.222747, y: 120.453035, z: 21.4 }, lockOut: [-0.5, 0.3, 0], lockOutAngle: 1.5 },
+        { name: '位置点1', pos: { x: 27.222827, y: 120.453089, z: 21.4 }, lockIn: [-0.5, 0.3, 0], lockInAngle: -1.5, lockOut: [-0.5, 0.3, 0], lockOutAngle: 1.5 },
+        { name: '位置点2', pos: { x: 27.222909, y: 120.453142, z: 21.4 }, lockIn: [-0.5, 0.3, 0], lockInAngle: -1.5, lockOut: [-0.5, 0.3, 0], lockOutAngle: 1.5 },
+        { name: '位置点3', pos: { x: 27.222982, y: 120.453192, z: 21.4 }, lockIn: [-0.5, 0.3, 0], lockInAngle: -1.5 },
       ]},
-      '鑱旂洘姘撮椄': { direction: [1.5, 0, 0], positionList: [
-        { name: '浣嶇疆鐐?', pos: { x: 27.200467, y: 120.465716, z: 26 }, lockIn: [0, -0.5, 0], lockInAngle: -1.5, lockOut: [0.5, 0, 0], lockOutAngle: -1.5 },
-        { name: '浣嶇疆鐐?', pos: { x: 27.200486, y: 120.465716, z: 26 }, lockIn: [0.5, 0, 0], lockInAngle: 1.5, lockOut: [0.5, 0, 0], lockOutAngle: -1.5 },
-        { name: '浣嶇疆鐐?', pos: { x: 27.200513, y: 120.465716, z: 26 }, lockIn: [0.5, 0, 0], lockInAngle: 1.5, lockOut: [0, 0.5, 0], lockOutAngle: -1.5 },
-        { name: '浣嶇疆鐐?', pos: { x: 27.200513, y: 120.46561, z: 26 }, lockIn: [0, 0.5, 0], lockInAngle: 1.5, lockOut: [0, 0.5, 0], lockOutAngle: -1.5 },
-        { name: '浣嶇疆鐐?', pos: { x: 27.200513, y: 120.465524, z: 26 }, lockIn: [0, 0.5, 0], lockInAngle: 1.5, lockOut: [-0.5, 0, 0], lockOutAngle: -1.5 },
-        { name: '浣嶇疆鐐?', pos: { x: 27.200463, y: 120.465521, z: 26 }, lockIn: [-0.5, 0, 0], lockInAngle: 1.5, lockOut: [0, -0.5, 0], lockOutAngle: -1.5 },
-        { name: '浣嶇疆鐐?', pos: { x: 27.200467, y: 120.465616, z: 26 }, lockIn: [0, -0.5, 0], lockInAngle: 1.5, lockOut: [0, -0.5, 0], lockOutAngle: -1.5 },
-        { name: '浣嶇疆鐐?', pos: { x: 27.200467, y: 120.465716, z: 26 }, lockIn: [0, -0.5, 0], lockInAngle: 1.5, lockOut: [0.5, 0, 0], lockOutAngle: -1.5 },
+      '联盟水闸': { direction: [1.5, 0, 0], positionList: [
+        { name: '位置点1', pos: { x: 27.200467, y: 120.465716, z: 26 }, lockIn: [0, -0.5, 0], lockInAngle: -1.5, lockOut: [0.5, 0, 0], lockOutAngle: -1.5 },
+        { name: '位置点2', pos: { x: 27.200486, y: 120.465716, z: 26 }, lockIn: [0.5, 0, 0], lockInAngle: 1.5, lockOut: [0.5, 0, 0], lockOutAngle: -1.5 },
+        { name: '位置点3', pos: { x: 27.200513, y: 120.465716, z: 26 }, lockIn: [0.5, 0, 0], lockInAngle: 1.5, lockOut: [0, 0.5, 0], lockOutAngle: -1.5 },
+        { name: '位置点4', pos: { x: 27.200513, y: 120.46561, z: 26 }, lockIn: [0, 0.5, 0], lockInAngle: 1.5, lockOut: [0, 0.5, 0], lockOutAngle: -1.5 },
+        { name: '位置点5', pos: { x: 27.200513, y: 120.465524, z: 26 }, lockIn: [0, 0.5, 0], lockInAngle: 1.5, lockOut: [-0.5, 0, 0], lockOutAngle: -1.5 },
+        { name: '位置点6', pos: { x: 27.200463, y: 120.465521, z: 26 }, lockIn: [-0.5, 0, 0], lockInAngle: 1.5, lockOut: [0, -0.5, 0], lockOutAngle: -1.5 },
+        { name: '位置点7', pos: { x: 27.200467, y: 120.465616, z: 26 }, lockIn: [0, -0.5, 0], lockInAngle: 1.5, lockOut: [0, -0.5, 0], lockOutAngle: -1.5 },
+        { name: '位置点8', pos: { x: 27.200467, y: 120.465716, z: 26 }, lockIn: [0, -0.5, 0], lockInAngle: 1.5, lockOut: [0.5, 0, 0], lockOutAngle: -1.5 },
       ]},
-      '涓嬪湪姘撮椄': { direction: [0.5, 0, 0], positionList: [
-        { name: '浣嶇疆鐐?', pos: { x: 27.221763, y: 120.4452, z: 27.6 }, lockOut: [0, -0.5, 0], lockOutAngle: 1.5 },
-        { name: '浣嶇疆鐐?', pos: { x: 27.221763, y: 120.445142, z: 27.6 }, lockIn: [0, -0.5, 0], lockInAngle: -1.5, lockOut: [0, -0.5, 0], lockOutAngle: 1.5 },
-        { name: '浣嶇疆鐐?', pos: { x: 27.221763, y: 120.445084, z: 27.6 }, lockIn: [0, -0.5, 0], lockInAngle: -1.5 },
+      '下在水闸': { direction: [0.5, 0, 0], positionList: [
+        { name: '位置点1', pos: { x: 27.221763, y: 120.4452, z: 27.6 }, lockOut: [0, -0.5, 0], lockOutAngle: 1.5 },
+        { name: '位置点2', pos: { x: 27.221763, y: 120.445142, z: 27.6 }, lockIn: [0, -0.5, 0], lockInAngle: -1.5, lockOut: [0, -0.5, 0], lockOutAngle: 1.5 },
+        { name: '位置点3', pos: { x: 27.221763, y: 120.445084, z: 27.6 }, lockIn: [0, -0.5, 0], lockInAngle: -1.5 },
       ]},
-      '宀熬鏂伴椄': { direction: [-0.5, 0.5, 0.5], positionList: [] },
-      '宀熬姘撮椄': { direction: [-0.4, 0.5, 0.3], positionList: [] },
+      '岭尾新闸': { direction: [-0.5, 0.5, 0.5], positionList: [] },
+      '岭尾水闸': { direction: [-0.4, 0.5, 0.3], positionList: [] },
     };
     console.log('[GaeaApp] constructor layerCategories:', this.layerCategories.length);
     window.Gaea = Gaea;
 
-    // 鏄剧ず loading
+    // 显示 loading
     showLoading();
 
-    // 鑷姩鍚姩鍒濆鍖栵紝catch 闃叉鏈鐞嗙殑 Promise rejection
+    // 自动启动初始化，catch 防止未处理的 Promise rejection
     this.ready = this._autoInit().catch(err => {
-      console.error('[GaeaApp] 鍒濆鍖栧け璐?', err);
+      console.error('[GaeaApp] 初始化失败:', err);
     });
   }
 
   get config() { return { ..._config, ...this._options }; }
 
-  // ---- 鍐呴儴鍒濆鍖?----
+  // ---- 内部初始化 ----
 
   async _autoInit() {
-    console.log('[GaeaApp] 寮€濮嬪垵濮嬪寲...');
+    console.log('[GaeaApp] 开始初始化...');
 
-    // 1. 绛?canvas 灏辩华
+    // 1. 等 canvas 就绪
     await this._waitForCanvas();
-    console.log('[GaeaApp] canvas 灏辩华');
+    console.log('[GaeaApp] canvas 就绪');
 
-    // 2. 鍚姩 Godot 寮曟搸
+    // 2. 启动 Godot 引擎
     await this._startEngine();
-    console.log('[GaeaApp] 寮曟搸鍚姩瀹屾垚');
+    console.log('[GaeaApp] 引擎启动完成');
 
-    // 3. 鍒濆鍖栫幆澧?    await this._initEnvironment();
-    console.log('[GaeaApp] 鐜鍒濆鍖栧畬鎴?);
+    // 3. 初始化环境
+    await this._initEnvironment();
+    console.log('[GaeaApp] 环境初始化完成');
 
-    // 4. 鍔犺浇榛樿鍥惧眰
+    // 4. 加载默认图层
     await this._initLayers();
-    console.log('[GaeaApp] 鍥惧眰鍔犺浇瀹屾垚');
+    console.log('[GaeaApp] 图层加载完成');
 
-    // 褰卞儚/鍦板舰灏辩华鍗冲彲鏄剧ず鍦板浘锛岄殣钘?loading锛岄伩鍏嶇敤鎴风瓑寰呮ā鍨?鎺ュ彛
+    // 影像/地形就绪即可显示地图，隐藏 loading，避免用户等待模型/接口
     hideLoading();
     this._addResetButton();
     this._addLayerTreeButton();
-    console.log('[GaeaApp] 鍦板浘宸插氨缁紝妯″瀷涓庡浘灞傛爲鏁版嵁鍚庡彴鍔犺浇涓?..');
+    console.log('[GaeaApp] 地图已就绪，模型与图层树数据后台加载中...');
 
-    // 鍓╀綑閲嶈祫婧愶紙妯″瀷浣嶇疆銆丟LTF銆佸浘灞傛爲鎺ュ彛銆佸睆骞曞浘鏍囷級鍚庡彴寮傛鍔犺浇锛屼笉闃诲鍦板浘鏄剧ず
+    // 剩余重资源（模型位置、GLTF、图层树接口、屏幕图标）后台异步加载，不阻塞地图显示
     this._loadRestAsync();
   }
 
-  /** 鍚庡彴寮傛鍔犺浇锛氭ā鍨嬩綅缃皟鏁?鈫?GLTF 鈫?鍥惧眰鏍戞暟鎹?鈫?灞忓箷鍥炬爣 */
+  /** 后台异步加载：模型位置调整 → GLTF → 图层树数据 → 屏幕图标 */
   async _loadRestAsync() {
     try {
-      // 5. 璋冩暣妯″瀷浣嶇疆
-      console.log('[GaeaApp] 寮€濮嬭皟鏁存ā鍨嬩綅缃?..');
+      // 5. 调整模型位置
+      console.log('[GaeaApp] 开始调整模型位置...');
       const models = [
-        { nodeName: '娌挎郸姘撮椄', position: '-2876603.788, 4892658.352, 2900208.622', rotation: '-37.24, 162.42, -17.17' },
-        { nodeName: '涓嬪湪姘撮椄', position: '-2875959.024, 4893109.058, 2900101.919', rotation: '-23.42, -165.20, -34.52' },
-        { nodeName: '鑱旂洘姘撮椄', position: '-2878251.995, 4893011.199, 2897998.160', rotation: '-23.43, -165.98, -33.40' },
-        { nodeName: '宀熬鏂伴椄', position: '-2877382.212, 4892920.226, 2898965.484', rotation: '7.79, 36.98, 40.83' },
-        { nodeName: '宀熬姘撮椄', position: '-2877582.576, 4892520.352, 2899499.184', rotation: '-41.04, 126.37, 6.29' },
+        { nodeName: '沿浦水闸', position: '-2876603.788, 4892658.352, 2900208.622', rotation: '-37.24, 162.42, -17.17' },
+        { nodeName: '下在水闸', position: '-2875959.024, 4893109.058, 2900101.919', rotation: '-23.42, -165.20, -34.52' },
+        { nodeName: '联盟水闸', position: '-2878251.995, 4893011.199, 2897998.160', rotation: '-23.43, -165.98, -33.40' },
+        { nodeName: '岭尾新闸', position: '-2877382.212, 4892920.226, 2898965.484', rotation: '7.79, 36.98, 40.83' },
+        { nodeName: '岭尾水闸', position: '-2877582.576, 4892520.352, 2899499.184', rotation: '-41.04, 126.37, 6.29' },
       ];
       for (const model of models) {
         try {
           const node = Gaea.World.Instance.GetNode(model.nodeName);
-          if (!node) { console.warn(`[GaeaApp] 鏈壘鍒拌妭鐐? ${model.nodeName}`); continue; }
+          if (!node) { console.warn(`[GaeaApp] 未找到节点: ${model.nodeName}`); continue; }
           const inst = Gaea.MeshInstance.ConvertBy(node);
           const pos = model.position.split(',').map(v => parseFloat(v.trim()));
           const rot = model.rotation.split(',').map(v => parseFloat(v.trim()));
           if (inst.Translation) inst.Translation = new Gaea.Vector3(pos[0], pos[1], pos[2]);
           if (inst.RotationDegrees) inst.RotationDegrees = new Gaea.Vector3(rot[0], rot[1], rot[2]);
         } catch (e) {
-          console.warn(`[GaeaApp] 璋冩暣妯″瀷 ${model.nodeName} 澶辫触:`, e.message);
+          console.warn(`[GaeaApp] 调整模型 ${model.nodeName} 失败:`, e.message);
         }
       }
-      console.log('[GaeaApp] 鎵€鏈夋ā鍨嬩綅缃皟鏁村畬鎴?);
+      console.log('[GaeaApp] 所有模型位置调整完成');
 
-      // 6. 鍔犺浇 GLTF 妯″瀷
+      // 6. 加载 GLTF 模型
       await this._loadGltfModels();
 
-      // 7. 鑾峰彇鍥惧眰鏍戞暟鎹紙鏈夋帴鍙ｈ蛋鎺ュ彛锛屾病鎺ュ彛鐢ㄩ粯璁わ級
+      // 7. 获取图层树数据（有接口走接口，没接口用默认）
       await this._fetchLayerTreeData();
 
-      // 鍚屾 layerCategories锛堜慨澶嶆暟鎹洿鏂版湭鍚屾鐨勯棶棰橈級
+      // 同步 layerCategories（修复数据更新未同步的问题）
       this.layerCategories = this.config.layerCategories || [];
-      console.log('[GaeaApp] layerCategories 鏇存柊鍚?', this.layerCategories.length);
+      console.log('[GaeaApp] layerCategories 更新后:', this.layerCategories.length);
 
-      // 8. 鍒濆鍖栧睆骞曞浘鏍?      this._initScreenIcons();
+      // 8. 初始化屏幕图标
+      this._initScreenIcons();
 
-      // 搴旂敤榛樿闅愯棌鐨勫垎绫?      const hiddenCats = this.config.defaultHiddenCategories || []
+      // 应用默认隐藏的分类
+      const hiddenCats = this.config.defaultHiddenCategories || []
       hiddenCats.forEach(key => {
         const cat = this.layerCategories.find(c => c.key === key)
         if (cat) cat.visible = false
         this.setCategoryVisible(key, false)
       })
 
-      console.log('[GaeaApp] 鍚庡彴璧勬簮鍔犺浇瀹屾垚');
+      console.log('[GaeaApp] 后台资源加载完成');
     } catch (e) {
-      console.error('[GaeaApp] 鍚庡彴璧勬簮鍔犺浇鍑洪敊:', e);
+      console.error('[GaeaApp] 后台资源加载出错:', e);
     }
   }
 
@@ -445,7 +455,7 @@ export class GaeaApp {
         if (el && el.width > 0) {
           resolve();
         } else if (Date.now() - start > 10000) {
-          reject(new Error('绛夊緟 canvas 瓒呮椂'));
+          reject(new Error('等待 canvas 超时'));
         } else {
           requestAnimationFrame(check);
         }
@@ -456,10 +466,10 @@ export class GaeaApp {
 
   async _startEngine() {
     if (!window.Engine) {
-      throw new Error('window.Engine 涓嶅瓨鍦紝璇风‘淇?<script src="/Gaea.js"> 宸插姞杞?);
+      throw new Error('window.Engine 不存在，请确保 <script src="/Gaea.js"> 已加载');
     }
     if (!window.Engine.isWebGLAvailable()) {
-      throw new Error('WebGL 涓嶅彲鐢?);
+      throw new Error('WebGL 不可用');
     }
 
     const cfg = this.config;
@@ -476,7 +486,7 @@ export class GaeaApp {
     });
 
     await engine.startGame({
-      onProgress: cfg.onProgress || ((cur, total) => console.log(`寮曟搸鍔犺浇: ${cur}/${total}`)),
+      onProgress: cfg.onProgress || ((cur, total) => console.log(`引擎加载: ${cur}/${total}`)),
     });
   }
 
@@ -505,10 +515,10 @@ export class GaeaApp {
     const cfg = this.config;
 
     if (cfg.serviceMode === 'online') {
-      // 鍦ㄧ嚎妯″紡锛氫粎鍔犺浇澶╁湴鍥惧奖鍍忥紝涓嶅姞杞藉湴褰?璐村湴绾?3D Tiles
+      // 在线模式：仅加载天地图影像，不加载地形/贴地线/3D Tiles
       this.addTianditu();
     } else {
-      // 鏈嶅姟骞冲彴妯″紡锛歐MTS 褰卞儚 + 璐村湴绾?+ 鍦板舰
+      // 服务平台模式：WMTS 影像 + 贴地线 + 地形
       await this.getAllServe();
       const list = cfg.defaultLayers;
       if (list?.length) {
@@ -516,74 +526,79 @@ export class GaeaApp {
           this.addLayer(layer);
         }
       }
-      // 璐村湴绾匡紙鐭㈤噺绾挎湇鍔★紝渚濊禆 this.layers锛?      try { this.addGroundLines(); } catch (e) { console.error('鍔犺浇璐村湴绾垮け璐?', e); }
-      // 鍦板舰鏈嶅姟
-      try { await this.addInitTerrainServer(); } catch (e) { console.error('鍔犺浇鍦板舰澶辫触:', e); }
-      // 鍊炬枩鎽勫奖 3D Tiles锛坕sInitLoad 涓?true 鐨勮嚜鍔ㄥ姞杞斤紝渚濊禆鍦板舰鏈嶅姟锛?      const tiles = cfg.default3DTiles || []
+      // 贴地线（矢量线服务，依赖 this.layers）
+      try { this.addGroundLines(); } catch (e) { console.error('加载贴地线失败:', e); }
+      // 地形服务
+      try { await this.addInitTerrainServer(); } catch (e) { console.error('加载地形失败:', e); }
+      // 倾斜摄影 3D Tiles（isInitLoad 为 true 的自动加载，依赖地形服务）
+      const tiles = cfg.default3DTiles || []
       tiles.filter(item => item.isInitLoad).forEach(item => this.add3DTiles(item))
     }
 
     const pos = cfg.defaultCameraPosition;
     if (pos) {
-      // 绛変竴甯у啀璁剧浉鏈猴紝纭繚寮曟搸鎶婂浘灞傚鐞嗗畬
+      // 等一帧再设相机，确保引擎把图层处理完
       await new Promise(r => requestAnimationFrame(r));
       this.SetPosition(pos);
     }
   }
 
-  // ---- 澶╁湴鍥?----
+  // ---- 天地图 ----
 
-  /** 鍔犺浇澶╁湴鍥惧奖鍍?+ 娉ㄨ */
+  /** 加载天地图影像 + 注记 */
   addTianditu() {
     const cfg = this.config;
 
-    // 褰卞儚搴曞浘锛堝崼鏄熷浘锛?    const imgStore = new Gaea.TDTWMTSImageStore();
+    // 影像底图（卫星图）
+    const imgStore = new Gaea.TDTWMTSImageStore();
     imgStore.ServerUri = cfg.tiandituServerUri || 'https://t{0}.tianditu.gov.cn/img_c/wmts';
     imgStore.FormatString = cfg.tiandituFormatString || 'SERVICE=WMTS&REQUEST=GetTile&VERSION=1.0.0&LAYER=img&STYLE=default&TILEMATRIXSET=c&FORMAT=tiles&TILECOL={0}&TILEROW={1}&TILEMATRIX={2}&tk={3}';
     imgStore.ImageExtension = cfg.tiandituImageExtension ?? Gaea.ImageExtensionEnum.JPEG;
     imgStore.TK = cfg.tiandituToken;
-    imgStore.Name = '褰卞儚搴曞浘';
+    imgStore.Name = '影像底图';
     imgStore.LevelRange = new Gaea.Vector2(cfg.tiandituLevelRange[0], cfg.tiandituLevelRange[1]);
     Gaea.World.Instance.DefaultPyramidTileSet.AddImageStore(imgStore);
-    console.log('澶╁湴鍥惧奖鍍忓姞杞芥垚鍔?);
+    console.log('天地图影像加载成功');
 
-    // 娉ㄨ鍥惧眰锛堥亾璺?鍦板悕鏍囨敞锛?    const labelStore = new Gaea.TDTWMTSImageStore();
+    // 注记图层（道路/地名标注）
+    const labelStore = new Gaea.TDTWMTSImageStore();
     labelStore.ServerUri = 'https://t{0}.tianditu.gov.cn/cia_c/wmts';
     labelStore.FormatString = 'SERVICE=WMTS&REQUEST=GetTile&VERSION=1.0.0&LAYER=cia&STYLE=default&TILEMATRIXSET=c&FORMAT=image/png&TILECOL={0}&TILEROW={1}&TILEMATRIX={2}&tk={3}';
     labelStore.ImageExtension = Gaea.ImageExtensionEnum.PNG;
     labelStore.TK = cfg.tiandituToken;
-    labelStore.Name = '澶╁湴鍥炬敞璁?;
+    labelStore.Name = '天地图注记';
     labelStore.LevelRange = new Gaea.Vector2(cfg.tiandituLevelRange[0], cfg.tiandituLevelRange[1]);
     Gaea.World.Instance.DefaultPyramidTileSet.AddImageStore(labelStore);
-    console.log('澶╁湴鍥炬敞璁板姞杞芥垚鍔?);
+    console.log('天地图注记加载成功');
 
     return { imgStore, labelStore };
   }
 
-  /** 娣诲姞鍙充笂瑙掗噸缃寜閽?*/
+  /** 添加右上角重置按钮 */
   _addResetButton() {
     if (document.getElementById('gaea-reset-btn')) return;
     const btn = document.createElement('button');
     btn.id = 'gaea-reset-btn';
-    btn.title = '閲嶇疆瑙嗚';
-    btn.innerHTML = '鉄?;
+    btn.title = '重置视角';
+    btn.innerHTML = '⟳';
     btn.onclick = () => {
       const pos = this.config.defaultCameraPosition;
       if (pos) this.SetPosition(pos);
-      // 瑙ｉ攣瑙嗚锛堝唴閮ㄤ細璋?UseAutoVisible 鎭㈠闈炴柇闈㈠浘鏍囷級
+      // 解锁视角（内部会调 UseAutoVisible 恢复非断面图标）
       this.lockedModesSwitch(false);
-      // 鎭㈠琚?hiddenScreenWithClass 闅愯棌鐨勫浘鏍?DOM
+      // 恢复被 hiddenScreenWithClass 隐藏的图标 DOM
       if (this._markersVisible) {
         document.querySelectorAll('.gaea-locationLineStyle, .gaea-iconscreen, .gaea-iconGif').forEach(el => {
           el.style.display = '';
         });
       }
-      // 鏂潰妯″瀷缂╁洖
+      // 断面模型缩回
       if (this._raisedSection) {
         this._raisedSection.TranslateObjectLocal(new Gaea.Vector3(0, -44, 0));
         this._raisedSection = null;
       }
-      // 閲嶇疆娓歌妯″瀷浣嶇疆鍒板垵濮嬩綅缃?      if (this._currentTourModel) {
+      // 重置游览模型位置到初始位置
+      if (this._currentTourModel) {
         const name = this._currentTourModel?.Root?.Name;
         const cfg = this._gltfCfgMap?.[name];
         if (cfg) {
@@ -592,9 +607,10 @@ export class GaeaApp {
         this._currentTourModel = null;
         this._currentTourIndexPos = 0;
       }
-      // 閲嶇疆鏂潰鐘舵€?      this._secIsClickArr = [];
+      // 重置断面状态
+      this._secIsClickArr = [];
       this._secScreenIconKeyValue = {};
-      // 闅愯棌鏂潰鏍囩
+      // 隐藏断面标签
       this._screenIconList.forEach(item => {
         if (item.type === 'dabaSec') {
           item.element.ForceSetVisible(false);
@@ -602,48 +618,48 @@ export class GaeaApp {
         }
       });
       document.querySelectorAll('.waterLevel, .damScreen').forEach(el => el.style.display = 'none');
-      // 閫氱煡 SecTourView 闅愯棌
+      // 通知 SecTourView 隐藏
       document.dispatchEvent(new CustomEvent('gaea-reset-view', { bubbles: true }));
     };
     document.body.appendChild(btn);
   }
 
-  /** 娣诲姞鍥惧眰鏍戞寜閽?*/
+  /** 添加图层树按钮 */
   _addLayerTreeButton() {
     if (document.getElementById('gaea-layertree-btn')) return
     const btn = document.createElement('button')
     btn.id = 'gaea-layertree-btn'
-    btn.title = '鍥惧眰鎺у埗'
-    btn.innerHTML = '鈽?
+    btn.title = '图层控制'
+    btn.innerHTML = '☰'
     btn.onclick = () => {
       document.dispatchEvent(new CustomEvent('gaea-toggle-layertree'))
     }
     document.body.appendChild(btn)
   }
 
-  // ---- GLTF 妯″瀷 ----
+  // ---- GLTF 模型 ----
 
   async _loadGltfModels() {
     const gltfList = [
-      { name: 'YPDP0+600',            position: { x: 27.217692, y: 120.461823, z: -44 }, rotate: [0, 198, 0], size: [1, 1, 1], show: true,  url: 'gltf/澶у潩鏂潰600.gltf' },
-      { name: 'YPDP0+750',            position: { x: 27.220289, y: 120.459753, z: -44 }, rotate: [0, 226, 0], size: [1, 1, 1], show: true,  url: 'gltf/澶у潩鏂潰750.gltf' },
-      { name: 'YPDP0+100',            position: { x: 27.223027, y: 120.454653, z: -44 }, rotate: [0, 222, 0], size: [1, 1, 1], show: true,  url: 'gltf/澶у潩鏂潰100.gltf' },
-      { name: 'YPDP0+200',            position: { x: 27.222541, y: 120.455453, z: -44 }, rotate: [0, 246, 0], size: [1, 1, 1], show: true,  url: 'gltf/澶у潩鏂潰200.gltf' },
-      { name: '娌挎郸娉电珯',             position: { x: 27.222001, y: 120.452509, z: 17 },    rotate: [0, -38, 0], size: [1, 1, 1], show: true,  url: 'gltf/娌挎郸娉电珯.gltf',      enablePick: true },
-      { name: '涓嬪湪娴峰绾虫帓闂?,       position: { x: 27.219978, y: 120.445672, z: 15 },    rotate: [0, 0, 0],  size: [1, 1, 1], show: true,  url: 'gltf/涓嬪湪娴峰绾虫帓闂?gltf',  enablePick: true },
-      { name: '鐩掑瓙妯″瀷',             position: { x: 27.241836, y: 120.462750, z: 50 },    rotate: [0, 90, 0],  size: [10, 10, 10], show: true, url: 'gltf/box.gltf' },
-      { name: 'YPDP0+600娓歌妯″瀷',    position: { x: 27.217433, y: 120.461448, z: 32 },    rotate: [0, 90, 0],  size: [1, 1, 1], show: true,  url: 'gltf/box.gltf' },
-      { name: 'YPDP0+750娓歌妯″瀷',    position: { x: 27.220072, y: 120.459602, z: 30 },    rotate: [0, 90, 0],  size: [1, 1, 1], show: true,  url: 'gltf/box.gltf' },
-      { name: 'YPDP0+100娓歌妯″瀷',    position: { x: 27.222844, y: 120.454466, z: 30 },    rotate: [0, 90, 0],  size: [1, 1, 1], show: true,  url: 'gltf/box.gltf' },
-      { name: 'YPDP0+200娓歌妯″瀷',    position: { x: 27.22226,  y: 120.455318, z: 30 },    rotate: [0, 90, 0],  size: [1, 1, 1], show: true,  url: 'gltf/box.gltf' },
-      { name: '娌挎郸姘撮椄娓歌妯″瀷',     position: { x: 27.222747, y: 120.453035, z: 21.8 },  rotate: [0, -30, 0], size: [1, 1, 1], show: false, url: 'gltf/box.gltf' },
-      { name: '娌挎郸姘撮椄瀹氫綅妯″瀷',     position: { x: 27.230788, y: 120.453009, z: 487.5 }, rotate: [0, 0, 0],   size: [1, 1, 1], show: false, url: 'gltf/box.gltf' },
-      { name: '涓嬪湪姘撮椄娓歌妯″瀷',     position: { x: 27.221763, y: 120.4452, z: 27.6 },    rotate: [0, 0, 0],  size: [1, 1, 1], show: false, url: 'gltf/box.gltf' },
-      { name: '鑱旂洘姘撮椄娓歌妯″瀷',     position: { x: 27.200467, y: 120.465716, z: 26 },    rotate: [0, 180, 0], size: [0.1, 0.1, 0.1], show: false, url: 'gltf/box.gltf' },
-      { name: '宀熬姘撮椄娓歌妯″瀷',     position: { x: 27.215661, y: 120.462325, z: 34 },    rotate: [0, -66, 0], size: [1, 1, 1], show: false, url: 'gltf/box.gltf' },
-      { name: '宀熬鏂伴椄娓歌妯″瀷',     position: { x: 27.21038,  y: 120.458513, z: 4 },     rotate: [0, 30, 0], size: [1, 1, 1], show: false, url: 'gltf/box.gltf' },
-      { name: '鐩掑瓙妯″瀷-yanpu',       position: { x: 27.231665, y: 120.456095, z: 48.608 }, rotate: [0, 90, 0], size: [10, 10, 10], show: true, url: 'gltf/box.gltf' },
-      { name: '闃叉睕娌欒',             position: { x: 27.218723, y: 120.460473, z: 18 }, rotate: [0, 0, 0], size: [1, 1, 1], show: false, url: 'gltf/sanddai.glb' },
+      { name: 'YPDP0+600',            position: { x: 27.217692, y: 120.461823, z: -44 }, rotate: [0, 198, 0], size: [1, 1, 1], show: true,  url: 'gltf/大坝断面600.gltf' },
+      { name: 'YPDP0+750',            position: { x: 27.220289, y: 120.459753, z: -44 }, rotate: [0, 226, 0], size: [1, 1, 1], show: true,  url: 'gltf/大坝断面750.gltf' },
+      { name: 'YPDP0+100',            position: { x: 27.223027, y: 120.454653, z: -44 }, rotate: [0, 222, 0], size: [1, 1, 1], show: true,  url: 'gltf/大坝断面100.gltf' },
+      { name: 'YPDP0+200',            position: { x: 27.222541, y: 120.455453, z: -44 }, rotate: [0, 246, 0], size: [1, 1, 1], show: true,  url: 'gltf/大坝断面200.gltf' },
+      { name: '沿浦泵站',             position: { x: 27.222001, y: 120.452509, z: 17 },    rotate: [0, -38, 0], size: [1, 1, 1], show: true,  url: 'gltf/沿浦泵站.gltf',      enablePick: true },
+      { name: '下在海塘纳排闸',       position: { x: 27.219978, y: 120.445672, z: 15 },    rotate: [0, 0, 0],  size: [1, 1, 1], show: true,  url: 'gltf/下在海塘纳排闸.gltf',  enablePick: true },
+      { name: '盒子模型',             position: { x: 27.241836, y: 120.462750, z: 50 },    rotate: [0, 90, 0],  size: [10, 10, 10], show: true, url: 'gltf/box.gltf' },
+      { name: 'YPDP0+600游览模型',    position: { x: 27.217433, y: 120.461448, z: 32 },    rotate: [0, 90, 0],  size: [1, 1, 1], show: true,  url: 'gltf/box.gltf' },
+      { name: 'YPDP0+750游览模型',    position: { x: 27.220072, y: 120.459602, z: 30 },    rotate: [0, 90, 0],  size: [1, 1, 1], show: true,  url: 'gltf/box.gltf' },
+      { name: 'YPDP0+100游览模型',    position: { x: 27.222844, y: 120.454466, z: 30 },    rotate: [0, 90, 0],  size: [1, 1, 1], show: true,  url: 'gltf/box.gltf' },
+      { name: 'YPDP0+200游览模型',    position: { x: 27.22226,  y: 120.455318, z: 30 },    rotate: [0, 90, 0],  size: [1, 1, 1], show: true,  url: 'gltf/box.gltf' },
+      { name: '沿浦水闸游览模型',     position: { x: 27.222747, y: 120.453035, z: 21.8 },  rotate: [0, -30, 0], size: [1, 1, 1], show: false, url: 'gltf/box.gltf' },
+      { name: '沿浦水闸定位模型',     position: { x: 27.230788, y: 120.453009, z: 487.5 }, rotate: [0, 0, 0],   size: [1, 1, 1], show: false, url: 'gltf/box.gltf' },
+      { name: '下在水闸游览模型',     position: { x: 27.221763, y: 120.4452, z: 27.6 },    rotate: [0, 0, 0],  size: [1, 1, 1], show: false, url: 'gltf/box.gltf' },
+      { name: '联盟水闸游览模型',     position: { x: 27.200467, y: 120.465716, z: 26 },    rotate: [0, 180, 0], size: [0.1, 0.1, 0.1], show: false, url: 'gltf/box.gltf' },
+      { name: '岭尾水闸游览模型',     position: { x: 27.215661, y: 120.462325, z: 34 },    rotate: [0, -66, 0], size: [1, 1, 1], show: false, url: 'gltf/box.gltf' },
+      { name: '岭尾新闸游览模型',     position: { x: 27.21038,  y: 120.458513, z: 4 },     rotate: [0, 30, 0], size: [1, 1, 1], show: false, url: 'gltf/box.gltf' },
+      { name: '盒子模型-yanpu',       position: { x: 27.231665, y: 120.456095, z: 48.608 }, rotate: [0, 90, 0], size: [10, 10, 10], show: true, url: 'gltf/box.gltf' },
+      { name: '防汛沙袋',             position: { x: 27.218723, y: 120.460473, z: 18 }, rotate: [0, 0, 0], size: [1, 1, 1], show: false, url: 'gltf/sanddai.glb' },
     ];
 
     this._gltfCfgMap = {};
@@ -652,15 +668,16 @@ export class GaeaApp {
       this._gltfCfgMap[item.name] = item;
     }
 
-    console.log('[GaeaApp] 寮€濮嬪姞杞?GLTF 妯″瀷...');
-    // 骞惰鍔犺浇鎵€鏈夋ā鍨嬶紙鍘熶覆琛岄€愪釜 await 浼氱疮鍔犺€楁椂锛?    await Promise.all(gltfList.map(async (item) => {
+    console.log('[GaeaApp] 开始加载 GLTF 模型...');
+    // 并行加载所有模型（原串行逐个 await 会累加耗时）
+    await Promise.all(gltfList.map(async (item) => {
       item.url = encodeURI(item.url);
       try {
         const el = await this.AddGltf(item);
         if (el) this._gltfElements[item.name] = el;
-      } catch (e) { console.warn(`[GaeaApp] 妯″瀷 ${item.name} 鍔犺浇澶辫触:`, e.message); }
+      } catch (e) { console.warn(`[GaeaApp] 模型 ${item.name} 加载失败:`, e.message); }
     }));
-    console.log('[GaeaApp] GLTF 妯″瀷鍔犺浇瀹屾垚');
+    console.log('[GaeaApp] GLTF 模型加载完成');
   }
 
   AddGltf = ({
@@ -672,10 +689,10 @@ export class GaeaApp {
       const element = new Gaea.GLTFElement();
       element.UseAbsoluteHeight = useAbsoluteHeight;
       element.ResourceName = url;
-      console.log(`妯″瀷寮€濮嬪姞杞? ${name}`);
+      console.log(`模型开始加载: ${name}`);
 
       element.OnModelInit(async () => {
-        // 澶у潩鏂潰妯″瀷璁剧疆 Unshaded
+        // 大坝断面模型设置 Unshaded
         if (name.includes('YPDP0')) {
           const n = element.Root.GetChildCount();
           for (let i = 0; i < n; i++) {
@@ -687,7 +704,7 @@ export class GaeaApp {
             }
           }
         }
-        console.log(`妯″瀷鍔犺浇瀹屾瘯: ${name}`);
+        console.log(`模型加载完毕: ${name}`);
         initFun();
         element.EnablePick = enablePick;
         Gaea.QueryServer.Instance.Enable = enablePick;
@@ -706,35 +723,36 @@ export class GaeaApp {
     });
   };
 
-  // ---- 鍥惧眰鏍戞暟鎹?----
+  // ---- 图层树数据 ----
 
   async _fetchLayerTreeData() {
     const cfg = this.config;
     const apiUrl = cfg.dataHubApiUrl;
     if (!apiUrl) {
-      console.log('[GaeaApp] 鏈厤缃?dataHubApiUrl锛屼娇鐢ㄩ粯璁ゅ浘灞傛爲鏁版嵁');
+      console.log('[GaeaApp] 未配置 dataHubApiUrl，使用默认图层树数据');
       return;
     }
-    console.log('[GaeaApp] 浠?DataHub 鑾峰彇鍥惧眰鏍戞暟鎹?..');
+    console.log('[GaeaApp] 从 DataHub 获取图层树数据...');
     try {
       const res = await fetch(`${apiUrl}/open/api/5rLGPS6E8Zvr`, { headers: this._dataHubHeaders(cfg) });
       if (!res.ok) throw new Error(`HTTP ${res.status}`);
       const json = await res.json();
       if (json.data) this._mergeStationData(json.data);
-      console.log('[GaeaApp] 鍥惧眰鏍戞暟鎹洿鏂板畬鎴?);
+      console.log('[GaeaApp] 图层树数据更新完成');
     } catch (e) {
-      console.warn('[GaeaApp] 鎺ュ彛鑾峰彇澶辫触锛屼娇鐢ㄩ粯璁ゆ暟鎹?', e.message);
+      console.warn('[GaeaApp] 接口获取失败，使用默认数据:', e.message);
     }
   }
 
-  /** DataHub API 绛惧悕澶达紙HmacSHA256锛?*/
+  /** DataHub API 签名头（HmacSHA256） */
   _dataHubHeaders(cfg) {
     const appKey = cfg.dataHubAppKey || 'testAppKey';
     const appSecret = cfg.dataHubAppSecret || 'testAppSecret';
     const nonce = Math.random().toString(36).substring(2, 10);
     const timestamp = Date.now();
     const signStr = `${appKey}${timestamp}${nonce}`;
-    // 绠€鍖栫増锛氱敤 btoa 鏇夸唬 HmacSHA256锛堢敓浜х幆澧冮渶鐢?Web Crypto API锛?    const signature = btoa(signStr + appSecret);
+    // 简化版：用 btoa 替代 HmacSHA256（生产环境需用 Web Crypto API）
+    const signature = btoa(signStr + appSecret);
     return {
       'Content-Type': 'application/json',
       'X-App-Key': appKey,
@@ -744,7 +762,7 @@ export class GaeaApp {
     };
   }
 
-  /** 灏咥PI娴嬬珯鏁版嵁鍚堝苟鍒伴粯璁ゅ垎绫讳腑 */
+  /** 将API测站数据合并到默认分类中 */
   _mergeStationData(apiData) {
     const cfg = this.config;
     const sttpMap = {
@@ -770,12 +788,12 @@ export class GaeaApp {
     }
   }
 
-  /** 浠庡浘灞傛爲鏁版嵁鍒涘缓灞忓箷鍥炬爣 */
+  /** 从图层树数据创建屏幕图标 */
   _initScreenIcons() {
     const cats = this.layerCategories || [];
     const catConfig = {
       seawall: {
-        img: '/image/screenIcon/娴峰-绾?png', method: 'textImage',
+        img: '/image/screenIcon/海塘-红.png', method: 'textImage',
         visibleRange: [5000, 150000], offset: [-40, -35], anchorType: 6,
         onClick: (name, data) => {
           this.flyToNode(data);
@@ -783,7 +801,7 @@ export class GaeaApp {
         },
       },
       hydrometricStations: {
-        img: '/image/screenIcon/娼綅绔?姝ｅ父.png', method: 'textImage',
+        img: '/image/screenIcon/潮位站-正常.png', method: 'textImage',
         visibleRange: [10, 5000], offset: [-40, -35],
         onClick: (name, data) => {
           console.log('[GaeaApp] hydrometricStations onClick:', name, data);
@@ -796,18 +814,18 @@ export class GaeaApp {
           if (window.__gaeaIconClickHandler) {
             window.__gaeaIconClickHandler({ detail: eventData });
           }
-          console.log('[GaeaApp] hydrometricStations 浜嬩欢宸叉淳鍙?);
+          console.log('[GaeaApp] hydrometricStations 事件已派发');
         },
       },
       tideStations: {
-        img: '/image/screenIcon/娼綅绔?姝ｅ父.png', method: 'textImage',
+        img: '/image/screenIcon/潮位站-正常.png', method: 'textImage',
         visibleRange: [10, 5000], offset: [-40, -35],
         onClick: (name, data) => {
           document.dispatchEvent(new CustomEvent('gaea-icon-click', { detail: { category: 'tideStations', name, data } }));
         },
       },
       riverStations: {
-        img: '/image/screenIcon/娌抽亾绔?姝ｅ父.png', method: 'textImage',
+        img: '/image/screenIcon/河道站-正常.png', method: 'textImage',
         visibleRange: [10, 5000], offset: [-40, -35],
         onClick: (name, data) => {
           this.flyToNode(data);
@@ -815,7 +833,7 @@ export class GaeaApp {
         },
       },
       rainStations: {
-        img: '/image/screenIcon/闆ㄩ噺绔?缁?png', method: 'textImage',
+        img: '/image/screenIcon/雨量站-绿.png', method: 'textImage',
         visibleRange: [10, 5000], offset: [-40, -35],
         onClick: (name, data) => {
           this.flyToNode(data);
@@ -823,7 +841,7 @@ export class GaeaApp {
         },
       },
       reservoirs: {
-        img: '/image/screenIcon/姘村簱绔?png', method: 'styled',
+        img: '/image/screenIcon/水库站.png', method: 'styled',
         visibleRange: [10, 5000], offset: [-40, -35],
         onClick: (name, data) => {
           this.flyToNode(data);
@@ -831,7 +849,7 @@ export class GaeaApp {
         },
       },
       sluice: {
-        img: '/image/screenIcon/闂搁棬-缁?png', method: 'textImage',
+        img: '/image/screenIcon/闸门-绿.png', method: 'textImage',
         visibleRange: [10, 3000], offset: [-40, -35],
         onClick: (name, data) => {
           this.flyToNode(data);
@@ -839,21 +857,21 @@ export class GaeaApp {
         },
       },
       secData: {
-        img: '/image/screenIcon/鏂潰.png', method: 'styled',
+        img: '/image/screenIcon/断面.png', method: 'styled',
         visibleRange: [10, 3000], offset: [-40, -35],
         onClick: (name, data) => {
           this._onSecDataClick(name, data);
         },
       },
       uavNests: {
-        img: '/image/screenIcon/鏃犱汉鏈?png', method: 'imageOnly',
+        img: '/image/screenIcon/无人机.png', method: 'imageOnly',
         visibleRange: [10, 5000], offset: [-25, -80],
         onClick: (name, data) => {
           document.dispatchEvent(new CustomEvent('gaea-icon-click', { detail: { category: 'uavNests', name, data } }));
         },
       },
       rescue: {
-        img: '/image/screenIcon/闅愭偅.png', method: 'imageOnly',
+        img: '/image/screenIcon/隐患.png', method: 'imageOnly',
         visibleRange: [10, 5000], offset: [-25, -80],
         onClick: (name, data) => {
           this.flyToNode(data);
@@ -861,7 +879,7 @@ export class GaeaApp {
         },
       },
       materials: {
-        img: '/image/screenIcon/鐗╄祫浠撳簱.png', method: 'imageOnly',
+        img: '/image/screenIcon/物资仓库.png', method: 'imageOnly',
         visibleRange: [10, 5000], offset: [-25, -80],
         onClick: (name, data) => {
           this.flyToNode(data);
@@ -869,7 +887,7 @@ export class GaeaApp {
         },
       },
     };
-    console.log('[GaeaApp] 寮€濮嬪垱寤哄睆骞曞浘鏍?.. categories:', cats.length);
+    console.log('[GaeaApp] 开始创建屏幕图标... categories:', cats.length);
     let count = 0;
     for (const cat of cats) {
       if (!cat.children?.length) continue;
@@ -894,34 +912,38 @@ export class GaeaApp {
             },
           });
         } catch (e) {
-          console.warn(`[GaeaApp] 鍥炬爣 ${child.text} 鍒涘缓澶辫触:`, e.message);
+          console.warn(`[GaeaApp] 图标 ${child.text} 创建失败:`, e.message);
         }
       }
-      // 鏍规嵁閰嶇疆鐨?visible 鍐冲畾鍒濆鏄鹃殣锛堜笉褰卞搷鍒涘缓锛屽彧鎺у埗鍒濆鐘舵€侊級
+      // 根据配置的 visible 决定初始显隐（不影响创建，只控制初始状态）
       if (cat.visible === false) {
         this.setCategoryVisible(cat.key, false);
       }
     }
-    console.log('[GaeaApp] 灞忓箷鍥炬爣鍒涘缓瀹屾垚, 鍏?', count);
-    // 閫氱煡澶栭儴鍥炬爣宸插氨缁?    document.dispatchEvent(new CustomEvent('gaea-icons-ready'));
+    console.log('[GaeaApp] 屏幕图标创建完成, 共:', count);
+    // 通知外部图标已就绪
+    document.dispatchEvent(new CustomEvent('gaea-icons-ready'));
   }
 
-  // ---- 鍥惧眰鍒嗙被鏄鹃殣鎺у埗 ----
+  // ---- 图层分类显隐控制 ----
 
   /**
-   * 璁剧疆鏌愪釜鍒嗙被鍥炬爣鐨勫彲瑙佹€?   * @param {string} categoryKey 鍒嗙被 key锛堝 'seawall', 'hydrometricStations' 绛夛級
-   * @param {boolean} visible 鏄惁鍙
+   * 设置某个分类图标的可见性
+   * @param {string} categoryKey 分类 key（如 'seawall', 'hydrometricStations' 等）
+   * @param {boolean} visible 是否可见
    */
   setCategoryVisible(categoryKey, visible) {
-    // 璁板綍鍒嗙被鏄鹃殣鐘舵€?    if (visible) {
+    // 记录分类显隐状态
+    if (visible) {
       this._hiddenCategories.delete(categoryKey)
     } else {
       this._hiddenCategories.add(categoryKey)
     }
     const els = document.querySelectorAll('.gaea-cat-' + categoryKey);
-    console.log('[GaeaApp] setCategoryVisible:', categoryKey, visible, '鍏冪礌鏁?', els.length);
+    console.log('[GaeaApp] setCategoryVisible:', categoryKey, visible, '元素数:', els.length);
     els.forEach(el => { el.style.display = visible && this._markersVisible ? '' : 'none'; });
-    // 鍚屾寮曟搸鍙鎬?    const items = this._screenIconList.filter(item => item.category === categoryKey);
+    // 同步引擎可见性
+    const items = this._screenIconList.filter(item => item.category === categoryKey);
     items.forEach(item => {
       if (visible && this._markersVisible) {
         item.element.UseAutoVisible();
@@ -934,7 +956,8 @@ export class GaeaApp {
   }
 
   /**
-   * 鑾峰彇鏌愪釜鍒嗙被鐨勫綋鍓嶅彲瑙佹€э紙鏍规嵁 DOM 鍏冪礌鍒ゆ柇锛?   * @param {string} categoryKey
+   * 获取某个分类的当前可见性（根据 DOM 元素判断）
+   * @param {string} categoryKey
    * @returns {boolean}
    */
   getCategoryVisible(categoryKey) {
@@ -942,13 +965,13 @@ export class GaeaApp {
     return el ? el.style.display !== 'none' : true;
   }
 
-  // ---- 鍏紑鏂规硶 ----
+  // ---- 公开方法 ----
 
-  /** 鍒濆鍖栭粯璁ゅ浘灞傚拰鐩告満瑙嗚锛堟墜鍔ㄨ皟鐢紝鍙紶鍙傝鐩栭厤缃級 */
+  /** 初始化默认图层和相机视角（手动调用，可传参覆盖配置） */
   async initDefaultLayers({ layers, cameraPosition } = {}) {
     const cfg = this.config;
     await this.getAllServe();
-    console.log('WMTS 鍥惧眰鏁伴噺:', this.layers.length);
+    console.log('WMTS 图层数量:', this.layers.length);
     this.layers.slice(0, 10).forEach(l => console.log(' -', l.Title));
 
     const pos = cameraPosition ?? cfg.defaultCameraPosition;
@@ -971,7 +994,7 @@ export class GaeaApp {
       const layers = Gaea.WMTSImageStore.ParserXml2Capabilities(hostUrl, xml);
       this.layers = [...this.layers, ...(layers || [])];
     } catch (e) {
-      console.warn('getAllServe 澶辫触:', e.message);
+      console.warn('getAllServe 失败:', e.message);
     }
     return this.layers;
   }
@@ -979,12 +1002,12 @@ export class GaeaApp {
   addLayer({ layerName, max, min, transparency, forMat = 'image/vnd.jpeg-png', inserIndex = null } = {}) {
     const mime = ['image/jpeg','image/png','image/tga','image/webp','image/bmp','application/json;type=geojson','image/vnd.jpeg-png'];
     const mimeIdx = mime.indexOf(forMat);
-    if (mimeIdx === -1) return console.warn('鏈煡鍥惧眰绫诲瀷:', forMat);
+    if (mimeIdx === -1) return console.warn('未知图层类型:', forMat);
 
-    if (!this.layers?.length) return console.warn('鍥惧眰鍒楄〃涓虹┖锛岃鍏堣皟鐢?getAllServe()');
+    if (!this.layers?.length) return console.warn('图层列表为空，请先调用 getAllServe()');
 
     const capability = this.layers.find(i => i.Title === layerName);
-    if (!capability) return console.warn(`鍥惧眰 "${layerName}" 鏈壘鍒癭);
+    if (!capability) return console.warn(`图层 "${layerName}" 未找到`);
 
     const store = new Gaea.WMTSImageStore();
     store.ImageExtension = mimeIdx;
@@ -993,24 +1016,24 @@ export class GaeaApp {
     if (max !== undefined) store.LevelRange = new Gaea.Vector2(min, max);
     if (transparency !== undefined) store.ImageTransparency = transparency;
 
-    if (!store.CurrentCapabilitie.InstanceID) return console.error(`${layerName} 鍔犺浇寮傚父`);
+    if (!store.CurrentCapabilitie.InstanceID) return console.error(`${layerName} 加载异常`);
 
     const tileset = Gaea.World.Instance.DefaultPyramidTileSet;
     inserIndex !== null ? tileset.InsertImageStore(store, inserIndex) : tileset.AddImageStore(store);
-    console.log(`褰卞儚 "${layerName}" 娣诲姞鎴愬姛`);
+    console.log(`影像 "${layerName}" 添加成功`);
     return store;
   }
 
-  // ---- 鍦板舰鏈嶅姟 ----
+  // ---- 地形服务 ----
 
-  /** 鍔犺浇鍗曚釜鍦板舰鏈嶅姟 */
+  /** 加载单个地形服务 */
   _initTerrainServer(url) {
     return new Promise((resolve) => {
       Gaea.World.Instance.InitTerrainServer2(url, () => resolve());
     });
   }
 
-  /** 鍔犺浇閰嶇疆涓殑鍦板舰鏈嶅姟锛坈fg.defaultTerrains锛寀rl 涓虹浉瀵?serveUrl 鐨勮矾寰勬垨瀹屾暣鍦板潃锛?*/
+  /** 加载配置中的地形服务（cfg.defaultTerrains，url 为相对 serveUrl 的路径或完整地址） */
   async addInitTerrainServer(terrains) {
     const cfg = this.config;
     const list = terrains ?? cfg.defaultTerrains;
@@ -1019,20 +1042,20 @@ export class GaeaApp {
       const url = /^https?:\/\//.test(t.url) ? t.url : `${cfg.serveUrl}${t.url}`;
       try {
         await this._initTerrainServer(url);
-        console.log(`鍦板舰 "${t.name}" 鍔犺浇鎴愬姛`);
+        console.log(`地形 "${t.name}" 加载成功`);
       } catch (e) {
-        console.warn(`鍦板舰 "${t.name}" 鍔犺浇澶辫触:`, e?.message);
+        console.warn(`地形 "${t.name}" 加载失败:`, e?.message);
       }
     }
   }
 
-  // ---- 璐村湴绾匡紙鐭㈤噺绾挎湇鍔★級 ----
+  // ---- 贴地线（矢量线服务） ----
 
-  /** 浠?WMTS 鏈嶅姟鍒楄〃鍒涘缓鐭㈤噺瑕佺礌鏈嶅姟 */
+  /** 从 WMTS 服务列表创建矢量要素服务 */
   CreateFeature(serviceName, levelRange, render, alias) {
-    if (!this.layers?.length) return console.warn('鐭㈤噺鏈嶅姟鍒楄〃涓虹┖锛岃鍏堣皟鐢?getAllServe()');
+    if (!this.layers?.length) return console.warn('矢量服务列表为空，请先调用 getAllServe()');
     const cap = this.layers.find(i => i.Title === serviceName);
-    if (!cap) return console.warn(`鐭㈤噺鏈嶅姟 "${serviceName}" 鏈壘鍒癭);
+    if (!cap) return console.warn(`矢量服务 "${serviceName}" 未找到`);
     const store = new Gaea.WMTSVectorStore();
     store.Name = alias == null ? serviceName : alias;
     store.Init(cap);
@@ -1043,7 +1066,7 @@ export class GaeaApp {
     return store;
   }
 
-  /** 娣诲姞鍗曟潯璐村湴绾?*/
+  /** 添加单条贴地线 */
   AddVTSLine({ name, range, color, index }) {
     const symbol = new Gaea.GroundPolylineSymbol();
     symbol.Width = 2;
@@ -1055,37 +1078,40 @@ export class GaeaApp {
     return render;
   }
 
-  /** 鍔犺浇閰嶇疆涓殑璐村湴绾匡紙cfg.defaultGroundLines锛屼緷璧?getAllServe 鐨勬湇鍔″垪琛級 */
+  /** 加载配置中的贴地线（cfg.defaultGroundLines，依赖 getAllServe 的服务列表） */
   addGroundLines(groundLines) {
     const cfg = this.config;
     const list = groundLines ?? cfg.defaultGroundLines;
     if (!list?.length) return;
-    if (!this.layers?.length) return console.warn('璐村湴绾块渶瑕佸厛鍔犺浇 WMTS 鏈嶅姟鍒楄〃(getAllServe)');
+    if (!this.layers?.length) return console.warn('贴地线需要先加载 WMTS 服务列表(getAllServe)');
     for (const item of list) {
       if (item.isInitLoad === false) continue;
       try {
         this.AddVTSLine(item);
-        console.log(`璐村湴绾?"${item.name}" 鍔犺浇鎴愬姛`);
+        console.log(`贴地线 "${item.name}" 加载成功`);
       } catch (e) {
-        console.warn(`璐村湴绾?"${item.name}" 鍔犺浇澶辫触:`, e?.message);
+        console.warn(`贴地线 "${item.name}" 加载失败:`, e?.message);
       }
     }
   }
 
-  // ---- 璐村湴闈紙鐭㈤噺闈㈢粯鍒讹級 ----
+  // ---- 贴地面（矢量面绘制） ----
 
   /**
-   * 鏍规嵁鍧愭爣鏁扮粍娣诲姞璐村湴闈?   * @param {Array} coords - 鍧愭爣鏁扮粍锛屾牸寮?[[lng, lat], [lng, lat], ...]
-   * @param {string} name - 闈㈠悕绉?   * @param {string} colorHex - 棰滆壊 hex 鍊硷紝濡?'#3498db'
-   * @returns {object|null} 鍒涘缓鐨?PolygonGeometryElement锛屽け璐ヨ繑鍥?null
+   * 根据坐标数组添加贴地面
+   * @param {Array} coords - 坐标数组，格式 [[lng, lat], [lng, lat], ...]
+   * @param {string} name - 面名称
+   * @param {string} colorHex - 颜色 hex 值，如 '#3498db'
+   * @returns {object|null} 创建的 PolygonGeometryElement，失败返回 null
    */
   addGroundPolygonByCoords(coords, name, colorHex) {
     if (!coords || coords.length < 3) {
-      console.warn(`鍧愭爣鐐逛笉瓒筹紝璺宠繃: ${name}`);
+      console.warn(`坐标点不足，跳过: ${name}`);
       return null;
     }
-    // 妫€鏌ユ槸鍚﹀凡瀛樺湪鍚屽悕闈?    if (this._groundPolygonElements.find(p => p.name === name)) {
-      console.warn(`璐村湴闈?"${name}" 宸插瓨鍦紝璺宠繃`);
+    // 检查是否已存在同名面
+    if (this._groundPolygonElements.find(p => p.name === name)) {
+      console.warn(`贴地面 "${name}" 已存在，跳过`);
       return null;
     }
 
@@ -1121,36 +1147,36 @@ export class GaeaApp {
     return polygonElement;
   }
 
-  /** 绉婚櫎鎸囧畾璐村湴闈?*/
+  /** 移除指定贴地面 */
   removeGroundPolygon(element) {
     try {
       Gaea.World.Instance.RenderableObjectList.Remove(element);
     } catch (err) {
-      console.error('绉婚櫎璐村湴闈㈠け璐?', err);
+      console.error('移除贴地面失败:', err);
     }
     const idx = this._groundPolygonElements.findIndex(p => p.element === element);
     if (idx >= 0) this._groundPolygonElements.splice(idx, 1);
   }
 
-  /** 娓呴櫎鎵€鏈夎创鍦伴潰 */
+  /** 清除所有贴地面 */
   clearAllGroundPolygons() {
     this._groundPolygonElements.forEach(item => {
       try {
         Gaea.World.Instance.RenderableObjectList.Remove(item.element);
       } catch (err) {
-        console.error('绉婚櫎璐村湴闈㈠け璐?', err);
+        console.error('移除贴地面失败:', err);
       }
     });
     this._groundPolygonElements = [];
   }
 
-  /** 瀹氫綅鍒版寚瀹氳瑙掞紙缁忕含搴﹂珮绋?+ 鐩告満鍙傛暟锛?*/
+  /** 定位到指定视角（经纬度高程 + 相机参数） */
   SetPosition(numStr) {
     const arr = numStr.split(',').map(s => Number(s.trim()));
     Gaea.World.Instance.DefaultCamera.SetPosition2(arr[0], arr[1], arr[2], arr[3], arr[4], arr[5]);
   }
 
-  /** 椋炲埌鍥惧眰鏍戣妭鐐逛綅缃?*/
+  /** 飞到图层树节点位置 */
   flyToNode(node) {
     if (!node?.position) return;
     const { x, y, z } = node.position;
@@ -1159,8 +1185,9 @@ export class GaeaApp {
   }
 
   /**
-   * 鏍规嵁鍚嶇О鎴?id 瀹氫綅鍒版捣濉?   * @param {string} name - 娴峰鍚嶇О鎴?id
-   * @param {string} [tilesetUrl] - 鍙€夛紝鍊炬枩鎽勫奖 3D Tiles 鐨?tileset.json 鍦板潃
+   * 根据名称或 id 定位到海塘
+   * @param {string} name - 海塘名称或 id
+   * @param {string} [tilesetUrl] - 可选，倾斜摄影 3D Tiles 的 tileset.json 地址
    */
   flyToSeawall = (name, tilesetUrl) => {
     const cats = this.layerCategories || []
@@ -1175,12 +1202,12 @@ export class GaeaApp {
         return
       }
     }
-    console.warn(`[GaeaApp] 鏈壘鍒版捣濉? ${name}`)
+    console.warn(`[GaeaApp] 未找到海塘: ${name}`)
   };
 
   /**
-   * 鍔犺浇鍊炬枩鎽勫奖 3D Tiles
-   * @param {Object} item - { jsonUrl: tileset.json鍦板潃, tilName?: 鍚嶇О, height?: 楂樺害鍋忕Щ, isInitLoad?: 鏄惁鍒濆鍖栧姞杞?}
+   * 加载倾斜摄影 3D Tiles
+   * @param {Object} item - { jsonUrl: tileset.json地址, tilName?: 名称, height?: 高度偏移, isInitLoad?: 是否初始化加载 }
    */
   add3DTiles = (item) => {
     const tilesetUrl = typeof item === 'string' ? item : item.jsonUrl
@@ -1207,43 +1234,45 @@ export class GaeaApp {
     if (name) {
       this._tilesetMap[name] = tileset
     }
-    console.log('[GaeaApp] 3D Tiles 宸插姞杞?', name || tilesetUrl, height ? `楂樺害: ${height}` : '', enabledClip ? '(瑁佸壀宸插惎鐢?' : '')
+    console.log('[GaeaApp] 3D Tiles 已加载:', name || tilesetUrl, height ? `高度: ${height}` : '', enabledClip ? '(裁剪已启用)' : '')
     return tileset
   };
 
-  // ---- 鍊炬枩鎸栨柟 ----
+  // ---- 倾斜挖方 ----
 
   /**
-   * 鏍规嵁澶氳竟褰㈠潗鏍囪鍓湴褰紙鍊炬枩鎸栨柟锛?   * @param {Array<{x: number, y: number, z: number}>} pointList - 澶氳竟褰㈤《鐐瑰潗鏍囨暟缁?[{x: 绾害, y: 缁忓害, z: 楂樼▼}, ...]
-   * @param {number} height - 瑁佸壀娣卞害/楂樺害
-   * @param {Function} [callback] - 瀹屾垚鍚庣殑鍥炶皟鍑芥暟锛屾帴鏀?_Holeitem
-   * @returns {boolean} 鏄惁鎴愬姛
+   * 根据多边形坐标裁剪地形（倾斜挖方）
+   * @param {Array<{x: number, y: number, z: number}>} pointList - 多边形顶点坐标数组 [{x: 纬度, y: 经度, z: 高程}, ...]
+   * @param {number} height - 裁剪深度/高度
+   * @param {Function} [callback] - 完成后的回调函数，接收 _Holeitem
+   * @returns {boolean} 是否成功
    * @example
    * app.editTerrainTool([
    *   { x: 27.2205, y: 120.456, z: 10 },
    *   { x: 27.2210, y: 120.458, z: 10 },
    *   { x: 27.2195, y: 120.458, z: 10 }
-   * ], 50, (item) => { console.log('鎸栨柟瀹屾垚', item) })
+   * ], 50, (item) => { console.log('挖方完成', item) })
    */
   editTerrainTool = (pointList, height, callback) => {
     if (!pointList || pointList.length === 0) {
-      console.warn('[GaeaApp] editTerrainTool: pointList 涓嶈兘涓虹┖')
+      console.warn('[GaeaApp] editTerrainTool: pointList 不能为空')
       return false
     }
 
     const Position = pointList.map(point => new Gaea.Vector3(point.x, point.y, point.z))
 
-    // 缁忕含搴?鈫?绗涘崱灏斿潗鏍?    const originPoint = pointList.map(p => Gaea.GaeaMath.SphericalToCartesianDeg(new Gaea.Vector3(p.x, p.y, p.z)))
+    // 经纬度 → 笛卡尔坐标
+    const originPoint = pointList.map(p => Gaea.GaeaMath.SphericalToCartesianDeg(new Gaea.Vector3(p.x, p.y, p.z)))
 
-    // 鍚敤 QueryServer
+    // 启用 QueryServer
     Gaea.QueryServer.Instance.Enable = true
 
-    // 娓呮棫鎸栨柟
+    // 清旧挖方
     if (this._holeItem) {
       Gaea.ExcavationManager.Instance.RemoveItem(this._holeItem)
     }
 
-    // 鍒涘缓鎸栨柟瀵硅薄 (鍧愭爣鐐? 鎻掑€艰窛绂? 娣卞害, UV缂╂斁, 鏄惁娉曠嚎鏉愯川, 鏄惁闇€瑕乪dge)
+    // 创建挖方对象 (坐标点, 插值距离, 深度, UV缩放, 是否法线材质, 是否需要edge)
     this._holeItem = Gaea.ExcavationManager.Instance.CreateItem(originPoint, 100, height, 100, true, true)
     Gaea.ExcavationManager.Instance.ExposureLength = 0
     Gaea.ExcavationManager.Instance.AddItem(this._holeItem)
@@ -1256,7 +1285,7 @@ export class GaeaApp {
       Gaea.QueryServer.Instance.ClipBox = box
     }
 
-    console.log('[GaeaApp] 鎸栨柟宸叉墽琛?', `娣卞害: ${height}`, `椤剁偣鏁? ${pointList.length}`)
+    console.log('[GaeaApp] 挖方已执行:', `深度: ${height}`, `顶点数: ${pointList.length}`)
 
     setTimeout(() => {
       if (typeof callback === 'function') {
@@ -1266,7 +1295,7 @@ export class GaeaApp {
   };
 
   /**
-   * 杩樺師鍦板舰锛堟竻闄ゆ墍鏈夋寲鏂规晥鏋滐級
+   * 还原地形（清除所有挖方效果）
    */
   restoreTerrain = () => {
     if (this._holeItem) {
@@ -1279,26 +1308,27 @@ export class GaeaApp {
       Gaea.QueryServer.Instance.ClipBox.QueueFree()
       Gaea.QueryServer.Instance.ClipBox = null
     }
-    console.log('[GaeaApp] 鍦板舰宸茶繕鍘?)
+    console.log('[GaeaApp] 地形已还原')
   };
 
   /**
-   * 鐩戝惉鐢诲竷榧犳爣鐐瑰嚮锛岃幏鍙栫偣鍑讳綅缃殑缁忕含搴﹀潗鏍?   * @example
+   * 监听画布鼠标点击，获取点击位置的经纬度坐标
+   * @example
    * app.addMouseClick((pos) => {
-   *   console.log('鐐瑰嚮浣嶇疆:', pos) // { x: 绾害, y: 缁忓害, z: 楂樼▼ }
+   *   console.log('点击位置:', pos) // { x: 纬度, y: 经度, z: 高程 }
    * })
    */
   addMouseClick = (callback) => {
     const canvas = document.getElementById('canvas')
     if (!canvas) {
-      console.warn('[GaeaApp] addMouseClick: canvas 鍏冪礌鏈壘鍒?)
+      console.warn('[GaeaApp] addMouseClick: canvas 元素未找到')
       return
     }
     canvas.addEventListener('mousedown', (event) => {
       const result = Gaea.GaeaMath.ProjectPosition(new Gaea.Vector2(event.offsetX, event.offsetY))
       const lonlat = Gaea.GaeaMath.CartesianToSphericalDeg(result)
       const pos = { x: lonlat.x, y: lonlat.y, z: lonlat.z }
-      console.log('[GaeaApp] 鐐瑰嚮浣嶇疆:', pos)
+      console.log('[GaeaApp] 点击位置:', pos)
       if (typeof callback === 'function') {
         callback(pos)
       }
@@ -1306,17 +1336,17 @@ export class GaeaApp {
   };
 
   /**
-   * 鑾峰彇宸插姞杞界殑妯″瀷鍏冪礌
-   * @param {string} name - 妯″瀷鍚嶇О
-   * @returns {object} GLTFElement 鎴?null
+   * 获取已加载的模型元素
+   * @param {string} name - 模型名称
+   * @returns {object} GLTFElement 或 null
    */
   getModel = (name) => {
     return this._gltfElements[name] || null
   };
 
   /**
-   * 鑾峰彇妯″瀷褰撳墠鐘舵€侊紙浣嶇疆銆佹棆杞€佺缉鏀撅級
-   * @param {string} name - 妯″瀷鍚嶇О
+   * 获取模型当前状态（位置、旋转、缩放）
+   * @param {string} name - 模型名称
    * @returns {object|null} { position, rotate, scale, visible }
    */
   getModelInfo = (name) => {
@@ -1331,68 +1361,72 @@ export class GaeaApp {
   };
 
   /**
-   * 璁剧疆妯″瀷浣嶇疆锛堢粡绾害 + 楂樼▼锛?   * @param {string} name - 妯″瀷鍚嶇О
-   * @param {object} position - { x: 绾害, y: 缁忓害, z: 楂樼▼ }
+   * 设置模型位置（经纬度 + 高程）
+   * @param {string} name - 模型名称
+   * @param {object} position - { x: 纬度, y: 经度, z: 高程 }
    */
   setModelPosition = (name, position) => {
     const el = this._gltfElements[name]
-    if (!el) { console.warn(`[GaeaApp] 妯″瀷 "${name}" 鏈壘鍒癭); return }
+    if (!el) { console.warn(`[GaeaApp] 模型 "${name}" 未找到`); return }
     el.GeographyPosition = new Gaea.Vector3(position.x, position.y, position.z)
   };
 
   /**
-   * 璁剧疆妯″瀷鏃嬭浆
-   * @param {string} name - 妯″瀷鍚嶇О
+   * 设置模型旋转
+   * @param {string} name - 模型名称
    * @param {number[]} rotate - [pitch, yaw, roll]
    */
   setModelRotation = (name, rotate) => {
     const el = this._gltfElements[name]
-    if (!el) { console.warn(`[GaeaApp] 妯″瀷 "${name}" 鏈壘鍒癭); return }
+    if (!el) { console.warn(`[GaeaApp] 模型 "${name}" 未找到`); return }
     el.TiltHeadingBank = new Gaea.Vector3(rotate[0], rotate[1], rotate[2])
   };
 
   /**
-   * 璁剧疆妯″瀷缂╂斁
-   * @param {string} name - 妯″瀷鍚嶇О
+   * 设置模型缩放
+   * @param {string} name - 模型名称
    * @param {number[]} size - [sx, sy, sz]
    */
   setModelScale = (name, size) => {
     const el = this._gltfElements[name]
-    if (!el) { console.warn(`[GaeaApp] 妯″瀷 "${name}" 鏈壘鍒癭); return }
+    if (!el) { console.warn(`[GaeaApp] 模型 "${name}" 未找到`); return }
     el.Root.Scale = new Gaea.Vector3(size[0], size[1], size[2])
   };
 
   /**
-   * 璁剧疆妯″瀷鍙鎬?   * @param {string} name - 妯″瀷鍚嶇О
+   * 设置模型可见性
+   * @param {string} name - 模型名称
    * @param {boolean} visible
    */
   setModelVisible = (name, visible) => {
     const el = this._gltfElements[name]
-    if (!el) { console.warn(`[GaeaApp] 妯″瀷 "${name}" 鏈壘鍒癭); return }
+    if (!el) { console.warn(`[GaeaApp] 模型 "${name}" 未找到`); return }
     el.Root.Visible = visible
   };
 
   /**
-   * 绉婚櫎妯″瀷锛堝弬鑰?ht_3dview removeGltf锛?   * @param {string} name - 妯″瀷鍚嶇О
+   * 移除模型（参考 ht_3dview removeGltf）
+   * @param {string} name - 模型名称
    */
   removeGltf = (name) => {
     const el = this._gltfElements[name]
-    if (!el) { console.warn(`[GaeaApp] 妯″瀷 "${name}" 鏈壘鍒癭); return }
+    if (!el) { console.warn(`[GaeaApp] 模型 "${name}" 未找到`); return }
     Gaea.World.Instance.RenderableObjectList.Remove(el)
     delete this._gltfElements[name]
     delete this._gltfCfgMap[name]
   };
 
   /**
-   * 淇敼妯″瀷閰嶇疆锛堜綅缃?鏃嬭浆/缂╂斁涓€璧疯缃紝鍙傝€?ht_3dview updateElementPosition锛?   * @param {object} options
-   * @param {string} options.name - 妯″瀷鍚嶇О
-   * @param {object} options.position - { x: 绾害, y: 缁忓害, z: 楂樼▼ }
+   * 修改模型配置（位置/旋转/缩放一起设置，参考 ht_3dview updateElementPosition）
+   * @param {object} options
+   * @param {string} options.name - 模型名称
+   * @param {object} options.position - { x: 纬度, y: 经度, z: 高程 }
    * @param {number[]} [options.rotate] - [pitch, yaw, roll]
    * @param {number[]} [options.size] - [sx, sy, sz]
    */
   updateElementPosition = ({ name, position, rotate, size }) => {
     const el = this._gltfElements[name]
-    if (!el) { console.warn(`[GaeaApp] 妯″瀷 "${name}" 鏈壘鍒癭); return }
+    if (!el) { console.warn(`[GaeaApp] 模型 "${name}" 未找到`); return }
     if (position) {
       el.GeographyPosition = new Gaea.Vector3(position.x, position.y, position.z)
     }
@@ -1405,8 +1439,11 @@ export class GaeaApp {
   };
 
   /**
-   * 娣诲姞榧犳爣绉诲姩鐩戝惉锛堝弬鑰?ht_3dview addMouseMove锛屼娇鐢?Gaea 寮曟搸浜嬩欢锛?   * 鍥炶皟杩斿洖褰撳墠榧犳爣鎵€鍦ㄤ綅缃殑缁忕含搴﹀潗鏍?   * @param {function} cb - (pos: {x,y,z}) => void
-   * @returns {function} 璋冪敤鍙彇娑堢洃鍚?   */
+   * 添加鼠标移动监听（参考 ht_3dview addMouseMove，使用 Gaea 引擎事件）
+   * 回调返回当前鼠标所在位置的经纬度坐标
+   * @param {function} cb - (pos: {x,y,z}) => void
+   * @returns {function} 调用可取消监听
+   */
   addMouseMove = (cb = null) => {
     const handle = Gaea.World.Instance.OnMouseMove((p, b) => {
       const screenpos = new Gaea.Vector2(p.x, p.y)
@@ -1423,7 +1460,7 @@ export class GaeaApp {
   };
 
   /**
-   * 绉婚櫎榧犳爣绉诲姩鐩戝惉
+   * 移除鼠标移动监听
    */
   removeMouseMove = () => {
     if (this._mouseMoveHandle) {
@@ -1433,12 +1470,15 @@ export class GaeaApp {
   };
 
   /**
-   * 娣诲姞榧犳爣鎶捣鐩戝惉锛堝弬鑰?ht_3dview锛屼娇鐢?Gaea 寮曟搸 OnMouseUp 浜嬩欢锛?   * 鍥炶皟杩斿洖鐐瑰嚮浣嶇疆鐨勭粡绾害鍧愭爣
+   * 添加鼠标抬起监听（参考 ht_3dview，使用 Gaea 引擎 OnMouseUp 事件）
+   * 回调返回点击位置的经纬度坐标
    * @param {function} cb - (pos: {x,y,z}) => void
-   * @returns {function} 璋冪敤鍙彇娑堢洃鍚?   */
+   * @returns {function} 调用可取消监听
+   */
   addMouseUp = (cb = null) => {
     const handle = Gaea.World.Instance.OnMouseUp((p, b) => {
-      if (b !== 1) return // 浠呭乏閿?      const screenpos = new Gaea.Vector2(p.x, p.y)
+      if (b !== 1) return // 仅左键
+      const screenpos = new Gaea.Vector2(p.x, p.y)
       const spacepos = Gaea.GaeaMath.ProjectPosition(screenpos)
       const latlonalt = Gaea.GaeaMath.CartesianToSphericalDeg(spacepos)
       const pos = { x: latlonalt.x, y: latlonalt.y, z: latlonalt.z }
@@ -1452,7 +1492,7 @@ export class GaeaApp {
   };
 
   /**
-   * 绉婚櫎榧犳爣鎶捣鐩戝惉
+   * 移除鼠标抬起监听
    */
   removeMouseUp = () => {
     if (this._mouseUpHandle) {
@@ -1462,9 +1502,11 @@ export class GaeaApp {
   };
 
   /**
-   * 浜や簰寮忔嬀鍙栧潗鏍囷紙鐐瑰嚮鍦板浘鑾峰彇缁忕含搴︼紝鍙傝€?ht_3dview 閫夋嫨鍧愭爣娴佺▼锛?   * 鐐瑰嚮鍦板浘鍚庡洖璋冭繑鍥炲潗鏍囷紝鑷姩鍙栨秷鐩戝惉
+   * 交互式拾取坐标（点击地图获取经纬度，参考 ht_3dview 选择坐标流程）
+   * 点击地图后回调返回坐标，自动取消监听
    * @param {function} cb - (pos: {x,y,z}) => void
-   * @returns {function} 璋冪敤鍙彇娑堟嬀鍙?   */
+   * @returns {function} 调用可取消拾取
+   */
   pickPosition = (cb) => {
     const cancel = this.addMouseUp((pos) => {
       cancel()
@@ -1474,9 +1516,10 @@ export class GaeaApp {
   };
 
   /**
-   * 浜や簰寮忔嬀鍙栨ā鍨嬶紝杩斿洖妯″瀷淇℃伅
+   * 交互式拾取模型，返回模型信息
    * @param {function} callback - (modelInfo) => void
-   * @returns {function} 璋冪敤鍙彇娑堟嬀鍙?   */
+   * @returns {function} 调用可取消拾取
+   */
   pickModel = (callback) => {
     const canvas = document.getElementById('canvas')
     if (!canvas) return () => {}
@@ -1498,7 +1541,8 @@ export class GaeaApp {
   };
 
   /**
-   * 鑾峰彇鎵€鏈夊彲閫夋ā鍨嬪垪琛紙鐢ㄤ簬闈㈡澘涓嬫媺閫夋嫨锛屽弬鑰?ht_3dview gaeaData.gltfList锛?   * @returns {Array<{name: string, url: string, position?: object}>}
+   * 获取所有可选模型列表（用于面板下拉选择，参考 ht_3dview gaeaData.gltfList）
+   * @returns {Array<{name: string, url: string, position?: object}>}
    */
   getGltfList = () => {
     return Object.values(this._gltfCfgMap).map(cfg => ({
@@ -1508,10 +1552,12 @@ export class GaeaApp {
   };
 
   /**
-   * 鍔犺浇鐢ㄦ埛鑷畾涔夋ā鍨嬶紙鍙傝€?ht_3dview addGltf锛?   * 鏂板妯″瀷鍒板満鏅苟璁板綍鍒伴厤缃〃
+   * 加载用户自定义模型（参考 ht_3dview addGltf）
+   * 新增模型到场景并记录到配置表
    * @param {object} cfg
-   * @param {string} cfg.name - 妯″瀷瀹炰緥鍚嶏紙涓嶈兘閲嶅锛?   * @param {string} cfg.url - 妯″瀷 URL
-   * @param {object} cfg.position - { x: 绾害, y: 缁忓害, z: 楂樼▼ }
+   * @param {string} cfg.name - 模型实例名（不能重复）
+   * @param {string} cfg.url - 模型 URL
+   * @param {object} cfg.position - { x: 纬度, y: 经度, z: 高程 }
    * @param {number[]} cfg.rotate - [pitch, yaw, roll]
    * @param {number[]} cfg.size - [sx, sy, sz]
    * @param {boolean} [cfg.show=true]
@@ -1521,10 +1567,10 @@ export class GaeaApp {
   addGltf = async (cfg) => {
     const { name, url, position, rotate, size, show = true, enablePick = true } = cfg;
     if (!name || !url || !position || !rotate || !size) {
-      console.warn('[GaeaApp] addGltf: 缂哄皯蹇呰鍙傛暟', cfg);
+      console.warn('[GaeaApp] addGltf: 缺少必要参数', cfg);
       return null;
     }
-    // 璁板綍鍒伴厤缃〃锛屼緵鍚庣画闈㈡澘缂栬緫
+    // 记录到配置表，供后续面板编辑
     this._gltfCfgMap[name] = {
       name, url, position: { ...position }, rotate: [...rotate], size: [...size],
       show, enablePick, isUserAdd: true
@@ -1537,21 +1583,25 @@ export class GaeaApp {
   };
 
   /**
-   * 鏍规嵁缁忕含搴﹂鍒版寚瀹氫綅缃?   * @param {number} lat - 绾害
-   * @param {number} lng - 缁忓害
-   * @param {number} [z=0] - 鍦伴潰楂樼▼
-   * @param {number} [alt=500] - 鐩告満楂樺害
-   * @param {number} [pitch=0] - 淇话瑙掞紝榛樿 0锛堝瀭鐩翠刊瑙嗭級锛岃礋鍊煎悜鍓嶅€炬枩
-   * @param {number} [yaw=0] - 鍋忚埅瑙?   */
+   * 根据经纬度飞到指定位置
+   * @param {number} lat - 纬度
+   * @param {number} lng - 经度
+   * @param {number} [z=0] - 地面高程
+   * @param {number} [alt=500] - 相机高度
+   * @param {number} [pitch=0] - 俯仰角，默认 0（垂直俯视），负值向前倾斜
+   * @param {number} [yaw=0] - 偏航角
+   */
   flyToPosition = (lat, lng, z = 0, alt = 500, pitch = 0, yaw = 0) => {
     this.SetPosition(`${lat},${lng},${z},${alt},${pitch},${yaw}`)
   };
 
-  // ---- 娌跨嚎椋炶 ----
+  // ---- 沿线飞行 ----
 
   /**
-   * 娌跨嚎椋炶 - 鐩告満娌胯矾寰勮嚜鍔ㄩ琛?   * @param {Array} lineData - 璺緞鐐规暟缁勶紝姣忎釜鐐?{x: 绾害, y: 缁忓害, z?: 楂樺害}
-   * @param {Object} options - 椋炶閰嶇疆锛坔eight/step/duration/xrotation/lockEye/minZoom/maxZoom锛?   * @returns {Promise} 椋炶瀹屾垚鍚?resolve
+   * 沿线飞行 - 相机沿路径自动飞行
+   * @param {Array} lineData - 路径点数组，每个点 {x: 纬度, y: 经度, z?: 高度}
+   * @param {Object} options - 飞行配置（height/step/duration/xrotation/lockEye/minZoom/maxZoom）
+   * @returns {Promise} 飞行完成后 resolve
    */
   flyAlongPath = async (lineData, options = {}) => {
     const opts = {
@@ -1566,8 +1616,8 @@ export class GaeaApp {
     };
 
     if (!lineData || lineData.length < 2) {
-      console.error('flyAlongPath: 鑷冲皯闇€瑕?涓矾寰勭偣');
-      return Promise.reject(new Error('鑷冲皯闇€瑕?涓矾寰勭偣'));
+      console.error('flyAlongPath: 至少需要2个路径点');
+      return Promise.reject(new Error('至少需要2个路径点'));
     }
 
     try {
@@ -1616,28 +1666,29 @@ export class GaeaApp {
 
       return new Promise((resolve) => {
         this._flyAnimationPlayer.PlayWithCallback('flyPathAnimation', Gaea.CallbackType.AnimatioFinished, () => {
-          console.log('娌跨嚎椋炶鍔ㄧ敾鎾斁瀹屾垚');
+          console.log('沿线飞行动画播放完成');
           resolve();
         });
       });
     } catch (error) {
-      console.error('flyAlongPath 鍚姩澶辫触:', error);
+      console.error('flyAlongPath 启动失败:', error);
       this._cleanupFlyResources();
       return Promise.reject(error);
     }
   };
 
-  /** 鍋滄娌跨嚎椋炶 */
+  /** 停止沿线飞行 */
   stopFlyAlongPath = () => {
     try {
-      // Godot AnimationPlayer.Stop(reset:bool)锛屽弬鏁版槸甯冨皵鑰岄潪鍔ㄧ敾鍚?      if (this._flyAnimationPlayer) this._flyAnimationPlayer.Stop(false);
+      // Godot AnimationPlayer.Stop(reset:bool)，参数是布尔而非动画名
+      if (this._flyAnimationPlayer) this._flyAnimationPlayer.Stop(false);
     } catch (error) {
-      console.error('鍋滄椋炶澶辫触:', error);
+      console.error('停止飞行失败:', error);
     }
     this._cleanupFlyResources();
   };
 
-  /** 娓呯悊椋炶鐩稿叧璧勬簮 */
+  /** 清理飞行相关资源 */
   _cleanupFlyResources = () => {
     try {
       if (this._flyAnimationPlayer) {
@@ -1652,11 +1703,11 @@ export class GaeaApp {
       Gaea.World.Instance.CameraController.LockedEntity = null;
       this._flyAnimation = null;
     } catch (error) {
-      console.error('娓呯悊椋炶璧勬簮澶辫触:', error);
+      console.error('清理飞行资源失败:', error);
     }
   };
 
-  /** 鐩告満澶嶄綅鍒伴粯璁よ瑙?*/
+  /** 相机复位到默认视角 */
   cameraReset = () => {
     this._cleanupFlyResources();
     const pos = this.config.defaultCameraPosition;
@@ -1664,13 +1715,14 @@ export class GaeaApp {
   };
 
   /**
-   * 娣诲姞灞忓箷鍥炬爣锛堝弬鑰?ht_3dview 涓夌鍒涘缓鏂瑰紡锛?   * @param {string} opts.method - 'textImage' | 'styled' | 'imageOnly'
+   * 添加屏幕图标（参考 ht_3dview 三种创建方式）
+   * @param {string} opts.method - 'textImage' | 'styled' | 'imageOnly'
    */
   addScreenIcon({ name, text, imgUrl, position, method = 'textImage', offset = [0, 0], visibleRange = [10, 50000], anchorType = 6, drawLine = false, onClick, type = null, category = null, divId: externalDivId, elementName, elementChildrenIndex } = {}) {
     const safeId = name.replace(/[^a-zA-Z0-9\u4e00-\u9fa5]/g, '_');
     const divId = externalDivId || 'gaea-icon-' + safeId;
 
-    // 濡傛灉鏄閮ㄤ紶鍏ョ殑 divId锛岀洿鎺ヤ娇鐢ㄥ凡鏈夌殑 DOM 鍏冪礌
+    // 如果是外部传入的 divId，直接使用已有的 DOM 元素
     let container;
     if (externalDivId) {
       container = document.getElementById(externalDivId);
@@ -1720,7 +1772,8 @@ export class GaeaApp {
 
     } // end else (externalDivId)
 
-    // 鎵撳垎绫绘爣璁帮紝鐢ㄤ簬鎸夌被鍒樉闅?    if (category) {
+    // 打分类标记，用于按类别显隐
+    if (category) {
       container.classList.add('gaea-cat-' + category);
     }
 
@@ -1733,10 +1786,11 @@ export class GaeaApp {
     container.style.pointerEvents = 'auto';
     container.style.cursor = 'pointer';
 
-    // 鍦?DOM 涓婄粦鐐瑰嚮浜嬩欢锛圙aea ScreenGUIElement 鐨?OnHitElement 瀵?DOM 鍨嬪浘鏍囦笉鐢熸晥锛?    container.addEventListener('click', (e) => {
+    // 在 DOM 上绑点击事件（Gaea ScreenGUIElement 的 OnHitElement 对 DOM 型图标不生效）
+    container.addEventListener('click', (e) => {
       e.stopPropagation();
       e.preventDefault();
-      console.log('[GaeaApp] 鍥炬爣鐐瑰嚮:', name);
+      console.log('[GaeaApp] 图标点击:', name);
       if (onClick) { onClick(name, { text, position }); }
       else if (position) { this.flyToNode({ position }); }
     });
@@ -1761,7 +1815,7 @@ export class GaeaApp {
     screen.EnablePick = true;
     if (visibleRange.length) screen.VisibleRange = new Gaea.Vector2(visibleRange[0], visibleRange[1]);
 
-    // 濡傛灉鏈?elementName锛屽皢鍥炬爣鎸傚埌 GLTF 妯″瀷瀛愯妭鐐逛笂锛堜綅缃敱鐖惰妭鐐瑰喅瀹氾級
+    // 如果有 elementName，将图标挂到 GLTF 模型子节点上（位置由父节点决定）
     if (elementName && elementChildrenIndex !== undefined) {
       const el = this._gltfElements?.[elementName];
       console.log('[GaeaApp] addScreenIcon element:', elementName, 'el:', !!el, 'childrenIndex:', elementChildrenIndex);
@@ -1778,7 +1832,8 @@ export class GaeaApp {
           return screen;
         }
       }
-      // 瀛愯妭鐐规湭鎵惧埌锛屽洖閫€鍒扮粷瀵逛綅缃?      console.warn('[GaeaApp] elementName/childIndex 鏈壘鍒帮紝浣跨敤 position 鍥為€€:', elementName, elementChildrenIndex);
+      // 子节点未找到，回退到绝对位置
+      console.warn('[GaeaApp] elementName/childIndex 未找到，使用 position 回退:', elementName, elementChildrenIndex);
     }
 
     screen.GeographyPosition = new Gaea.Vector3(position.x, position.y, position.z || 0);
@@ -1789,7 +1844,7 @@ export class GaeaApp {
     return screen;
   }
 
-  /** 鏍规嵁鍏ㄥ眬鍥炬爣鍙鎬х姸鎬侊紙_markersVisible锛夊簲鐢ㄥ崟涓浘鏍囨樉闅?*/
+  /** 根据全局图标可见性状态（_markersVisible）应用单个图标显隐 */
   _applyMarkerVisibility(screenItem) {
     if (this._markersVisible) return;
     screenItem.element.ForceSetVisible(false);
@@ -1798,28 +1853,30 @@ export class GaeaApp {
     if (el) el.style.display = 'none';
   }
 
-  /** 璁板綍褰撳墠瑙嗚锛岃繑鍥?URI 瀛楃涓?*/
+  /** 记录当前视角，返回 URI 字符串 */
   favorite() {
     return Gaea.GaeaCamera.ConvertBy(Gaea.World.Instance.DefaultCamera).Favorite();
   }
 
-  /** 瀹氫綅鍒板凡璁板綍鐨勮瑙?URI */
+  /** 定位到已记录的视角 URI */
   favoritePosition(uri) {
     Gaea.World.Instance.DefaultCamera.GotoFavorite(uri);
   }
 
   /**
-   * 娣诲姞鐐逛綅鏍囪鍒?3D 鍦板浘
+   * 添加点位标记到 3D 地图
    * @param {Object} opts
-   * @param {string} opts.name - 鍞竴鏍囪瘑鍚?   * @param {string} [opts.text] - 鏄剧ず鏂囨湰
-   * @param {number} opts.lat - 绾害
-   * @param {number} opts.lng - 缁忓害
-   * @param {number} [opts.z=0] - 楂樺害
-   * @param {string} [opts.imgUrl] - 鍥炬爣鍦板潃
-   * @param {'textImage'|'styled'|'imageOnly'} [opts.method='textImage'] - 鏄剧ず鏍峰紡
-   * @param {Array<number>} [opts.offset=[0,0]] - 灞忓箷鍋忕Щ
-   * @param {Function} [opts.onClick] - 鐐瑰嚮鍥炶皟
-   * @param {string} [opts.category] - 鍒嗙被鏍囪瘑锛堢敤浜庡浘灞傛爲鏄鹃殣鎺у埗锛?   * @returns {Gaea.ScreenGUIElement} screen 鍏冪礌
+   * @param {string} opts.name - 唯一标识名
+   * @param {string} [opts.text] - 显示文本
+   * @param {number} opts.lat - 纬度
+   * @param {number} opts.lng - 经度
+   * @param {number} [opts.z=0] - 高度
+   * @param {string} [opts.imgUrl] - 图标地址
+   * @param {'textImage'|'styled'|'imageOnly'} [opts.method='textImage'] - 显示样式
+   * @param {Array<number>} [opts.offset=[0,0]] - 屏幕偏移
+   * @param {Function} [opts.onClick] - 点击回调
+   * @param {string} [opts.category] - 分类标识（用于图层树显隐控制）
+   * @returns {Gaea.ScreenGUIElement} screen 元素
    */
   addMarker({ name, text, lat, lng, z = 0, imgUrl, method = 'textImage', offset = [0, 0], onClick, category } = {}) {
     return this.addScreenIcon({
@@ -1830,7 +1887,7 @@ export class GaeaApp {
       method,
       offset,
       onClick: (clickedName, data) => {
-        // 娲惧彂鍏ㄥ眬鑷畾涔変簨浠讹紝鐖剁粍浠跺彲閫氳繃 document.addEventListener 鐩戝惉
+        // 派发全局自定义事件，父组件可通过 document.addEventListener 监听
         document.dispatchEvent(new CustomEvent('gaea-marker-click', {
           detail: { name: clickedName, text: data.text, position: data.position, category },
           bubbles: true
@@ -1842,7 +1899,7 @@ export class GaeaApp {
     })
   }
 
-  // ---- 寮曟搸鍔ㄧ敾鏂规硶 ----
+  // ---- 引擎动画方法 ----
 
   hiddenScreenWithClass(className) {
     const els = document.querySelectorAll(className);
@@ -1883,15 +1940,15 @@ export class GaeaApp {
     if (details.length) {
       details.forEach(item => { html += `<div class="daba-tooltip-item">${item}</div>`; });
     } else {
-      html = '<div class="daba-tooltip-item">鏆傛棤璇︽儏</div>';
+      html = '<div class="daba-tooltip-item">暂无详情</div>';
     }
     return `<div class="daba-tooltip-title">${name} - ${label}</div>${html}`;
   }
 
-  /** 鏂潰鏁版嵁鐐瑰嚮澶勭悊 */
+  /** 断面数据点击处理 */
   _onSecDataClick(name, data) {
     const sectionModel = this._gltfElements?.[name];
-    const tourModelName = name + '娓歌妯″瀷';
+    const tourModelName = name + '游览模型';
     const tourModel = this._gltfElements?.[tourModelName];
 
     document.dispatchEvent(new CustomEvent('gaea-icon-click', {
@@ -1904,7 +1961,8 @@ export class GaeaApp {
       return;
     }
 
-    // 棣栨鐐瑰嚮鏂潰鏃舵敞鍏ユ爣绛炬牱寮?    if (!document.getElementById('gaea-sec-styles')) {
+    // 首次点击断面时注入标签样式
+    if (!document.getElementById('gaea-sec-styles')) {
       const style = document.createElement('style');
       style.id = 'gaea-sec-styles';
       style.textContent = `
@@ -1932,17 +1990,20 @@ export class GaeaApp {
       this.updateElementPosition({ element: tourModel, position: gltfCfg.position, rotate: gltfCfg.rotate, size: gltfCfg.size });
     }
 
-    // this.RemoveVts({ vtsName: '娌挎郸娴峰宸ョ▼鑼冨洿绾? });
-    // 閫氱煡闅愯棌鍥惧眰鏍?    document.dispatchEvent(new CustomEvent('gaea-hide-layertree', { bubbles: true }));
+    // this.RemoveVts({ vtsName: '沿浦海塘工程范围线' });
+    // 通知隐藏图层树
+    document.dispatchEvent(new CustomEvent('gaea-hide-layertree', { bubbles: true }));
     this.FlyOver(() => {
       this.hiddenScreenWithClass('.waterLevel');
       this.hiddenScreenWithClass('.damScreen');
 
       this.gltfPlayer(sectionModel, { x: 0, y: 44, z: 0 }, 1).then(() => {
-        // 璁板綍宸插崌璧风殑鏂潰妯″瀷锛屼緵閲嶇疆鏃剁缉鍥?        this._raisedSection = sectionModel;
+        // 记录已升起的断面模型，供重置时缩回
+        this._raisedSection = sectionModel;
         if (tourModel) {
           this.lockedModesSwitch(true, tourModel, [-10, 50, 0], [50, 50]);
-          // 閿佸畾妯″瀷鍚庡啀閫氱煡鏄剧ず鏂潰婊氬姩鏉?          document.dispatchEvent(new CustomEvent('gaea-sec-locked', { detail: { name }, bubbles: true }));
+          // 锁定模型后再通知显示断面滚动条
+          document.dispatchEvent(new CustomEvent('gaea-sec-locked', { detail: { name }, bubbles: true }));
         }
 
         if (!this._secIsClickArr.includes(name)) {
@@ -1960,9 +2021,9 @@ export class GaeaApp {
             const entryLabel = typeof value === 'object' && value.label ? value.label : String(value);
             let cls, imgUrl, offset;
             if (hasNumber(entryLabel)) {
-              cls = 'waterLevel'; offset = [0, -54]; imgUrl = '/image/labelImg/姘翠綅.png';
+              cls = 'waterLevel'; offset = [0, -54]; imgUrl = '/image/labelImg/水位.png';
             } else {
-              cls = 'damScreen'; offset = [0, -19]; imgUrl = '/image/labelImg/宸﹁竟.png';
+              cls = 'damScreen'; offset = [0, -19]; imgUrl = '/image/labelImg/左边.png';
             }
              const divid = this._createSecLabel(entryLabel, cls, imgUrl, {
                onMouseEnter: (e) => {
@@ -1995,12 +2056,12 @@ export class GaeaApp {
         this.hiddenScreenWithClass('.gaea-iconscreen');
         this.hiddenScreenWithClass('.gaea-locationLineStyle');
         this.hiddenScreenWithClass('.gaea-iconGif');
-      }).catch(err => console.warn('[GaeaApp] 鏂潰鍔ㄧ敾澶辫触:', err.message));
+      }).catch(err => console.warn('[GaeaApp] 断面动画失败:', err.message));
     });
     this.SetPosition(data.favorite || `${data.position.x},${data.position.y},${data.position.z},${data.position.z + 500},0,0`);
   }
 
-  /** 椋炶缁撴潫鍥炶皟 */
+  /** 飞行结束回调 */
   FlyOver(callback) {
     const camera = Gaea.World.Instance.DefaultCamera;
     camera.OnFlyOverCallBack(() => {
@@ -2008,15 +2069,15 @@ export class GaeaApp {
     });
   }
 
-  /** GLTF 妯″瀷骞崇Щ鍔ㄧ敾 */
+  /** GLTF 模型平移动画 */
   gltfPlayer = (element, targetPos, time = 5) => {
     return new Promise((resolve, reject) => {
       if (!element || !element.TranslateObjectLocal) {
-        reject(new Error('鏃犳晥鐨勫厓绱犲璞★細缂哄皯 TranslateObjectLocal 鏂规硶'));
+        reject(new Error('无效的元素对象：缺少 TranslateObjectLocal 方法'));
         return;
       }
       if (!targetPos || typeof targetPos.x !== 'number' || typeof targetPos.y !== 'number' || typeof targetPos.z !== 'number') {
-        reject(new Error('鏃犳晥鐨勭洰鏍囦綅缃細蹇呴』鍖呭惈鏁板瓧绫诲瀷鐨?x/y/z 灞炴€?));
+        reject(new Error('无效的目标位置：必须包含数字类型的 x/y/z 属性'));
         return;
       }
       const frameRate = 60;
@@ -2053,12 +2114,12 @@ export class GaeaApp {
         };
         moveStep();
       } catch (error) {
-        reject(new Error(`鍔ㄧ敾鎵ц鍑洪敊锛?{error.message}`));
+        reject(new Error(`动画执行出错：${error.message}`));
       }
     });
   };
 
-  /** 閿佸畾/瑙ｉ攣鐩告満瑙嗚鍒版ā鍨?*/
+  /** 锁定/解锁相机视角到模型 */
   lockedModesSwitch = (mode, element, Offset3D = [0, 1.1, 0], MinMaxZoom3D = [1.1, 1.1], LockEye = false) => {
     if (mode) {
       const ev = new Gaea.EntityView();
@@ -2072,7 +2133,8 @@ export class GaeaApp {
       return ev;
     } else {
       Gaea.World.Instance.CameraController.LockedEntity = null;
-      // 瑙ｉ攣鏃舵仮澶嶉潪鏂潰鍥炬爣鐨勮嚜鍔ㄥ彲瑙?      this._screenIconList.forEach(item => {
+      // 解锁时恢复非断面图标的自动可见
+      this._screenIconList.forEach(item => {
         if (!item.type && this._markersVisible) {
           item.element.UseAutoVisible();
           item.element.EnablePick = true;
@@ -2081,7 +2143,7 @@ export class GaeaApp {
     }
   };
 
-  /** 淇敼妯″瀷浣嶇疆/鏃嬭浆 */
+  /** 修改模型位置/旋转 */
   updateElementPosition = ({ element, position, rotate, size }) => {
     element.GeographyPosition = new Gaea.Vector3(position.x, position.y, position.z);
     if (rotate?.length > 0) {
@@ -2089,14 +2151,14 @@ export class GaeaApp {
     }
   };
 
-  /** 绉婚櫎 VTS 鐭㈤噺鍥惧眰 */
+  /** 移除 VTS 矢量图层 */
   RemoveVts = ({ vtsName }) => {
     Gaea.World.Instance.DefaultVectorPyramidTileSet.RemoveImageStore(
       Gaea.WMTSVectorStore.ConvertBy(Gaea.World.Instance.DefaultVectorPyramidTileSet.GetImageStore(vtsName))
     );
   };
 
-  /** GLTF 杞ㄨ抗鍔ㄧ敾鎾斁锛堢敤浜庢柇闈㈡父瑙堬級 */
+  /** GLTF 轨迹动画播放（用于断面游览） */
   gtlfAnimationPlayer = (trackList, animationConfig, element) => {
     element.GeographyPosition = new Gaea.Vector3(trackList[0].x, trackList[0].y, trackList[0].z);
     const { animationName, animationType, animationPlaySpeed } = animationConfig;
@@ -2123,7 +2185,7 @@ export class GaeaApp {
     return animationPlayer;
   };
 
-  /** 鐜粫椋炶 */
+  /** 环绕飞行 */
   FlyAroundPoint = (element, targetAngle, time, callbacks = {}) => {
     const { onStart = () => {}, onUpdate = () => {}, onComplete = () => {} } = callbacks;
     if (!targetAngle || !element) { onComplete(null); return; }
@@ -2145,7 +2207,7 @@ export class GaeaApp {
     tween.start();
   };
 
-  /** 鍚姩 TWEEN 鏇存柊寰幆锛堥娆¤皟鐢ㄦ椂鍚姩锛?*/
+  /** 启动 TWEEN 更新循环（首次调用时启动） */
   _startTweenLoop() {
     if (this._tweenLoopStarted) return;
     this._tweenLoopStarted = true;
@@ -2156,7 +2218,7 @@ export class GaeaApp {
     requestAnimationFrame(animate);
   }
 
-  /** 鎻愬彇绱㈠紩鍖洪棿鐨?pos 鏁扮粍锛岃捣濮?鐩爣鏃跺弽搴?*/
+  /** 提取索引区间的 pos 数组，起始>目标时反序 */
   getPosArrayBetweenIndexes(list, currentIdx, targetIdx) {
     if (!Array.isArray(list) || currentIdx < 0 || targetIdx < 0 ||
       currentIdx >= list.length || targetIdx >= list.length) {
@@ -2170,20 +2232,22 @@ export class GaeaApp {
     return result;
   }
 
-  /** 瀹ゅ唴娓歌鍒濆鍖栵細闅愯棌鍥炬爣 + 閿佸畾娓歌妯″瀷 */
+  /** 室内游览初始化：隐藏图标 + 锁定游览模型 */
   initModelTour(modelName, direction = [-0.5, 0, 0]) {
-    // 闅愯棌鎵€鏈夊睆骞曞浘鏍?    this._screenIconList.forEach(item => {
+    // 隐藏所有屏幕图标
+    this._screenIconList.forEach(item => {
       item.element.ForceSetVisible(false);
       item.element.EnablePick = false;
     });
     this.hiddenScreenWithClass('.gaea-locationLineStyle');
     this.hiddenScreenWithClass('.gaea-iconscreen');
     this.hiddenScreenWithClass('.gaea-iconGif');
-    // 闅愯棌鍥惧眰鏍?    document.dispatchEvent(new CustomEvent('gaea-hide-layertree', { bubbles: true }));
+    // 隐藏图层树
+    document.dispatchEvent(new CustomEvent('gaea-hide-layertree', { bubbles: true }));
 
-    const tourModel = this._gltfElements?.[`${modelName}娓歌妯″瀷`];
+    const tourModel = this._gltfElements?.[`${modelName}游览模型`];
     if (!tourModel) {
-      console.warn('[GaeaApp] 娓歌妯″瀷鏈壘鍒?', modelName);
+      console.warn('[GaeaApp] 游览模型未找到:', modelName);
       return null;
     }
     this._currentTourModel = tourModel;
@@ -2192,7 +2256,7 @@ export class GaeaApp {
     return tourModel;
   }
 
-  /** 瀹ゅ唴娓歌璺緞鑺傜偣鐐瑰嚮锛氭部璺緞绉诲姩 + 杞ご */
+  /** 室内游览路径节点点击：沿路径移动 + 转头 */
   tourNodeClick(positionList, index) {
     const tourModel = this._currentTourModel;
     if (!tourModel) return;
@@ -2201,7 +2265,7 @@ export class GaeaApp {
     const currentPosList = this.getPosArrayBetweenIndexes(positionList, currentIdx, index);
     const time = 2 * (currentPosList.length - 1);
     this.gtlfAnimationPlayer(currentPosList, {
-      animationName: `鍔ㄧ敾${index}`, animationType: 'time', animationPlaySpeed: time, animationLoop: false,
+      animationName: `动画${index}`, animationType: 'time', animationPlaySpeed: time, animationLoop: false,
     }, tourModel);
     const status = currentIdx > index ? 'out' : 'in';
     this._currentTourIndexPos = index;
@@ -2222,7 +2286,7 @@ export class GaeaApp {
     }, time * 1000);
   }
 
-  /** 閫氳繃 URL 鍔犺浇璧勬簮 */
+  /** 通过 URL 加载资源 */
   LoadResourceFromUrl = (url, name) => {
     return new Promise((resolve, reject) => {
       Gaea.GaeaResourceLoader.Instance.LoadResourceFromUrl1(url, name, (code, msg) => {
@@ -2232,20 +2296,22 @@ export class GaeaApp {
     });
   };
 
-  /** 娣诲姞鍗曚釜鐐瑰浘鏍?*/
+  /** 添加单个点图标 */
   addPointIcon = async (options = {}) => {
     const { lat, lng, alt = 0, iconSize = 500, enablePick = true } = options;
     if (lat == null || lng == null) {
-      console.error('addPointIcon: lat 鍜?lng 涓嶈兘涓虹┖');
+      console.error('addPointIcon: lat 和 lng 不能为空');
       return null;
     }
-    // 璧勬簮鍚嶅甫鐗堟湰鍙凤細npm 鍖呮棭鏈熼檮甯︾殑 1111.res 涓嶅畬鏁达紝浼氳寮曟搸鎸夊悕缂撳瓨杩涙寔涔呭寲鏂囦欢绯荤粺锛?    // 鎹㈡柊鍚嶅彲寮哄埗閲嶆柊涓嬭浇娉ㄥ唽锛岄伩鍏嶅懡涓棫鐨勬棤鏁堢紦瀛?    const resName = 'pointIconV3.res';
+    // 资源名带版本号：npm 包早期附带的 1111.res 不完整，会被引擎按名缓存进持久化文件系统，
+    // 换新名可强制重新下载注册，避免命中旧的无效缓存
+    const resName = 'pointIconV3.res';
     if (!this._pointIconLoaded) {
       const resUrl = `${this.config.serveLocal}/1111.res?v=3`;
       try {
         await this.LoadResourceFromUrl(resUrl, resName);
       } catch (e) {
-        console.error('addPointIcon: 鍔犺浇 .res 鍥炬爣鏂囦欢澶辫触');
+        console.error('addPointIcon: 加载 .res 图标文件失败');
         return null;
       }
       this._pointIconLoaded = true;
@@ -2269,7 +2335,7 @@ export class GaeaApp {
     return element;
   };
 
-  /** 娓呴櫎鎵€鏈夌偣鍥炬爣 */
+  /** 清除所有点图标 */
   clearPointIcons = () => {
     if (this._pointIconElements && this._pointIconElements.length > 0) {
       this._pointIconElements.forEach
@@ -2279,17 +2345,17 @@ export class GaeaApp {
     this.clearTyphoonRoute();
   };
 
-  /** 鍔犺浇鍙伴璺嚎锛氬垱寤哄浘鏍囧苟娌胯矾寰勮繍鍔紙鐐逛綅鏁扮粍 [{lat,lng,alt}]锛?*/
+  /** 加载台风路线：创建图标并沿路径运动（点位数组 [{lat,lng,alt}]） */
   addTyphoonRoute = async (pointList = [], options = {}) => {
     const { animationPlaySpeed = 20, animationLoop = true } = options;
     this.clearTyphoonRoute();
     if (!pointList || pointList.length < 2) {
-      console.warn('addTyphoonRoute: 鑷冲皯闇€瑕?涓偣浣?);
+      console.warn('addTyphoonRoute: 至少需要2个点位');
       return;
     }
     const element = await this.addPointIcon({ lat: pointList[0].lat, lng: pointList[0].lng, alt: pointList[0].alt || 0 });
     if (!element) {
-      console.error('addTyphoonRoute: 鍒涘缓鍥炬爣澶辫触');
+      console.error('addTyphoonRoute: 创建图标失败');
       return;
     }
     if (this._pointIconElements) {
@@ -2339,7 +2405,7 @@ export class GaeaApp {
     return { element };
   };
 
-  /** 娓呴櫎鍙伴璺嚎 */
+  /** 清除台风路线 */
   clearTyphoonRoute = () => {
     this._typhoonCancelled = true;
     if (this._typhoonTimer) { clearTimeout(this._typhoonTimer); this._typhoonTimer = null; }
@@ -2349,42 +2415,44 @@ export class GaeaApp {
     }
   };
 
-  /** 鏄剧ず鎵€鏈夊睆骞曟爣璁?*/
+  /** 显示所有屏幕标记 */
   showAllMarkers = () => {
     this._markersVisible = true;
     this._screenIconList.forEach(item => {
-      // 璺宠繃琚殣钘忓垎绫荤殑鏍囪
+      // 跳过被隐藏分类的标记
       if (this._hiddenCategories.has(item.category)) return
       item.element.UseAutoVisible()
       item.element.EnablePick = true
-      // 鍚屾鏄剧ず DOM 鍏冪礌
+      // 同步显示 DOM 元素
       const el = document.getElementById(item.element.DivID)
       if (el) el.style.display = ''
     })
   };
 
-  /** 闅愯棌鎵€鏈夊睆骞曟爣璁?*/
+  /** 隐藏所有屏幕标记 */
   hideAllMarkers = () => {
     this._markersVisible = false;
     this._screenIconList.forEach(item => {
       item.element.ForceSetVisible(false)
       item.element.EnablePick = false
-      // 鍚屾闅愯棌 DOM 鍏冪礌
+      // 同步隐藏 DOM 元素
       const el = document.getElementById(item.element.DivID)
       if (el) el.style.display = 'none'
     })
   };
 
-  // ---- 姘撮潰鍔犺浇 ----
+  // ---- 水面加载 ----
 
   /**
-   * 鍔犺浇姘撮潰
+   * 加载水面
    * @param {Object} opts
-   * @param {string} opts.gltfUrl - GLTF 妯″瀷璺緞
-   * @param {Object} opts.Position - { x: 绾害, y: 缁忓害, z: 楂樼▼ }
-   * @param {Array<number>} opts.rotate - [tilt, heading, bank] 鏃嬭浆瑙掑害
-   * @param {Array<number>} opts.scale - [sx, sy, sz] 缂╂斁
-   * @param {Array<number>} [opts.colorDeep=[0,157,187]] - 娣辨按鍖洪鑹?[r, g, b]锛?-255锛?   * @param {number} [opts.flowSpeed=0.1] - 娴侀€?   */
+   * @param {string} opts.gltfUrl - GLTF 模型路径
+   * @param {Object} opts.Position - { x: 纬度, y: 经度, z: 高程 }
+   * @param {Array<number>} opts.rotate - [tilt, heading, bank] 旋转角度
+   * @param {Array<number>} opts.scale - [sx, sy, sz] 缩放
+   * @param {Array<number>} [opts.colorDeep=[0,157,187]] - 深水区颜色 [r, g, b]（0-255）
+   * @param {number} [opts.flowSpeed=0.1] - 流速
+   */
   addWaterHandle = async ({
     gltfUrl, Position, rotate, scale,
     colorDeep = [0, 157, 187],
@@ -2414,22 +2482,26 @@ export class GaeaApp {
       Gaea.World.Instance.SetMtlColor(material, 'color_shallow', new Gaea.Color(0 / 255, 157 / 255, 187 / 255, 1))
       Gaea.World.Instance.SetMtlColor(material, 'color_deep', new Gaea.Color(colorDeep[0] / 255, colorDeep[1] / 255, colorDeep[2] / 255, 1))
       Gaea.World.Instance.SetMtlFloat(material, 'transparency_clarity', 0)
-      Gaea.World.Instance.SetMtlFloat(material, "transparency_refraction", 0); // 鎶樺皠搴?      Gaea.World.Instance.SetMtlFloat(material, "foam_amount", 0.8); // 姘旀场澶у皬
+      Gaea.World.Instance.SetMtlFloat(material, "transparency_refraction", 0); // 折射度
+      Gaea.World.Instance.SetMtlFloat(material, "foam_amount", 0.8); // 气泡大小
     })
 
     Gaea.World.Instance.RenderableObjectList.AddLast(element)
     return element
   };
 
-  // ---- 寮€闂ㄥ姩鐢?----
+  // ---- 开门动画 ----
 
   /**
-   * 妯″瀷缂撳姩鍔ㄧ敾锛堢缉鏀?浣嶇Щ/鏃嬭浆锛?   * @param {Object} element - GLTF 鍏冪礌
-   * @param {Object} Scale - 鐩爣缂╂斁 { x, y, z }
-   * @param {Object} Position - 鐩爣浣嶇疆 { x, y, z }
-   * @param {Object} translation - 妯″瀷鐩稿浣嶇Щ { x, y, z }
-   * @param {number} time - 鍔ㄧ敾鏃堕棿锛坢s锛?   * @param {Object} Door - 闂ㄦ棆杞搴?{ x, y, z }
-   * @param {number} floor - 闂ㄥ湪妯″瀷鏍戜腑鐨勫眰绾х储寮?   */
+   * 模型缓动动画（缩放/位移/旋转）
+   * @param {Object} element - GLTF 元素
+   * @param {Object} Scale - 目标缩放 { x, y, z }
+   * @param {Object} Position - 目标位置 { x, y, z }
+   * @param {Object} translation - 模型相对位移 { x, y, z }
+   * @param {number} time - 动画时间（ms）
+   * @param {Object} Door - 门旋转角度 { x, y, z }
+   * @param {number} floor - 门在模型树中的层级索引
+   */
   tweentest = (element, Scale = {}, Position = {}, translation = {}, time, Door = {}, floor = 0) => {
     const { Tween, Easing } = window.TWEEN
 
@@ -2489,14 +2561,15 @@ export class GaeaApp {
     }
   };
 
-  // ---- 妯″瀷鍐呯疆鍔ㄧ敾 ----
+  // ---- 模型内置动画 ----
 
   /**
-   * 鎵ц妯″瀷鍐呯疆鍔ㄧ敾锛堝寮€闂?鍏抽椄鍔ㄧ敾锛?   * @param {Object} opts
-   * @param {string} opts.animationPath - 鍔ㄧ敾璺緞锛屽 '娌挎郸姘撮椄/AnimationPlayer'
-   * @param {string} opts.animationName - 鍔ㄧ敾鍚嶇О锛屽 '寮€闂?
-   * @param {number} [opts.speed=1.0] - 鍔ㄧ敾閫熷害
-   * @param {boolean} [opts.isReversePlay=false] - 鏄惁鍙嶅悜鎾斁
+   * 执行模型内置动画（如开闸/关闸动画）
+   * @param {Object} opts
+   * @param {string} opts.animationPath - 动画路径，如 '沿浦水闸/AnimationPlayer'
+   * @param {string} opts.animationName - 动画名称，如 '开闸'
+   * @param {number} [opts.speed=1.0] - 动画速度
+   * @param {boolean} [opts.isReversePlay=false] - 是否反向播放
    */
   executeModelAnimation = ({ animationPath, animationName, speed = 1.0, isReversePlay = false }) => {
     const node = Gaea.World.Instance.GetNode(animationPath)