@yangyongtao/gaea 1.1.9 → 1.1.11

package/src/GaeaMethods.js

@@ -9,9 +9,106 @@
  *   await app.ready;  // 可选，等待初始化完成
  */
 
+import { Group, Tween, Easing } from '@tweenjs/tween.js';
+window.TWEEN = { Group, Tween, Easing };
+
 import Gaea from '../public/index.js';
 
 
+// ==================== Loading 动画 ====================
+
+(function injectLoadingStyle() {
+  if (document.getElementById('gaea-loading-style')) return;
+  const style = document.createElement('style');
+  style.id = 'gaea-loading-style';
+  style.textContent = `
+    #gaea-loading-overlay {
+      position: fixed; top: 0; left: 0; width: 100vw; height: 100vh;
+      background: #0a1628; z-index: 99999;
+      display: flex; flex-direction: column; align-items: center; justify-content: center;
+      font-family: 'Microsoft YaHei', sans-serif; transition: opacity 0.5s;
+    }
+    #gaea-loading-overlay .gaea-spinner {
+      width: 48px; height: 48px; border: 4px solid rgba(255,255,255,0.2);
+      border-top-color: #3b82f6; border-radius: 50%;
+      animation: gaea-spin 0.8s linear infinite;
+    }
+    @keyframes gaea-spin { to { transform: rotate(360deg); } }
+    #gaea-loading-overlay .gaea-text {
+      color: rgba(255,255,255,0.7); margin-top: 20px; font-size: 14px; letter-spacing: 2px;
+    }
+    #gaea-loading-overlay.gaea-fadeout { opacity: 0; pointer-events: none; }
+    #gaea-reset-btn {
+      position: fixed; top: 16px; right: 16px; z-index: 99990;
+      width: 36px; height: 36px; border-radius: 6px; border: none;
+      background: rgba(0,0,0,0.5); color: #fff; cursor: pointer;
+      font-size: 16px; display: flex; align-items: center; justify-content: center;
+      transition: background 0.2s; backdrop-filter: blur(4px);
+    }
+    #gaea-reset-btn:hover { background: rgba(0,0,0,0.7); }
+    /* 屏幕图标样式（对齐 ht_3dview） */
+    .gaea-locationLineStyle {
+      position: absolute; overflow: hidden; z-index: 999; pointer-events: auto;
+      user-select: none; -webkit-user-select: none;
+    }
+    .gaea-locationLineStyle .text-wrapper {
+      display: flex; justify-content: center; min-height: 1.5rem;
+      font-size: 0.8rem; background: rgba(29,32,45,0.85);
+      border-radius: 2px; padding: 2px 6px; margin-bottom: 4px; white-space: nowrap;
+    }
+    .gaea-locationLineStyle .text-content {
+      color: #fff; text-align: center; line-height: 1.2rem;
+    }
+    .gaea-locationLineStyle .image-wrapper {
+      display: flex; justify-content: center;
+    }
+    .gaea-locationLineStyle .image-wrapper img {
+      width: 48px; height: 48px; object-fit: contain; display: block;
+    }
+    .gaea-iconscreen {
+      position: absolute; overflow: hidden; width: 169px; height: 55px;
+      user-select: none; -webkit-user-select: none; z-index: 999; pointer-events: auto;
+    }
+    .gaea-iconscreen img {
+      position: absolute; width: 100%; height: 100%;
+      object-fit: cover; z-index: 1;
+    }
+    .gaea-iconscreen .content {
+      display: flex; position: relative; width: 100%; min-height: 100%;
+      z-index: 1; align-items: center;
+    }
+    .gaea-iconscreen .box { width: 35px; height: 100%; }
+    .gaea-iconscreen .text {
+      flex: 1; height: 100%; display: flex; align-items: center; justify-content: center;
+      color: #fff; font-size: 16px; text-align: center; white-space: nowrap;
+    }
+    .gaea-iconGif {
+      position: absolute; overflow: hidden; width: 48px; height: 48px;
+      user-select: none; -webkit-user-select: none; z-index: 999; pointer-events: auto;
+    }
+    .gaea-iconGif img {
+      width: 100%; height: 100%; object-fit: contain; display: block;
+    }
+  `;
+  document.head.appendChild(style);
+})();
+
+function showLoading() {
+  if (document.getElementById('gaea-loading-overlay')) return;
+  const overlay = document.createElement('div');
+  overlay.id = 'gaea-loading-overlay';
+  overlay.innerHTML = '<div class="gaea-spinner"></div><div class="gaea-text">GAEA 引擎加载中...</div>';
+  document.body.appendChild(overlay);
+}
+
+function hideLoading() {
+  const overlay = document.getElementById('gaea-loading-overlay');
+  if (!overlay) return;
+  overlay.classList.add('gaea-fadeout');
+  setTimeout(() => overlay.remove(), 600);
+}
+
+
 // ==================== 配置 ====================
 
 const defaultConfig = {
@@ -23,21 +120,141 @@ const defaultConfig = {
   canvasResizePolicy: 2,
   experimentalVK: false,
   focusCanvas: true,
-  /** 是否使用天地图（true 时跳过 getAllServe，直接加载天地图影像） */
-  useTianditu: false,
-  /** 天地图 token */
+  /**
+   * 服务模式：
+   * 'platform' - 服务平台：影像走 serveUrl 的 WMTS，并加载地形、贴地线
+   * 'online'   - 在线：仅加载天地图影像，不加载地形和贴地线
+   */
+  serviceMode: 'platform',
+  /** 天地图 token（在线模式使用） */
   tiandituToken: '63201cfd7df1e1bff7d88bb8baa32151',
   /** 天地图最小/最大层级 */
   tiandituLevelRange: [0, 18],
-  /** 默认加载的影像图层（useTianditu=false 时生效） */
+  /** 默认加载的影像图层（服务平台模式生效） */
   defaultLayers: [
     { layerName: 'earthland', forMat: 'image/png', min: 0, max: 18, transparency: 0.3 },
     { layerName: '苍南L19',  forMat: 'image/png', min: 5, max: 17 },
   ],
+  /** 默认加载的地形服务（走 serveUrl，url 为相对路径或完整地址；空数组则不加载） */
+  defaultTerrains: [
+    { name: '苍南县地形', url: 'htc/service/tms/1.0.0/苍南县地形@EPSG%3A4326@terrain/' },
+  ],
+  /** 默认加载的贴地线（矢量线服务，依赖 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 },
+  ],
   /** 默认相机视角 */
   defaultCameraPosition: '27.3680928977018,120.414139621887,0,109379.690132486,0,0',
   /** 引擎加载进度回调 */
   onProgress: null,
+  /** DataHub API 地址（图层树数据接口），为空则只用默认数据 */
+  dataHubApiUrl: '',
+  /** 图层树分类数据（默认数据，接口数据会合并进来） */
+  layerCategories: [
+    { key: 'seawall',             text: '海塘',       visible: true,  children: [
+      { text: '沿浦海塘',   position: { x: 27.220705, y: 120.457998, z: 20 } },
+      { text: '霞关海塘',   position: { x: 27.171059, y: 120.467901, z: 20 } },
+      { text: '三茆海塘',   position: { x: 27.193284, y: 120.464411, z: 20 } },
+      { text: '大渔海塘',   position: { x: 27.39027,  y: 120.599554, z: 20 } },
+      { text: '信智海塘',   position: { x: 27.300806, y: 120.544077, z: 20 } },
+      { text: '下在海塘',   position: { x: 27.215789, y: 120.445849, z: 10 } },
+      { text: '木林海塘',   position: { x: 27.193183, y: 120.424486, z: 20 } },
+      { text: '雾城海塘',   position: { x: 27.27682,  y: 120.518917, z: 20 } },
+      { text: '渔岙海塘',   position: { x: 27.403744, y: 120.557879, z: 20 } },
+      { text: '流岐岙海塘', 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: '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: [
+      { text: 'YPDP0+600', position: { x: 27.217692, y: 120.461823, z: 30 },
+        indexList: {
+          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: ['成分: 砖石与黏土混合', '厚度: 约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'] },
+        },
+        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: ['成分: 砖石与黏土混合', '厚度: 约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: '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  } },
+    ]},
+  ],
 };
 
 const _config = { ...defaultConfig };
@@ -53,8 +270,42 @@ export class GaeaApp {
     this._options = options;
     this.layers = [];
     this.tLayers = [];
+    this.layerCategories = this.config.layerCategories || [];
+    this._screenIconList = [];
+    this._secIsClickArr = [];
+    this._secScreenIconKeyValue = {};
+    this.tweenGroup = new TWEEN.Group();
+    this._tourConfig = {
+      '沿浦水闸': { 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: '位置点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: '位置点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: [] },
+    };
+    console.log('[GaeaApp] constructor layerCategories:', this.layerCategories.length);
     window.Gaea = Gaea;
 
+    // 显示 loading
+    showLoading();
+
     // 自动启动初始化，catch 防止未处理的 Promise rejection
     this.ready = this._autoInit().catch(err => {
       console.error('[GaeaApp] 初始化失败:', err);
@@ -82,6 +333,48 @@ export class GaeaApp {
 
     // 4. 加载默认图层
     await this._initLayers();
+    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' },
+    ];
+    for (const model of models) {
+      try {
+        const node = Gaea.World.Instance.GetNode(model.nodeName);
+        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]);
+        console.log(`[GaeaApp] 模型 ${model.nodeName} 位置调整完成`);
+      } catch (e) {
+        console.warn(`[GaeaApp] 调整模型 ${model.nodeName} 失败:`, e.message);
+      }
+    }
+    console.log('[GaeaApp] 所有模型位置调整完成');
+
+    // 6. 加载 GLTF 模型
+    await this._loadGltfModels();
+
+    // 7. 获取图层树数据（有接口走接口，没接口用默认）
+    await this._fetchLayerTreeData();
+
+    // 同步 layerCategories（修复数据更新未同步的问题）
+    this.layerCategories = this.config.layerCategories || [];
+    console.log('[GaeaApp] layerCategories 更新后:', this.layerCategories.length);
+
+    // 8. 初始化屏幕图标
+    this._initScreenIcons();
+
+    hideLoading();
+    this._addResetButton();
     console.log('[GaeaApp] 初始化完成');
   }
 
@@ -150,11 +443,11 @@ export class GaeaApp {
   async _initLayers() {
     const cfg = this.config;
 
-    if (cfg.useTianditu) {
-      // 天地图模式：不走 getAllServe，直接加载天地图
+    if (cfg.serviceMode === 'online') {
+      // 在线模式：仅加载天地图影像，不加载地形/贴地线
       this.addTianditu();
     } else {
-      // WMTS 服务模式
+      // 服务平台模式：WMTS 影像 + 贴地线 + 地形
       await this.getAllServe();
       const list = cfg.defaultLayers;
       if (list?.length) {
@@ -162,6 +455,10 @@ 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); }
     }
 
     const pos = cfg.defaultCameraPosition;
@@ -189,6 +486,338 @@ export class GaeaApp {
     return store;
   }
 
+  /** 添加右上角重置按钮 */
+  _addResetButton() {
+    if (document.getElementById('gaea-reset-btn')) return;
+    const btn = document.createElement('button');
+    btn.id = 'gaea-reset-btn';
+    btn.title = '重置视角';
+    btn.innerHTML = '⟳';
+    btn.onclick = () => {
+      const pos = this.config.defaultCameraPosition;
+      if (pos) this.SetPosition(pos);
+      // 解锁视角（内部会调 UseAutoVisible 恢复非断面图标）
+      this.lockedModesSwitch(false);
+      // 恢复被 hiddenScreenWithClass 隐藏的图标 DOM
+      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) {
+        const name = this._currentTourModel?.Root?.Name;
+        const cfg = this._gltfCfgMap?.[name];
+        if (cfg) {
+          this.updateElementPosition({ element: this._currentTourModel, position: cfg.position, rotate: cfg.rotate, size: cfg.size });
+        }
+        this._currentTourModel = null;
+        this._currentTourIndexPos = 0;
+      }
+      // 重置断面状态
+      this._secIsClickArr = [];
+      this._secScreenIconKeyValue = {};
+      // 隐藏断面标签
+      this._screenIconList.forEach(item => {
+        if (item.type === 'dabaSec') {
+          item.element.ForceSetVisible(false);
+          item.element.EnablePick = false;
+        }
+      });
+      document.querySelectorAll('.waterLevel, .damScreen').forEach(el => el.style.display = 'none');
+      // 通知 SecTourView 隐藏
+      document.dispatchEvent(new CustomEvent('gaea-reset-view', { bubbles: true }));
+    };
+    document.body.appendChild(btn);
+  }
+
+  // ---- 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.222866, y: 120.453113, z: 13.25 }, rotate: [0, -30, 0], size: [1, 1, 1], show: false, url: 'gltf/沿浦水闸.gltf',      enablePick: true },
+      { 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.221816, y: 120.445182, z: 20 },    rotate: [0, 0, 0],  size: [1, 1, 1], show: false, 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.200462, y: 120.465635, z: 20 },    rotate: [0, 0, 0],  size: [1, 1, 1], show: false, url: 'gltf/联盟水闸.gltf',      enablePick: true },
+      { name: '岭尾水闸',             position: { x: 27.215762, y: 120.462235, z: 30 },    rotate: [0, -63, 0], size: [1, 1, 1], show: false, url: 'gltf/岭尾水闸.gltf', enablePick: true },
+      { name: '岭尾新闸',             position: { x: 27.210369, y: 120.458532, z: 0.5 },   rotate: [0, -153, 0], size: [1, 1, 1], show: false, url: 'gltf/岭尾新闸.gltf' },
+      { 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' },
+    ];
+
+    this._gltfCfgMap = {};
+    this._gltfElements = {};
+    for (const item of gltfList) {
+      this._gltfCfgMap[item.name] = item;
+    }
+
+    console.log('[GaeaApp] 开始加载 GLTF 模型...');
+    for (const item of gltfList) {
+      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); }
+    }
+    console.log('[GaeaApp] GLTF 模型加载完成');
+  }
+
+  AddGltf = ({
+    name, url, position, rotate, size, show = true, enablePick = false, useAbsoluteHeight = true,
+    children, billboard, clickChilrenNameArray, initFun = () => {},
+    clickCallBack = () => {}, clickChilrenCallBack = () => {},
+  }) => {
+    return new Promise(async (res) => {
+      const element = new Gaea.GLTFElement();
+      element.UseAbsoluteHeight = useAbsoluteHeight;
+      element.ResourceName = url;
+      console.log(`模型开始加载: ${name}`);
+
+      element.OnModelInit(async () => {
+        // 大坝断面模型设置 Unshaded
+        if (name.includes('YPDP0')) {
+          const n = element.Root.GetChildCount();
+          for (let i = 0; i < n; i++) {
+            const mi = Gaea.MeshInstance.ConvertBy(element.Root.GetChild(i));
+            const cnt = mi.Mesh.GetSurfaceCount();
+            for (let j = 0; j < cnt; j++) {
+              const mtl = Gaea.SpatialMaterial.ConvertBy(mi.Mesh.SurfaceGetMaterial(j));
+              mtl.FlagsUnshaded = true;
+            }
+          }
+        }
+        console.log(`模型加载完毕: ${name}`);
+        initFun();
+        element.EnablePick = enablePick;
+        Gaea.QueryServer.Instance.Enable = enablePick;
+        element.GeographyPosition = new Gaea.Vector3(position.x, position.y, position.z);
+        element.TiltHeadingBank = new Gaea.Vector3(rotate[0], rotate[1], rotate[2]);
+        element.Root.Scale = new Gaea.Vector3(size[0], size[1], size[2]);
+        element.Root.Name = name;
+        element.OnHitElement((childName, pos) => clickCallBack(childName, pos));
+        element.OnHitChildElement((childName, pos) => clickChilrenCallBack(childName));
+        element.Root.Visible = show;
+        res(element);
+      });
+
+      Gaea.World.Instance.RenderableObjectList.AddLast(element);
+      setTimeout(() => res(element), 20000);
+    });
+  };
+
+  // ---- 图层树数据 ----
+
+  async _fetchLayerTreeData() {
+    const cfg = this.config;
+    const apiUrl = cfg.dataHubApiUrl;
+    if (!apiUrl) {
+      console.log('[GaeaApp] 未配置 dataHubApiUrl，使用默认图层树数据');
+      return;
+    }
+    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] 图层树数据更新完成');
+    } catch (e) {
+      console.warn('[GaeaApp] 接口获取失败，使用默认数据:', e.message);
+    }
+  }
+
+  /** 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);
+    return {
+      'Content-Type': 'application/json',
+      'X-App-Key': appKey,
+      'X-Timestamp': String(timestamp),
+      'X-Nonce': nonce,
+      'X-Signature': signature,
+    };
+  }
+
+  /** 将API测站数据合并到默认分类中 */
+  _mergeStationData(apiData) {
+    const cfg = this.config;
+    const sttpMap = {
+      ZQ: 'hydrometricStations', RR: 'rainStations',
+      ZZ: 'riverStations',      TT: 'tideStations',
+      DD: 'reservoirs',
+    };
+    const stations = Array.isArray(apiData) ? apiData : [];
+    for (const st of stations) {
+      const catKey = sttpMap[st.sttp];
+      if (!catKey) continue;
+      const cat = cfg.layerCategories.find(c => c.key === catKey);
+      if (!cat) continue;
+      const exists = cat.children.find(c => c.text === st.stnm || c.stcd === st.stcd);
+      if (!exists) {
+        cat.children.push({
+          text: st.stnm || st.stcd,
+          stcd: st.stcd,
+          sttp: st.sttp,
+          position: { x: st.lttd || 0, y: st.lgtd || 0, z: 100 },
+        });
+      }
+    }
+  }
+
+  /** 从图层树数据创建屏幕图标 */
+  _initScreenIcons() {
+    const cats = this.layerCategories || [];
+    const catConfig = {
+      seawall: {
+        img: '/image/screenIcon/海塘-红.png', method: 'textImage',
+        visibleRange: [5000, 150000], offset: [-40, -35], anchorType: 6,
+        onClick: (name, data) => {
+          this.flyToNode(data);
+          document.dispatchEvent(new CustomEvent('gaea-icon-click', { detail: { category: 'seawall', name, data } }));
+        },
+      },
+      hydrometricStations: {
+        img: '/image/screenIcon/潮位站-正常.png', method: 'textImage',
+        visibleRange: [10, 5000], offset: [-40, -35],
+        onClick: (name, data) => {
+          console.log('[GaeaApp] hydrometricStations onClick:', name, data);
+          const eventData = {
+            category: 'hydrometricStations',
+            name,
+            data: { ...data, stcd: data.stcd || '', sttp: data.sttp || 'ZQ' }
+          };
+          document.dispatchEvent(new CustomEvent('gaea-icon-click', { detail: eventData, bubbles: true, cancelable: true }));
+          if (window.__gaeaIconClickHandler) {
+            window.__gaeaIconClickHandler({ detail: eventData });
+          }
+          console.log('[GaeaApp] hydrometricStations 事件已派发');
+        },
+      },
+      tideStations: {
+        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',
+        visibleRange: [10, 5000], offset: [-40, -35],
+        onClick: (name, data) => {
+          this.flyToNode(data);
+          document.dispatchEvent(new CustomEvent('gaea-icon-click', { detail: { category: 'riverStations', name, data } }));
+        },
+      },
+      rainStations: {
+        img: '/image/screenIcon/雨量站-绿.png', method: 'textImage',
+        visibleRange: [10, 5000], offset: [-40, -35],
+        onClick: (name, data) => {
+          this.flyToNode(data);
+          document.dispatchEvent(new CustomEvent('gaea-icon-click', { detail: { category: 'rainStations', name, data } }));
+        },
+      },
+      reservoirs: {
+        img: '/image/screenIcon/水库站.png', method: 'styled',
+        visibleRange: [10, 5000], offset: [-40, -35],
+        onClick: (name, data) => {
+          this.flyToNode(data);
+          document.dispatchEvent(new CustomEvent('gaea-icon-click', { detail: { category: 'reservoirs', name, data } }));
+        },
+      },
+      sluice: {
+        img: '/image/screenIcon/闸门-绿.png', method: 'textImage',
+        visibleRange: [10, 3000], offset: [-40, -35],
+        onClick: (name, data) => {
+          this.flyToNode(data);
+          document.dispatchEvent(new CustomEvent('gaea-icon-click', { detail: { category: 'sluice', name, data } }));
+        },
+      },
+      secData: {
+        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',
+        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',
+        visibleRange: [10, 5000], offset: [-25, -80],
+        onClick: (name, data) => {
+          this.flyToNode(data);
+          document.dispatchEvent(new CustomEvent('gaea-icon-click', { detail: { category: 'rescue', name, data } }));
+        },
+      },
+      materials: {
+        img: '/image/screenIcon/物资仓库.png', method: 'imageOnly',
+        visibleRange: [10, 5000], offset: [-25, -80],
+        onClick: (name, data) => {
+          this.flyToNode(data);
+          document.dispatchEvent(new CustomEvent('gaea-icon-click', { detail: { category: 'materials', name, data } }));
+        },
+      },
+    };
+    console.log('[GaeaApp] 开始创建屏幕图标... categories:', cats.length);
+    let count = 0;
+    for (const cat of cats) {
+      if (!cat.children?.length) continue;
+      const cfg = catConfig[cat.key] || { img: '', method: 'textImage', visibleRange: [10, 50000], offset: [-40, -35], drawLine: false };
+      for (const child of cat.children) {
+        if (!child.position) continue;
+        count++;
+        try {
+          this.addScreenIcon({
+            name: child.text,
+            text: child.text,
+            imgUrl: cfg.img,
+            method: cfg.method,
+            position: child.position,
+            offset: cfg.offset,
+            visibleRange: cfg.visibleRange,
+            anchorType: cfg.anchorType,
+            drawLine: cfg.drawLine,
+            onClick: (name, data) => {
+              if (cfg.onClick) cfg.onClick(name, { ...child, ...data });
+            },
+          });
+        } catch (e) {
+          console.warn(`[GaeaApp] 图标 ${child.text} 创建失败:`, e.message);
+        }
+      }
+    }
+    console.log('[GaeaApp] 屏幕图标创建完成, 共:', count);
+  }
+
   // ---- 公开方法 ----
 
   /** 初始化默认图层和相机视角（手动调用，可传参覆盖配置） */
@@ -248,12 +877,333 @@ export class GaeaApp {
     return store;
   }
 
+  // ---- 地形服务 ----
+
+  /** 加载单个地形服务 */
+  _initTerrainServer(url) {
+    return new Promise((resolve) => {
+      Gaea.World.Instance.InitTerrainServer2(url, () => resolve());
+    });
+  }
+
+  /** 加载配置中的地形服务（cfg.defaultTerrains，url 为相对 serveUrl 的路径或完整地址） */
+  async addInitTerrainServer(terrains) {
+    const cfg = this.config;
+    const list = terrains ?? cfg.defaultTerrains;
+    if (!list?.length) return;
+    for (const t of list) {
+      const url = /^https?:\/\//.test(t.url) ? t.url : `${cfg.serveUrl}${t.url}`;
+      try {
+        await this._initTerrainServer(url);
+        console.log(`地形 "${t.name}" 加载成功`);
+      } catch (e) {
+        console.warn(`地形 "${t.name}" 加载失败:`, e?.message);
+      }
+    }
+  }
+
+  // ---- 贴地线（矢量线服务） ----
+
+  /** 从 WMTS 服务列表创建矢量要素服务 */
+  CreateFeature(serviceName, levelRange, render, alias) {
+    if (!this.layers?.length) return console.warn('矢量服务列表为空，请先调用 getAllServe()');
+    const cap = this.layers.find(i => i.Title === serviceName);
+    if (!cap) return console.warn(`矢量服务 "${serviceName}" 未找到`);
+    const store = new Gaea.WMTSVectorStore();
+    store.Name = alias == null ? serviceName : alias;
+    store.Init(cap);
+    store.ImageExtension = Gaea.ImageExtensionEnum.GEOJSON;
+    store.LevelRange = levelRange;
+    if (render != null) store.DefaultRenderer = render;
+    Gaea.World.Instance.DefaultVectorPyramidTileSet.AddImageStore(store);
+    return store;
+  }
+
+  /** 添加单条贴地线 */
+  AddVTSLine({ name, range, color, index }) {
+    const symbol = new Gaea.GroundPolylineSymbol();
+    symbol.Width = 2;
+    symbol.LineColor = new Gaea.Color(color[0] / 255, color[1] / 255, color[2] / 255, 1);
+    symbol.Priority = index;
+    const render = new Gaea.SimpleFeatureRenderer();
+    render.Symbol = symbol;
+    this.CreateFeature(name, new Gaea.Vector2(range[0], range[1]), render);
+    return render;
+  }
+
+  /** 加载配置中的贴地线（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)');
+    for (const item of list) {
+      if (item.isInitLoad === false) continue;
+      try {
+        this.AddVTSLine(item);
+        console.log(`贴地线 "${item.name}" 加载成功`);
+      } catch (e) {
+        console.warn(`贴地线 "${item.name}" 加载失败:`, e?.message);
+      }
+    }
+  }
+
   /** 定位到指定视角（经纬度高程 + 相机参数） */
   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;
+    const h = z + 500;
+    this.SetPosition(`${x},${y},${z},${h},0,0`);
+  }
+
+  // ---- 沿线飞行 ----
+
+  /**
+   * 沿线飞行 - 相机沿路径自动飞行
+   * @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 = {
+      height: 200,
+      step: 1000,
+      duration: 20.0,
+      xrotation: 30,
+      lockEye: false,
+      minZoom: 200,
+      maxZoom: 1000,
+      ...options,
+    };
+
+    if (!lineData || lineData.length < 2) {
+      console.error('flyAlongPath: 至少需要2个路径点');
+      return Promise.reject(new Error('至少需要2个路径点'));
+    }
+
+    try {
+      this._cleanupFlyResources();
+
+      const bezierCurve = new Gaea.UniformCubicSpline();
+      for (let i = 0; i < lineData.length; i++) {
+        const control = Gaea.GaeaMath.SphericalToCartesianDeg(
+          new Gaea.Vector3(lineData[i].x, lineData[i].y, lineData[i].z ?? opts.height)
+        );
+        bezierCurve.AddValue(i, control);
+      }
+      bezierCurve.Step = opts.step;
+      bezierCurve.Interpolate(true);
+      bezierCurve.CalculateLengthAfterInterpolation();
+
+      const startPos = Gaea.GaeaMath.SphericalToCartesianDeg(
+        new Gaea.Vector3(lineData[0].x, lineData[0].y, lineData[0].z ?? opts.height)
+      );
+
+      const mesh = new Gaea.CubeMesh();
+      mesh.Size = new Gaea.Vector3(1, 1, 1);
+      const mtl = new Gaea.SpatialMaterial();
+      mtl.AlbedoColor = new Gaea.Color(1, 0, 0, 1);
+      mesh.SurfaceSetMaterial(0, mtl);
+
+      this._flyModelInstance = new Gaea.MeshInstance();
+      this._flyModelInstance.Name = 'flyPathModel';
+      this._flyModelInstance.Visible = false;
+      this._flyModelInstance.Translation = startPos;
+      Gaea.World.Instance.AddChild(this._flyModelInstance, false);
+
+      this._flyEntityView = new Gaea.EntityView();
+      this._flyEntityView.Offset3D = new Gaea.Vector3(-1, 0, Math.tan(opts.xrotation / 180 * Math.PI));
+      this._flyEntityView.LockEye = opts.lockEye;
+      this._flyEntityView.MinMaxZoom3D = new Gaea.Vector2(opts.minZoom, opts.maxZoom);
+      this._flyEntityView.Init(this._flyModelInstance);
+      Gaea.World.Instance.CameraController.LockedEntity = this._flyEntityView;
+
+      this._flyAnimation = bezierCurve.ToAnimationByTime('flyPathAnimation', true, opts.duration, new Gaea.Vector3(1, 1, 1));
+      this._flyAnimation.TrackSetPath(0, '/root/World/flyPathModel');
+
+      this._flyAnimationPlayer = new Gaea.GaeaAnimationPlayer();
+      this._flyAnimationPlayer.AddAnimation('flyPathAnimation', this._flyAnimation);
+      Gaea.World.Instance.AddChild(this._flyAnimationPlayer, false);
+
+      return new Promise((resolve) => {
+        this._flyAnimationPlayer.PlayWithCallback('flyPathAnimation', Gaea.CallbackType.AnimatioFinished, () => {
+          console.log('沿线飞行动画播放完成');
+          resolve();
+        });
+      });
+    } catch (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);
+    } catch (error) {
+      console.error('停止飞行失败:', error);
+    }
+    this._cleanupFlyResources();
+  };
+
+  /** 清理飞行相关资源 */
+  _cleanupFlyResources = () => {
+    try {
+      if (this._flyAnimationPlayer) {
+        Gaea.World.Instance.RemoveChild(this._flyAnimationPlayer);
+        this._flyAnimationPlayer = null;
+      }
+      if (this._flyEntityView) this._flyEntityView = null;
+      if (this._flyModelInstance) {
+        Gaea.World.Instance.RemoveChild(this._flyModelInstance);
+        this._flyModelInstance = null;
+      }
+      Gaea.World.Instance.CameraController.LockedEntity = null;
+      this._flyAnimation = null;
+    } catch (error) {
+      console.error('清理飞行资源失败:', error);
+    }
+  };
+
+  /** 相机复位到默认视角 */
+  cameraReset = () => {
+    this._cleanupFlyResources();
+    const pos = this.config.defaultCameraPosition;
+    if (pos) this.SetPosition(pos);
+  };
+
+  /**
+   * 添加屏幕图标（参考 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, divId: externalDivId, elementName, elementChildrenIndex } = {}) {
+    const safeId = name.replace(/[^a-zA-Z0-9\u4e00-\u9fa5]/g, '_');
+    const divId = externalDivId || 'gaea-icon-' + safeId;
+
+    // 如果是外部传入的 divId，直接使用已有的 DOM 元素
+    let container;
+    if (externalDivId) {
+      container = document.getElementById(externalDivId);
+      if (!container) return null;
+    } else {
+      container = document.createElement('div');
+      container.id = divId;
+
+      if (method === 'imageOnly') {
+      container.className = 'gaea-iconGif';
+      const img = document.createElement('img');
+      img.src = imgUrl || '';
+      container.appendChild(img);
+    } else if (method === 'styled') {
+      container.className = 'gaea-iconscreen';
+      const img = document.createElement('img');
+      img.src = imgUrl || '';
+      container.appendChild(img);
+      const content = document.createElement('div');
+      content.className = 'content';
+      const box = document.createElement('div');
+      box.className = 'box';
+      content.appendChild(box);
+      const textArea = document.createElement('div');
+      textArea.className = 'text';
+      textArea.textContent = text || '';
+      content.appendChild(textArea);
+      container.appendChild(content);
+    } else {
+      container.className = 'gaea-locationLineStyle';
+      const textWrapper = document.createElement('div');
+      textWrapper.className = 'text-wrapper';
+      const textEl = document.createElement('div');
+      textEl.className = 'text-content';
+      textEl.textContent = text || name;
+      textWrapper.appendChild(textEl);
+      container.appendChild(textWrapper);
+      if (imgUrl) {
+        const imgWrapper = document.createElement('div');
+        imgWrapper.className = 'image-wrapper';
+        const img = document.createElement('img');
+        img.src = imgUrl;
+        imgWrapper.appendChild(img);
+        container.appendChild(imgWrapper);
+      }
+    }
+
+    } // end else (externalDivId)
+
+    if (!externalDivId) {
+      document.body.appendChild(container);
+    }
+
+    container.style.position = 'absolute';
+    container.style.zIndex = '9999';
+    container.style.pointerEvents = 'auto';
+    container.style.cursor = 'pointer';
+
+    // 在 DOM 上绑点击事件（Gaea ScreenGUIElement 的 OnHitElement 对 DOM 型图标不生效）
+    container.addEventListener('click', (e) => {
+      e.stopPropagation();
+      e.preventDefault();
+      console.log('[GaeaApp] 图标点击:', name);
+      if (onClick) { onClick(name, { text, position }); }
+      else if (position) { this.flyToNode({ position }); }
+    });
+
+    const screen = new Gaea.ScreenGUIElement();
+    screen.Name = name;
+    screen.Visible = true;
+    screen.UseAutoVisible();
+    screen.DivID = divId;
+    const root = new Gaea.Control();
+    root.MouseFilter = 2;
+    root.RectSize = new Gaea.Vector2(container.clientWidth, container.clientHeight);
+    screen.Root = root;
+    screen.ConnectAnchor = anchorType;
+    screen.DrawLine = drawLine;
+    if (drawLine) {
+      screen.LineWidth = screen.AnchorPointSize = 3;
+      screen.LineColor = new Gaea.Color(1, 0.3, 0.3, 1);
+      screen.AnchorPointColor = new Gaea.Color(1, 0.3, 0.3, 1);
+    }
+    if (offset.length) screen.ScreenOffset = new Gaea.Vector2(offset[0], offset[1]);
+    screen.EnablePick = true;
+    if (visibleRange.length) screen.VisibleRange = new Gaea.Vector2(visibleRange[0], visibleRange[1]);
+
+    // 如果有 elementName，将图标挂到 GLTF 模型子节点上（位置由父节点决定）
+    if (elementName && elementChildrenIndex !== undefined) {
+      const el = this._gltfElements?.[elementName];
+      console.log('[GaeaApp] addScreenIcon element:', elementName, 'el:', !!el, 'childrenIndex:', elementChildrenIndex);
+      if (el && el.Root) {
+        const childCount = el.Root.GetChildCount();
+        console.log('[GaeaApp] root child count:', childCount);
+        const child = el.Root.GetChild(elementChildrenIndex);
+        console.log('[GaeaApp] child:', !!child);
+        if (child) {
+          child.AddChild(screen, false);
+          const screenItem = { element: screen, type: type || null };
+          this._screenIconList.push(screenItem);
+          return screen;
+        }
+      }
+      // 子节点未找到，回退到绝对位置
+      console.warn('[GaeaApp] elementName/childIndex 未找到，使用 position 回退:', elementName, elementChildrenIndex);
+    }
+
+    screen.GeographyPosition = new Gaea.Vector3(position.x, position.y, position.z || 0);
+    Gaea.World.Instance.RenderableObjectList.AddLast(screen);
+    const screenItem = { element: screen, type: type || null };
+     this._screenIconList.push(screenItem);
+    return screen;
+  }
+
   /** 记录当前视角，返回 URI 字符串 */
   favorite() {
     return Gaea.GaeaCamera.ConvertBy(Gaea.World.Instance.DefaultCamera).Favorite();
@@ -263,6 +1213,522 @@ export class GaeaApp {
   favoritePosition(uri) {
     Gaea.World.Instance.DefaultCamera.GotoFavorite(uri);
   }
+
+  // ---- 引擎动画方法 ----
+
+  hiddenScreenWithClass(className) {
+    const els = document.querySelectorAll(className);
+    els.forEach(el => { el.style.display = 'none'; });
+  }
+
+  _createSecLabel(text, className, imgUrl, options = {}) {
+    const id = 'gaea-sec-' + Math.random().toString(36).slice(2);
+    const container = document.createElement('div');
+    container.id = id;
+    if (className) container.className = className;
+    const img = document.createElement('img');
+    img.src = imgUrl || '';
+    container.appendChild(img);
+    const content = document.createElement('div');
+    content.className = 'content';
+    const box = document.createElement('div');
+    box.className = 'box';
+    content.appendChild(box);
+    const textEl = document.createElement('div');
+    textEl.className = 'text';
+    const inner = document.createElement('div');
+    inner.textContent = text || '';
+    inner.style.color = 'white';
+    textEl.appendChild(inner);
+    content.appendChild(textEl);
+    container.appendChild(content);
+    if (options.onMouseEnter) container.addEventListener('mouseenter', options.onMouseEnter);
+    if (options.onMouseLeave) container.addEventListener('mouseleave', options.onMouseLeave);
+    document.body.appendChild(container);
+    return id;
+  }
+
+  _tooltipFormatter(key, value, indexList, name) {
+    const label = typeof value === 'object' && value.label ? value.label : value;
+    const details = typeof value === 'object' && value.details ? value.details : [];
+    let html = '';
+    if (details.length) {
+      details.forEach(item => { html += `<div class="daba-tooltip-item">${item}</div>`; });
+    } else {
+      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 tourModel = this._gltfElements?.[tourModelName];
+
+    document.dispatchEvent(new CustomEvent('gaea-icon-click', {
+      detail: { category: 'secData', name, data, sectionModel: sectionModel || null, tourModel: tourModel || null },
+      bubbles: true,
+    }));
+
+    if (!sectionModel) {
+      this.flyToNode(data);
+      return;
+    }
+
+    // 首次点击断面时注入标签样式
+    if (!document.getElementById('gaea-sec-styles')) {
+      const style = document.createElement('style');
+      style.id = 'gaea-sec-styles';
+      style.textContent = `
+        .waterLevel{position:absolute;z-index:1000;width:112px;top:16%;left:30%}
+        .waterLevel img{width:100%}
+        .waterLevel .content{position:absolute;top:16%;left:25%;white-space:nowrap}
+        .waterLevel .content .text{font-size:20px}
+        .damScreen{position:absolute;box-sizing:border-box;top:431.312px;left:630.192px;width:288px;height:48px;padding:0;margin:0;overflow:hidden;display:block;z-index:3}
+        .damScreen img{position:absolute;width:100%;height:100%;object-fit:cover;z-index:1}
+        .damScreen .content{display:flex;position:relative;width:100%;min-height:100%;z-index:2;align-items:center}
+        .damScreen .content .box{width:35.2px;height:100%;box-sizing:border-box}
+        .damScreen .content .text{flex:1 1 0%;height:100%;display:flex;font-size:18px;align-items:center;justify-content:center;box-sizing:border-box}
+        .daba-tooltip{position:fixed;z-index:99999;transform:translate(-50%,-100%);pointer-events:none;display:none;min-width:200px;max-width:320px;background:rgba(2,62,138,0.95);border:1px solid rgba(14,165,233,0.6);border-radius:6px;padding:14px 18px;box-shadow:0 4px 20px rgba(0,50,100,0.4);font-size:18px;animation:dabaTooltipFadeIn 0.15s ease-out}
+        .daba-tooltip::after{content:'';position:absolute;bottom:-6px;left:50%;transform:translateX(-50%);width:0;height:0;border-left:6px solid transparent;border-right:6px solid transparent;border-top:6px solid rgba(2,62,138,0.95)}
+        @keyframes dabaTooltipFadeIn{from{opacity:0;transform:translate(-50%,calc(-100% - 4px))}to{opacity:1;transform:translate(-50%,-100%)}}
+        .daba-tooltip-title{font-size:17px;font-weight:600;color:#e0f7ff;padding-bottom:8px;margin-bottom:10px;border-bottom:1px solid rgba(255,255,255,0.15)}
+        .daba-tooltip-item{position:relative;padding:3px 0 3px 14px;font-size:15px;line-height:1.7;color:#cbd5e1;word-break:break-word}
+        .daba-tooltip-item::before{content:'';position:absolute;left:0;top:11px;width:5px;height:5px;border-radius:50%;background:#38bdf8}
+      `;
+      document.head.appendChild(style);
+    }
+
+    const gltfCfg = this._gltfCfgMap?.[tourModelName];
+    if (tourModel && gltfCfg) {
+      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.FlyOver(() => {
+      this.hiddenScreenWithClass('.waterLevel');
+      this.hiddenScreenWithClass('.damScreen');
+
+      this.gltfPlayer(sectionModel, { x: 0, y: 44, z: 0 }, 1).then(() => {
+        // 记录已升起的断面模型，供重置时缩回
+        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 }));
+        }
+
+        if (!this._secIsClickArr.includes(name)) {
+          if (!document.getElementById('daba-tooltip')) {
+            const tt = document.createElement('div');
+            tt.id = 'daba-tooltip';
+            tt.className = 'daba-tooltip';
+            document.body.appendChild(tt);
+          }
+          const dabaTooltip = document.getElementById('daba-tooltip');
+          const divIdList = [];
+          const hasNumber = (str) => typeof str === 'string' && /[+-]?\d+(\.\d+)?/.test(str);
+
+          Object.entries(data.indexList || {}).forEach(([key, value]) => {
+            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';
+            } else {
+              cls = 'damScreen'; offset = [0, -19]; imgUrl = '/image/labelImg/左边.png';
+            }
+             const divid = this._createSecLabel(entryLabel, cls, imgUrl, {
+               onMouseEnter: (e) => {
+                const rect = e.currentTarget.getBoundingClientRect();
+                dabaTooltip.innerHTML = this._tooltipFormatter(key, value, data.indexList, name);
+                dabaTooltip.style.left = `${rect.left + rect.width / 2}px`;
+                dabaTooltip.style.top = `${rect.top - 8}px`;
+                dabaTooltip.style.display = 'block';
+              },
+              onMouseLeave: () => { dabaTooltip.style.display = 'none'; },
+            });
+            divIdList.push(divid);
+            this.addScreenIcon({
+              name: entryLabel, divId: divid, position: data.position,
+              visibleRange: [0, 100], offset, imgUrl, type: 'dabaSec',
+              anchorType: Gaea.AnchorType.LeftDown,
+              elementName: name, elementChildrenIndex: Number(key),
+            });
+          });
+          this._secIsClickArr.push(name);
+          this._secScreenIconKeyValue[name] = divIdList;
+        }
+
+        this._screenIconList.forEach(item => {
+          if (!item.type || item.type !== 'dabaSec') {
+            item.element.ForceSetVisible(false);
+            item.element.EnablePick = false;
+          }
+        });
+        this.hiddenScreenWithClass('.gaea-iconscreen');
+        this.hiddenScreenWithClass('.gaea-locationLineStyle');
+        this.hiddenScreenWithClass('.gaea-iconGif');
+      }).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(() => {
+      if (callback) callback();
+    });
+  }
+
+  /** GLTF 模型平移动画 */
+  gltfPlayer = (element, targetPos, time = 5) => {
+    return new Promise((resolve, reject) => {
+      if (!element || !element.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 属性'));
+        return;
+      }
+      const frameRate = 60;
+      const totalFrames = time * frameRate;
+      let currentFrame = 0;
+      const totalRelativeOffset = { ...targetPos };
+      let currentCumulativeOffset = { x: 0, y: 0, z: 0 };
+      try {
+        element.TranslateObjectLocal(new Gaea.Vector3(-currentCumulativeOffset.x, -currentCumulativeOffset.y, -currentCumulativeOffset.z));
+        currentCumulativeOffset = { x: 0, y: 0, z: 0 };
+        const fixedStep = {
+          x: totalRelativeOffset.x / totalFrames,
+          y: totalRelativeOffset.y / totalFrames,
+          z: totalRelativeOffset.z / totalFrames,
+        };
+        const moveStep = () => {
+          if (currentFrame >= totalFrames) {
+            const finalCompensate = {
+              x: totalRelativeOffset.x - currentCumulativeOffset.x,
+              y: totalRelativeOffset.y - currentCumulativeOffset.y,
+              z: totalRelativeOffset.z - currentCumulativeOffset.z,
+            };
+            element.TranslateObjectLocal(new Gaea.Vector3(finalCompensate.x, finalCompensate.y, finalCompensate.z));
+            currentCumulativeOffset = { ...totalRelativeOffset };
+            resolve({ success: true, targetPos, actualPos: currentCumulativeOffset });
+            return;
+          }
+          element.TranslateObjectLocal(new Gaea.Vector3(fixedStep.x, fixedStep.y, fixedStep.z));
+          currentCumulativeOffset.x += fixedStep.x;
+          currentCumulativeOffset.y += fixedStep.y;
+          currentCumulativeOffset.z += fixedStep.z;
+          currentFrame++;
+          requestAnimationFrame(moveStep);
+        };
+        moveStep();
+      } catch (error) {
+        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();
+      ev.Offset3D = new Gaea.Vector3(Offset3D[0], Offset3D[1], Offset3D[2]);
+      ev.LockEye = LockEye;
+      ev.MinMaxZoom3D = new Gaea.Vector2(MinMaxZoom3D[0], MinMaxZoom3D[1]);
+      ev.Init(element);
+      if (element) {
+        Gaea.World.Instance.CameraController.LockedEntity = ev;
+      }
+      return ev;
+    } else {
+      Gaea.World.Instance.CameraController.LockedEntity = null;
+      // 解锁时恢复非断面图标的自动可见
+      this._screenIconList.forEach(item => {
+        if (!item.type) {
+          item.element.UseAutoVisible();
+          item.element.EnablePick = true;
+        }
+      });
+    }
+  };
+
+  /** 修改模型位置/旋转 */
+  updateElementPosition = ({ element, position, rotate, size }) => {
+    element.GeographyPosition = new Gaea.Vector3(position.x, position.y, position.z);
+    if (rotate?.length > 0) {
+      element.TiltHeadingBank = new Gaea.Vector3(rotate[0], rotate[1], rotate[2]);
+    }
+  };
+
+  /** 移除 VTS 矢量图层 */
+  RemoveVts = ({ vtsName }) => {
+    Gaea.World.Instance.DefaultVectorPyramidTileSet.RemoveImageStore(
+      Gaea.WMTSVectorStore.ConvertBy(Gaea.World.Instance.DefaultVectorPyramidTileSet.GetImageStore(vtsName))
+    );
+  };
+
+  /** GLTF 轨迹动画播放（用于断面游览） */
+  gtlfAnimationPlayer = (trackList, animationConfig, element) => {
+    element.GeographyPosition = new Gaea.Vector3(trackList[0].x, trackList[0].y, trackList[0].z);
+    const { animationName, animationType, animationPlaySpeed } = animationConfig;
+    const line = trackList.map(item => new Gaea.Vector3(item.x, item.y, item.z));
+    let bezierCurve = new Gaea.LineCurve();
+    for (let i = 0; i < line.length; i++) {
+      let control = Gaea.GaeaMath.SphericalToCartesianDeg1(line[i].x, line[i].y, line[i].z);
+      bezierCurve.AddValue(i, control);
+    }
+    bezierCurve.Step = 20;
+    bezierCurve.Interpolate(true);
+    bezierCurve.CalculateLengthAfterInterpolation();
+    let animation;
+    if (animationType === 'speed') {
+      animation = bezierCurve.ToAnimationBySpeed(animationName, animationPlaySpeed, element.Scale);
+    } else {
+      animation = bezierCurve.ToAnimationByTime(animationName, true, animationPlaySpeed, element.Scale);
+    }
+    animation.TrackSetPath(0, element.GetPath());
+    const animationPlayer = new Gaea.AnimationPlayer();
+    animationPlayer.AddAnimation(animationName, animation);
+    element.AddChild(animationPlayer, false);
+    Gaea.World.Instance.PlayAnimation(animationPlayer, animationName);
+    return animationPlayer;
+  };
+
+  /** 环绕飞行 */
+  FlyAroundPoint = (element, targetAngle, time, callbacks = {}) => {
+    const { onStart = () => {}, onUpdate = () => {}, onComplete = () => {} } = callbacks;
+    if (!targetAngle || !element) { onComplete(null); return; }
+    let lastAngle = 0;
+    let currentAngle = 0;
+    const tween = new TWEEN.Tween({ angle: 0 })
+      .to({ angle: targetAngle }, time)
+      .easing(TWEEN.Easing.Quadratic.InOut)
+      .onStart(() => { onStart(); })
+      .onUpdate((obj) => {
+        currentAngle = obj.angle;
+        element.RotateObjectLocal(new Gaea.Vector3(0, 1, 0), currentAngle - lastAngle);
+        lastAngle = currentAngle;
+        onUpdate(currentAngle);
+      })
+      .onComplete(() => { onComplete(targetAngle); this.tweenGroup.remove(tween); });
+    this.tweenGroup.add(tween);
+    this._startTweenLoop();
+    tween.start();
+  };
+
+  /** 启动 TWEEN 更新循环（首次调用时启动） */
+  _startTweenLoop() {
+    if (this._tweenLoopStarted) return;
+    this._tweenLoopStarted = true;
+    const animate = (time) => {
+      requestAnimationFrame(animate);
+      this.tweenGroup.update(time);
+    };
+    requestAnimationFrame(animate);
+  }
+
+  /** 提取索引区间的 pos 数组，起始>目标时反序 */
+  getPosArrayBetweenIndexes(list, currentIdx, targetIdx) {
+    if (!Array.isArray(list) || currentIdx < 0 || targetIdx < 0 ||
+      currentIdx >= list.length || targetIdx >= list.length) {
+      return [];
+    }
+    const isReverse = currentIdx > targetIdx;
+    const start = Math.min(currentIdx, targetIdx);
+    const end = Math.max(currentIdx, targetIdx);
+    let result = list.slice(start, end + 1).map(item => item.pos ? { ...item.pos } : null).filter(Boolean);
+    if (isReverse) result = result.reverse();
+    return result;
+  }
+
+  /** 室内游览初始化：隐藏图标 + 锁定游览模型 */
+  initModelTour(modelName, direction = [-0.5, 0, 0]) {
+    // 隐藏所有屏幕图标
+    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 }));
+
+    const tourModel = this._gltfElements?.[`${modelName}游览模型`];
+    if (!tourModel) {
+      console.warn('[GaeaApp] 游览模型未找到:', modelName);
+      return null;
+    }
+    this._currentTourModel = tourModel;
+    this._currentTourIndexPos = 0;
+    this.lockedModesSwitch(true, tourModel, [direction[0], direction[1], direction[2]], [0.5, 0.5], false);
+    return tourModel;
+  }
+
+  /** 室内游览路径节点点击：沿路径移动 + 转头 */
+  tourNodeClick(positionList, index) {
+    const tourModel = this._currentTourModel;
+    if (!tourModel) return;
+    this.lockedModesSwitch(true, tourModel, [-0.5, 0, 0], [0.5, 0.5], true);
+    const currentIdx = this._currentTourIndexPos || 0;
+    const currentPosList = this.getPosArrayBetweenIndexes(positionList, currentIdx, index);
+    const time = 2 * (currentPosList.length - 1);
+    this.gtlfAnimationPlayer(currentPosList, {
+      animationName: `动画${index}`, animationType: 'time', animationPlaySpeed: time, animationLoop: false,
+    }, tourModel);
+    const status = currentIdx > index ? 'out' : 'in';
+    this._currentTourIndexPos = index;
+    setTimeout(() => {
+      let angle, direction;
+      if (status === 'in') {
+        angle = positionList[index]?.lockInAngle;
+        direction = positionList[index]?.lockIn;
+      } else {
+        angle = positionList[index]?.lockOutAngle;
+        direction = positionList[index]?.lockOut;
+      }
+      if (angle) {
+        this.FlyAroundPoint(tourModel, angle, 2000, {
+          onComplete: () => { this.lockedModesSwitch(true, tourModel, direction, [0.5, 0.5]); },
+        });
+      }
+    }, time * 1000);
+  }
+
+  /** 通过 URL 加载资源 */
+  LoadResourceFromUrl = (url, name) => {
+    return new Promise((resolve, reject) => {
+      Gaea.GaeaResourceLoader.Instance.LoadResourceFromUrl1(url, name, (code, msg) => {
+        if (code == 200) resolve(true);
+        else { console.warn(msg); reject(false); }
+      });
+    });
+  };
+
+  /** 添加单个点图标 */
+  addPointIcon = async (options = {}) => {
+    const { lat, lng, alt = 0, iconSize = 500, enablePick = true } = options;
+    if (lat == null || lng == null) {
+      console.error('addPointIcon: lat 和 lng 不能为空');
+      return null;
+    }
+    // 资源名带版本号：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 图标文件失败');
+        return null;
+      }
+      this._pointIconLoaded = true;
+    }
+    const texId = Gaea.GaeaResourceLoader.Instance.GetResource(resName);
+    const tex = new Gaea.Texture(false);
+    tex.InstanceID = texId + '';
+    const pos = new Gaea.Vector3(lat, lng, alt);
+    const shape = Gaea.Geometry.Create1(Gaea.GeometryType.Point, [pos]);
+    const element = new Gaea.PointGeometryElement();
+    element.Shape = shape;
+    const iconMarkSymbol = new Gaea.IconMarkSymbol();
+    iconMarkSymbol.MarkSize = iconSize;
+    iconMarkSymbol.Icon = tex;
+    element.Symbol = iconMarkSymbol;
+    element.EnablePick = enablePick;
+    element.EnableEdit = false;
+    Gaea.World.Instance.RenderableObjectList.AddLast(element);
+    if (!this._pointIconElements) this._pointIconElements = [];
+    this._pointIconElements.push(element);
+    return element;
+  };
+
+  /** 清除所有点图标 */
+  clearPointIcons = () => {
+    if (this._pointIconElements && this._pointIconElements.length > 0) {
+      this._pointIconElements.forEach
+      (el => Gaea.World.Instance.RenderableObjectList.Remove(el));
+      this._pointIconElements = [];
+    }
+    this.clearTyphoonRoute();
+  };
+
+  /** 加载台风路线：创建图标并沿路径运动（点位数组 [{lat,lng,alt}]） */
+  addTyphoonRoute = async (pointList = [], options = {}) => {
+    const { animationPlaySpeed = 20, animationLoop = true } = options;
+    this.clearTyphoonRoute();
+    if (!pointList || pointList.length < 2) {
+      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: 创建图标失败');
+      return;
+    }
+    if (this._pointIconElements) {
+      const idx = this._pointIconElements.indexOf(element);
+      if (idx >= 0) this._pointIconElements.splice(idx, 1);
+    }
+    this._typhoonElement = element;
+
+    const steps = animationPlaySpeed * 30;
+    const path = [];
+    for (let i = 0; i < pointList.length - 1; i++) {
+      const segSteps = Math.max(1, Math.round(steps / (pointList.length - 1)));
+      for (let j = 0; j < segSteps; j++) {
+        const t = j / segSteps;
+        path.push({
+          lat: pointList[i].lat + (pointList[i + 1].lat - pointList[i].lat) * t,
+          lng: pointList[i].lng + (pointList[i + 1].lng - pointList[i].lng) * t,
+          alt: (pointList[i].alt || 0) + ((pointList[i + 1].alt || 0) - (pointList[i].alt || 0)) * t,
+        });
+      }
+    }
+
+    const _log = console.log;
+    let idx = 0;
+    const animate = () => {
+      if (!this._typhoonElement || this._typhoonCancelled) return;
+      console.log = () => {};
+      const pt = path[idx];
+      element.Shape = Gaea.Geometry.Create1(Gaea.GeometryType.Point, [new Gaea.Vector3(pt.lat, pt.lng, pt.alt)]);
+      console.log = _log;
+      if (animationLoop) {
+        idx = (idx + 1) % path.length;
+      } else {
+        idx++;
+        if (idx >= path.length) {
+          console.log = () => {};
+          const last = path[path.length - 1];
+          element.Shape = Gaea.Geometry.Create1(Gaea.GeometryType.Point, [new Gaea.Vector3(last.lat, last.lng, last.alt)]);
+          console.log = _log;
+          return;
+        }
+      }
+      this._typhoonTimer = setTimeout(() => animate(), 1000 / 30);
+    };
+    this._typhoonCancelled = false;
+    animate();
+    return { element };
+  };
+
+  /** 清除台风路线 */
+  clearTyphoonRoute = () => {
+    this._typhoonCancelled = true;
+    if (this._typhoonTimer) { clearTimeout(this._typhoonTimer); this._typhoonTimer = null; }
+    if (this._typhoonElement) {
+      try { Gaea.World.Instance.RenderableObjectList.Remove(this._typhoonElement); } catch (e) { /* ignore */ }
+      this._typhoonElement = null;
+    }
+  };
 }
 
 export default GaeaApp;