@kq_npm/client3d_webgl_vue 4.5.56 → 4.5.57

package/lowaltitudefeature/index.js

@@ -57,14 +57,23 @@ exports["default"] = void 0;
 class LowAltitudeFeatureViewModel {
   // viewer 就绪回调
 
+  /** @description 构造函数，初始化低空要素视图模型
+   * @param {Object} viewer Cesium Viewer 实例
+   * @param {Object} options 配置项，可包含 onReady 回调
+   */
   constructor(viewer, options = {}) {
     this._viewer = null;
+    // Cesium Viewer 实例
     this._options = {};
+    // 配置参数对象
     this._dataSource = null;
+    // 自定义数据源
     this._currentDrawHandler = null;
+    // 当前绘制事件处理器
     this._activeDrawMode = null;
     // 'point' | 'polyline' | 'polygon'
     this._drawingEntities = [];
+    // 当前绘制产生的实体集合
     this._gridEntities = new Map();
     // featureId -> grid entity ids
     this._onReady = null;
@@ -126,6 +135,8 @@ class LowAltitudeFeatureViewModel {
     }, Cesium.ScreenSpaceEventType.LEFT_CLICK);
     return handler;
   }
+
+  // 清除当前绘制事件处理器
   _clearDraw() {
     if (this._currentDrawHandler) {
       this._currentDrawHandler.destroy();
@@ -200,8 +211,8 @@ class LowAltitudeFeatureViewModel {
   drawPolygon(settings = {}, onDrawComplete) {
     this._clearDraw();
     this._activeDrawMode = "polygon";
-    const self = this;
-    const positions = [];
+    const self = this; // 保存 this 引用，便于回调内访问
+    const positions = []; // 已绘制的顶点集合
     const handler = new Cesium.ScreenSpaceEventHandler(this._viewer.scene.canvas);
 
     // 动态预览面
@@ -220,11 +231,15 @@ class LowAltitudeFeatureViewModel {
       }
     });
     this._drawingEntities.push(previewEntity);
+
+    // 左键点击添加顶点
     handler.setInputAction(event => {
       const position = this._pickPosition(event.position);
       if (!position) return;
       positions.push(position);
     }, Cesium.ScreenSpaceEventType.LEFT_CLICK);
+
+    // 右键完成绘制
     handler.setInputAction(() => {
       if (positions.length < 3) return;
       handler.destroy();
@@ -250,6 +265,9 @@ class LowAltitudeFeatureViewModel {
 
   /**
    * @description 创建点实体（含缓冲区可视化）
+   * @param {Cesium.Cartesian3} cartesian 笛卡尔坐标
+   * @param {Object} settings 图元设置，包含 bufferDistance、bufferType 等
+   * @returns {Cesium.Entity} 创建的点实体
    * @private
    */
   _createPointEntity(cartesian, settings = {}) {
@@ -310,6 +328,12 @@ class LowAltitudeFeatureViewModel {
     }
     return this._viewer.entities.add(entityOptions);
   }
+
+  /** @description 计算圆形多边形顶点（用于 polylineVolume 形状）
+   * @param {Number} radius 半径
+   * @returns {Array<Cesium.Cartesian2>} 圆形顶点数组
+   * @private
+   */
   _computeCircle(radius) {
     const positions = [];
     for (let i = 0; i < 360; i++) {
@@ -320,6 +344,9 @@ class LowAltitudeFeatureViewModel {
   }
   /**
    * @description 创建线实体（含缓冲走廊）
+   * @param {Array<Cesium.Cartesian3>} positions 顶点坐标数组
+   * @param {Object} settings 图元设置，包含 bufferDistance、lineColor 等
+   * @returns {Cesium.Entity} 创建的线实体
    * @private
    */
   _createPolylineEntity(positions, settings = {}) {
@@ -365,6 +392,9 @@ class LowAltitudeFeatureViewModel {
 
   /**
    * @description 创建面实体
+   * @param {Array<Cesium.Cartesian3>} positions 顶点坐标数组
+   * @param {Object} settings 图元设置，包含 fillColor、bufferDistance 等
+   * @returns {Cesium.Entity} 创建的面实体
    * @private
    */
   _createPolygonEntity(positions, settings = {}) {
@@ -450,6 +480,7 @@ class LowAltitudeFeatureViewModel {
    * @description 从GeoJSON创建实体
    * @param {Object} geoJson GeoJSON对象
    * @param {Object} settings 图元设置
+   * @param {Boolean} trackInDrawing 是否将创建的实体加入绘制集合（导入时为 true，保存/加载时为 false）
    * @returns {Array<Cesium.Entity>} 创建的实体数组
    */
   loadFromGeoJSON(geoJson, settings = {}, trackInDrawing = false) {
@@ -492,6 +523,8 @@ class LowAltitudeFeatureViewModel {
 
   /**
    * @description GeoJSON坐标转Cartesian3
+   * @param {Array<Number>} coord 坐标数组 [lon, lat, height]
+   * @returns {Cesium.Cartesian3} 笛卡尔坐标
    * @private
    */
   _geojsonCoordToCartesian(coord) {
@@ -503,6 +536,8 @@ class LowAltitudeFeatureViewModel {
 
   /**
    * @description 实体转GeoJSON
+   * @param {Cesium.Entity} entity 实体对象
+   * @returns {Object|null} GeoJSON Feature 对象
    */
   entityToGeoJSON(entity) {
     if (!entity) return null;
@@ -519,6 +554,8 @@ class LowAltitudeFeatureViewModel {
 
   /**
    * @description 点实体转GeoJSON Point
+   * @param {Cesium.Entity} entity 点实体
+   * @returns {Object|null} GeoJSON Feature
    * @private
    */
   _pointToGeoJSON(entity) {
@@ -537,6 +574,8 @@ class LowAltitudeFeatureViewModel {
 
   /**
    * @description 线实体转GeoJSON LineString
+   * @param {Cesium.Entity} entity 线实体
+   * @returns {Object|null} GeoJSON Feature
    * @private
    */
   _polylineToGeoJSON(entity) {
@@ -558,6 +597,8 @@ class LowAltitudeFeatureViewModel {
 
   /**
    * @description 面实体转GeoJSON Polygon
+   * @param {Cesium.Entity} entity 面实体
+   * @returns {Object|null} GeoJSON Feature
    * @private
    */
   _polygonToGeoJSON(entity) {
@@ -577,6 +618,11 @@ class LowAltitudeFeatureViewModel {
       }
     };
   }
+  /** @description 笛卡尔坐标转点 GeoJSON
+   * @param {Cesium.Cartesian3} position 笛卡尔坐标
+   * @returns {Object} GeoJSON Feature
+   * @private
+   */
   _positionToPointGeoJSON(position) {
     const c = Cesium.Cartographic.fromCartesian(position);
     return {
@@ -589,6 +635,8 @@ class LowAltitudeFeatureViewModel {
   }
   /**
    * @description 坐标数组转线GeoJSON
+   * @param {Array<Cesium.Cartesian3>} positions 笛卡尔坐标数组
+   * @returns {Object} GeoJSON Feature
    * @private
    */
   _positionsToLineGeoJSON(positions) {
@@ -608,6 +656,8 @@ class LowAltitudeFeatureViewModel {
 
   /**
    * @description 坐标数组转面GeoJSON
+   * @param {Array<Cesium.Cartesian3>} positions 笛卡尔坐标数组
+   * @returns {Object} GeoJSON Feature
    * @private
    */
   _positionsToPolygonGeoJSON(positions) {
@@ -630,7 +680,7 @@ class LowAltitudeFeatureViewModel {
 
   /**
    * @description 切换网格化显示
-   * @param {string} featureId 要素ID
+   * @param {Object} featureInfo 要素信息对象（含 id/code 等）
    * @param {boolean} show 是否显示网格
    * @param {Object} settings 图元设置
    */
@@ -649,6 +699,10 @@ class LowAltitudeFeatureViewModel {
     });
     this._gridEntities.set(featureId, gridEntities);
   }
+
+  /** @description 根据要素名查询并显示网格占用情况
+   * @param {Object} featureInfo 要素信息，包含 code/name 等
+   */
   showGridOccupancyQuery(featureInfo) {
     let that = this;
     let queryUrl = "http://172.16.1.204:9600/kqgis/rest/services/qqq/gridflow";
@@ -670,17 +724,20 @@ class LowAltitudeFeatureViewModel {
       }
       return response.json(); // 解析JSON数据
     }).then(data => {
+      // 请求成功且包含网格编码时渲染网格
       if (data.code == 200) {
         if (data.content.code) {
           // console.log(data.content.types);
           let code = data.content.code;
           let instanc = that.getGridInstanc(code);
           if (instanc) {
+            // 已存在图元时复用并更新几何实例
             if (that._clickGirdPrimitive) {
               that._clickGirdPrimitive.geometryInstances = instanc;
               that._clickGirdPrimitive._state = Cesium.PrimitiveState.READY;
               that._clickGirdPrimitive.updateVertex = true;
             } else {
+              // 首次创建带半透明红色材质的网格 Primitive
               that._clickGirdPrimitive = that._viewer.scene.primitives.add(new Cesium.Primitive({
                 geometryInstances: instanc,
                 appearance: new Cesium.MaterialAppearance({
@@ -705,7 +762,7 @@ class LowAltitudeFeatureViewModel {
                 asynchronous: false
               }));
             }
-            let gridcode = code.substring(0, (code.length + 1) / 2);
+            let gridcode = code.substring(0, (code.length + 1) / 2); // 截取前半段作为网格编码
             let type = data.content.types.map(item => item.description);
             //显示网格暂用情况
             that._htmlTag = new Cesium.Kq3dDragableHtmlTag(that._viewer, {
@@ -722,6 +779,7 @@ class LowAltitudeFeatureViewModel {
                   <div class='attr'>${that._language.value.webgl["occupancyType"]} : ${type.join(",")}</div>
                 </div>`
             });
+            // 延迟绑定关闭按钮事件
             setTimeout(() => {
               let close = document.querySelector("#grid_info_close");
               close.addEventListener("click", function () {
@@ -743,6 +801,10 @@ class LowAltitudeFeatureViewModel {
       console.error("There was a problem with your fetch operation:", error);
     });
   }
+
+  /** @description 查询并获取网格占用区域（不渲染）
+   * @param {Object} featureInfo 要素信息，包含 code/name 等
+   */
   getGridOccupancy(featureInfo) {
     let that = this;
     let queryUrl = "http://172.16.1.204:9600/kqgis/rest/services/qqq/gridflow";
@@ -761,6 +823,7 @@ class LowAltitudeFeatureViewModel {
       }
       return response.json(); // 解析JSON数据
     }).then(data => {
+      // 请求成功且包含网格编码时构建几何实例
       if (data.code == 200) {
         if (data.content.code) {
           // console.log(data.content.types);
@@ -772,10 +835,16 @@ class LowAltitudeFeatureViewModel {
       console.error("There was a problem with your fetch operation:", error);
     });
   }
+  /** @description 根据网格编码构建 Cesium 几何实例
+   * @param {String} code 网格编码字符串
+   * @returns {Cesium.GeometryInstance|undefined} 网格几何实例
+   */
   getGridInstanc(code) {
     let index = (code.length + 1) / 2;
+    // 调用 WASM 模块解码网格编码为边界框
     let grid = Module.decodeGeoSotGBCodeToBox(code.substring(0, index), code.substring(index));
     if (grid) {
+      // 限制经纬度范围在合法区间内
       if (grid.minx < -180) grid.minx = -180;
       if (grid.maxx > 180) grid.maxx = 180;
       if (grid.miny < -90) grid.miny = -90;
@@ -786,6 +855,8 @@ class LowAltitudeFeatureViewModel {
       const maxLat = Math.max(grid.miny, grid.maxy);
       const minz = grid.minz;
       const maxz = grid.maxz;
+
+      // 构建拉伸矩形几何体
       let rectangle = new Cesium.RectangleGeometry({
         ellipsoid: Cesium.Ellipsoid.WGS84,
         rectangle: Cesium.Rectangle.fromDegrees(minLon, minLat, maxLon, maxLat),
@@ -801,6 +872,7 @@ class LowAltitudeFeatureViewModel {
 
   /**
    * @description 移除网格实体
+   * @param {String} featureId 要素 ID
    * @private
    */
   _removeGridEntities(featureId) {
@@ -816,6 +888,9 @@ class LowAltitudeFeatureViewModel {
 
   /**
    * @description 在面内生成网格单元
+   * @param {Array<Cesium.Cartesian3>} boundaryPositions 边界顶点
+   * @param {Number} gridSizeMeters 网格尺寸（米）
+   * @returns {Array} 网格单元数组
    * @private
    */
   _generateGridInPolygon(boundaryPositions, gridSizeMeters) {
@@ -825,6 +900,10 @@ class LowAltitudeFeatureViewModel {
 
   /**
    * @description 沿线生成网格缓冲
+   * @param {Array<Cesium.Cartesian3>} positions 线顶点
+   * @param {Number} bufferSize 缓冲距离
+   * @param {Number} gridSizeMeters 网格尺寸（米）
+   * @returns {Array} 网格单元数组
    * @private
    */
   _generateGridAlongLine(positions, bufferSize, gridSizeMeters) {
@@ -834,6 +913,10 @@ class LowAltitudeFeatureViewModel {
 
   /**
    * @description 在点周围生成网格
+   * @param {Cesium.Cartesian3} center 中心点
+   * @param {Number} radius 半径
+   * @param {Number} gridSizeMeters 网格尺寸（米）
+   * @returns {Array} 网格单元数组
    * @private
    */
   _generateGridAroundPoint(center, radius, gridSizeMeters) {
@@ -843,6 +926,9 @@ class LowAltitudeFeatureViewModel {
 
   /**
    * @description 创建网格单元实体
+   * @param {Array<Number>} cellBounds 网格单元边界
+   * @param {Object} settings 图元设置
+   * @returns {Cesium.Entity} 网格单元实体
    * @private
    */
   _createGridCell(cellBounds, settings) {
@@ -863,6 +949,8 @@ class LowAltitudeFeatureViewModel {
 
   /**
    * @description 拾取鼠标位置的地理坐标
+   * @param {Cesium.Cartesian2} screenPos 屏幕坐标
+   * @returns {Cesium.Cartesian3|null} 笛卡尔坐标
    * @private
    */
   _pickPosition(screenPos) {
@@ -899,6 +987,8 @@ class LowAltitudeFeatureViewModel {
 
   /**
    * @description 缩放到实体
+   * @param {Cesium.Entity|String} entityOrId 实体或实体 ID
+   * @returns {Boolean} 是否成功
    */
   zoomToEntity(entityOrId) {
     let entity = entityOrId;
@@ -929,7 +1019,7 @@ class LowAltitudeFeatureViewModel {
   }
 
   /**
-   * @description 销毁ViewModel
+   * @description 销毁ViewModel，释放所有资源
    */
   destroy() {
     this.clearDraw();
@@ -971,7 +1061,7 @@ class LowAltitudeFeatureViewModel {
 
   /**
    * @description 删除要素实体（通过 entityIds 数组）
-   * @param {Array<string>} entityIds
+   * @param {Array<String>} entityIds 实体 ID 数组
    */
   removeFeatureEntities(entityIds) {
     if (!this._viewer || !entityIds) return;
@@ -1018,6 +1108,8 @@ class LowAltitudeFeatureViewModel {
 
   /**
    * @description 从 GeoJSON 提取 Cartographic 数组（私有工具方法）
+   * @param {Object} geojson GeoJSON 对象
+   * @returns {Array<Cesium.Cartographic>} 地理坐标数组
    * @private
    */
   _extractPositionsFromGeoJSON(geojson) {
@@ -1037,6 +1129,10 @@ class LowAltitudeFeatureViewModel {
     });
     return positions;
   }
+  /** @description 根据 id 获取实体
+   * @param {String} id 实体 ID
+   * @returns {Cesium.Entity|undefined} 实体对象
+   */
   getEntityById(id) {
     // 优先从 dataSource 中获取实体
     if (this._dataSource) {
@@ -1100,58 +1196,6 @@ const __exports__ = Formvue_type_script_lang_js/* default */.A;
 
 /***/ }),
 
-/***/ 11583:
-/***/ (function(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
-
-// ESM COMPAT FLAG
-__webpack_require__.r(__webpack_exports__);
-
-// EXPORTS
-__webpack_require__.d(__webpack_exports__, {
-  __esModule: function() { return /* reexport */ LowAltitudeFeaturevue_type_script_setup_true_lang_js/* __esModule */.B; },
-  "default": function() { return /* binding */ LowAltitudeFeature; }
-});
-
-// EXTERNAL MODULE: ./node_modules/babel-loader/lib/index.js??clonedRuleSet-1.use[0]!./node_modules/vue-loader/dist/index.js??ruleSet[0].use[0]!./src/webgl/lowaltitudefeature/LowAltitudeFeature.vue?vue&type=script&setup=true&lang=js
-var LowAltitudeFeaturevue_type_script_setup_true_lang_js = __webpack_require__(23043);
-;// ./src/webgl/lowaltitudefeature/LowAltitudeFeature.vue?vue&type=script&setup=true&lang=js
- 
-// EXTERNAL MODULE: ./node_modules/style-loader/dist/runtime/injectStylesIntoStyleTag.js
-var injectStylesIntoStyleTag = __webpack_require__(85072);
-var injectStylesIntoStyleTag_default = /*#__PURE__*/__webpack_require__.n(injectStylesIntoStyleTag);
-// EXTERNAL MODULE: ./node_modules/css-loader/dist/cjs.js!./node_modules/vue-loader/dist/stylePostLoader.js!./node_modules/vue-loader/dist/index.js??ruleSet[0].use[0]!./src/webgl/lowaltitudefeature/LowAltitudeFeature.vue?vue&type=style&index=0&id=b3c8fafe&scoped=true&lang=css
-var LowAltitudeFeaturevue_type_style_index_0_id_b3c8fafe_scoped_true_lang_css = __webpack_require__(74703);
-;// ./node_modules/style-loader/dist/cjs.js!./node_modules/css-loader/dist/cjs.js!./node_modules/vue-loader/dist/stylePostLoader.js!./node_modules/vue-loader/dist/index.js??ruleSet[0].use[0]!./src/webgl/lowaltitudefeature/LowAltitudeFeature.vue?vue&type=style&index=0&id=b3c8fafe&scoped=true&lang=css
-
-            
-
-var options = {};
-
-options.insert = "head";
-options.singleton = false;
-
-var update = injectStylesIntoStyleTag_default()(LowAltitudeFeaturevue_type_style_index_0_id_b3c8fafe_scoped_true_lang_css/* default */.A, options);
-
-
-
-/* harmony default export */ var lowaltitudefeature_LowAltitudeFeaturevue_type_style_index_0_id_b3c8fafe_scoped_true_lang_css = (LowAltitudeFeaturevue_type_style_index_0_id_b3c8fafe_scoped_true_lang_css/* default */.A.locals || {});
-;// ./src/webgl/lowaltitudefeature/LowAltitudeFeature.vue?vue&type=style&index=0&id=b3c8fafe&scoped=true&lang=css
-
-// EXTERNAL MODULE: ./node_modules/vue-loader/dist/exportHelper.js
-var exportHelper = __webpack_require__(66262);
-;// ./src/webgl/lowaltitudefeature/LowAltitudeFeature.vue
-
-
-
-;
-
-
-const __exports__ = /*#__PURE__*/(0,exportHelper/* default */.A)(LowAltitudeFeaturevue_type_script_setup_true_lang_js/* default */.A, [['__scopeId',"data-v-b3c8fafe"]])
-
-/* harmony default export */ var LowAltitudeFeature = (__exports__);
-
-/***/ }),
-
 /***/ 14464:
 /***/ (function(__unused_webpack_module, exports, __webpack_require__) {
 
@@ -1439,12 +1483,12 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     const props = __props;
 
     // ==================== 组件状态 ====================
-    let isAddOrEdit = (0, _vue.ref)(false);
-    let isEdit = (0, _vue.ref)(false);
-    let searchKeyword = (0, _vue.ref)("");
-    let panelCollapsed = (0, _vue.ref)(false);
-    let symbolSettingsExpanded = (0, _vue.ref)(false);
-    let currentDrawMode = (0, _vue.ref)("");
+    let isAddOrEdit = (0, _vue.ref)(false); // 是否处于新增/编辑面板状态
+    let isEdit = (0, _vue.ref)(false); // 是否为编辑模式
+    let searchKeyword = (0, _vue.ref)(""); // 树搜索关键字
+    let panelCollapsed = (0, _vue.ref)(false); // 右侧面板是否折叠
+    let symbolSettingsExpanded = (0, _vue.ref)(false); // 图元设置是否展开
+    let currentDrawMode = (0, _vue.ref)(""); // 当前绘制模式
 
     // 当前编辑的要素所属分类（新建时强制）
     let forcedCategory = (0, _vue.ref)(null);
@@ -1591,13 +1635,17 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
 
     let currentSubclassOptions = (0, _vue.computed)(() => {
       return subclassOptionsMap[formData.featureClass] || [];
-    });
+    }); // 当前分类下的子类选项
+
     let currentShapeTypes = (0, _vue.computed)(() => {
       return shapeTypeMap[currentGeometryType()] || [];
-    });
+    }); // 当前几何类型对应的形状选项
+
     let currentBufferTypes = (0, _vue.computed)(() => {
       return bufferTypeMap[currentGeometryType()] || [];
-    });
+    }); // 当前几何类型对应的缓冲类型选项
+
+    // 根据要素分类推断当前几何类型
     function currentGeometryType() {
       if (formData.featureClass === "hangar") return "point";
       if (formData.featureClass === "airroute") return "polyline";
@@ -1606,25 +1654,27 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     }
     let showRouteTypeField = (0, _vue.computed)(() => {
       return formData.featureClass === "airroute";
-    });
+    }); // 是否显示航线类型字段
+
     let showBufferTypeField = (0, _vue.computed)(() => {
       return currentBufferTypes.value.length > 0;
-    });
+    }); // 是否显示缓冲类型字段
+
     let showBufferDistanceField = (0, _vue.computed)(() => {
       // if (currentGeometryType() === "polygon") return false;
       return symbolSettings.bufferType && symbolSettings.bufferType !== "none";
-    });
+    }); // 是否显示缓冲距离字段
 
     // ==================== Cesium 相关 ====================
 
-    let currentEditFeature = null;
-    let boxRef = (0, _vue.ref)(null);
+    let currentEditFeature = null; // 当前编辑的要素对象
+    let boxRef = (0, _vue.ref)(null); // 组件容器 Ref
     let headerTemp = (0, _vue.ref)();
     let headerTempRef = (0, _vue.ref)(null);
-    let currentEntities = [];
-    let currentGeoJSON = null;
-    let viewer = null;
-    let viewModel = null;
+    let currentEntities = []; // 当前绘制产生的实体集合
+    let currentGeoJSON = null; // 当前绘制产生的 GeoJSON
+    let viewer = null; // Cesium Viewer 实例
+    let viewModel = null; // 视图模型实例
 
     // ==================== kq-tree 相关 ====================
     // 树节点唯一 key 字段名
@@ -1655,6 +1705,7 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     // 同步受控选中状态（根据数据 checked 属性更新 checkedKeys）
     function updateCheckedKeys() {
       const keys = [];
+      // 遍历所有分类下的要素，收集选中状态的节点 key
       featureCategories.forEach(cat => {
         if (cat.children) {
           cat.children.forEach(f => {
@@ -1669,7 +1720,10 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       featureTreeRef.value.$refs.child.setCheckedKeys(checkedKeys.value);
     }
 
-    // 节点展开回调（受控模式同步）
+    /** @description 节点展开回调（受控模式同步）
+     * @param {Object} data 节点数据
+     * @param {Object} node 节点对象
+     */
     function handleNodeExpand(data, node) {
       const key = data[treeNodeKey];
       if (key && !expandedKeys.value.includes(key)) {
@@ -1677,7 +1731,10 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       }
     }
 
-    // 节点折叠回调（受控模式同步）
+    /** @description 节点折叠回调（受控模式同步）
+     * @param {Object} data 节点数据
+     * @param {Object} node 节点对象
+     */
     function handleNodeCollapse(data, node) {
       const key = data[treeNodeKey];
       if (key) {
@@ -1685,7 +1742,11 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       }
     }
 
-    // 树节点过滤方法（搜索）
+    /** @description 树节点过滤方法（搜索）
+     * @param {String} value 搜索关键字
+     * @param {Object} data 节点数据
+     * @returns {Boolean} 是否匹配
+     */
     function filterTreeNode(value, data) {
       if (!value) return true;
       const keyword = value.toLowerCase();
@@ -1708,7 +1769,10 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       }
     }
 
-    // 树节点勾选事件
+    /** @description 树节点勾选事件
+     * @param {Object} data 节点数据
+     * @param {Object} checkedInfo 选中信息
+     */
     function handleTreeCheck(data, checkedInfo) {
       let currenNode = featureTreeRef.value.$refs.child.getNode(data);
       if (data.children) {
@@ -1724,7 +1788,10 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       updateCheckedKeys();
     }
 
-    // 树节点点击事件
+    /** @description 树节点点击事件
+     * @param {Object} data 节点数据
+     * @param {Object} node 节点对象
+     */
     function handleTreeNodeClick(data, node) {
       // 分类节点：切换展开/折叠
       if (data.children) {
@@ -1737,7 +1804,10 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       // 要素节点点击不展开（无 children）
     }
 
-    // 根据分类 key 切换该分类下所有要素的勾选状态
+    /** @description 根据分类 key 切换该分类下所有要素的勾选状态
+     * @param {String} categoryKey 分类 key
+     * @param {Boolean} checked 是否选中
+     */
     function toggleCategoryCheckByKey(categoryKey, checked) {
       const category = featureCategories.find(cat => cat.key === categoryKey);
       if (category && category.children) {
@@ -1749,7 +1819,9 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       updateCheckedKeys();
     }
 
-    // 通过节点数据编辑要素（树节点回调用）
+    /** @description 通过节点数据编辑要素（树节点回调用）
+     * @param {Object} data 节点数据
+     */
     function editFeatureFromNode(data) {
       const category = featureCategories.find(cat => cat.key === data.category);
       if (category) {
@@ -1757,12 +1829,16 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       }
     }
 
-    // 通过节点数据缩放至要素
+    /** @description 通过节点数据缩放至要素
+     * @param {Object} data 节点数据
+     */
     function zoomToFeatureByKey(data) {
       zoomToFeature(data);
     }
 
-    // 通过节点数据删除要素
+    /** @description 通过节点数据删除要素
+     * @param {Object} data 节点数据
+     */
     function deleteFeatureByKey(data) {
       const category = featureCategories.find(cat => cat.key === data.category);
       if (category) {
@@ -1770,14 +1846,17 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       }
     }
 
-    // 通过分类 key 添加要素
+    /** @description 通过分类 key 添加要素
+     * @param {String} categoryKey 分类 key
+     */
     function addFeatureByCategoryByKey(categoryKey) {
       const category = featureCategories.find(cat => cat.key === categoryKey);
       if (category) {
         addFeatureByCategory(category);
       }
     }
-    let featureTreeRef = (0, _vue.ref)(null);
+    let featureTreeRef = (0, _vue.ref)(null); // 树组件 Ref
+
     (0, _vue.onMounted)(() => {
       (0, _util.updatePosition)(boxRef.value, props);
       (0, _vue.watch)(() => props.position, newVal => (0, _util.updatePosition)(boxRef.value, props));
@@ -1817,7 +1896,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     };
 
     /**
-     * 地图准备好后，将已有 geojson 的要素渲染到地图
+     * @description 地图准备好后，将已有 geojson 的要素渲染到地图
+     * @param {LowAltitudeFeatureViewModel} vm 视图模型实例
      */
     function renderExistingFeatures(vm) {
       if (!vm) return;
@@ -1837,14 +1917,14 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     }
 
     /**
-     * 加载模拟示例数据
+     * @description 加载模拟示例数据
      */
     function loadMockData() {
       MOCK_FEATURE_S.forEach(item => addFeatureToTree(item));
     }
 
     /**
-     * 加载外部数据
+     * @description 加载外部数据
      */
     function loadExternalData() {
       if (props.loadLowAltitudeFeature) {
@@ -1859,7 +1939,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     }
 
     /**
-     * 将要素添加到树中，并渲染到地图
+     * @description 将要素添加到树中，并渲染到地图
+     * @param {Object} item 要素数据
      */
     function addFeatureToTree(item) {
       const category = featureCategories.find(cat => cat.key === item.category);
@@ -1905,7 +1986,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
 
     // ==================== 要素CRUD操作 ====================
     /**
-     * 通过一级分类添加要素
+     * @description 通过一级分类添加要素
+     * @param {Object} category 分类对象
      */
     function addFeatureByCategory(category) {
       isAddOrEdit.value = true;
@@ -1918,7 +2000,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     }
 
     /**
-     * 开始绘制
+     * @description 开始绘制
+     * @param {String} mode 绘制模式：point/polyline/polygon
      */
     function startDraw(mode) {
       if (!viewModel || !viewModel.isReady()) {
@@ -1970,7 +2053,9 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     }
 
     /**
-     * 编辑要素
+     * @description 编辑要素
+     * @param {Object} feature 要素对象
+     * @param {Object} category 所属分类对象
      */
     function editFeature(feature, category) {
       // 1. 先准备所有数据，暂不显示面板
@@ -2030,7 +2115,9 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     }
 
     /**
-     * 根据分类推断几何类型
+     * @description 根据分类推断几何类型
+     * @param {String} categoryKey 分类 key
+     * @returns {String} 几何类型：point/polyline/polygon
      */
     function inferGeometryFromCategory(categoryKey) {
       if (categoryKey === "hangar") return "point";
@@ -2039,7 +2126,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     }
 
     /**
-     * 缩放至要素
+     * @description 缩放至要素
+     * @param {Object} feature 要素对象
      */
     function zoomToFeature(feature) {
       if (!viewModel) {
@@ -2059,7 +2147,9 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     }
 
     /**
-     * 删除要素
+     * @description 删除要素
+     * @param {Object} feature 要素对象
+     * @param {Object} category 所属分类对象
      */
     function deleteFeature(feature, category) {
       const index = category.children.findIndex(f => f.id === feature.id);
@@ -2081,7 +2171,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     }
 
     /**
-     * 切换网格化显示
+     * @description 切换网格化显示
+     * @param {Object} feature 要素对象
      */
     function toggleGridDisplay(feature) {
       feature.gridDisplay = !feature.gridDisplay;
@@ -2095,7 +2186,9 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     }
 
     /**
-     * 更新实体可见性
+     * @description 更新实体可见性
+     * @param {Object} feature 要素对象
+     * @param {Boolean} checked 是否可见
      */
     function updateEntityVisibility(feature, checked) {
       if (viewModel) {
@@ -2104,6 +2197,9 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     }
 
     // ==================== GeoJSON 操作 ====================
+    /** @description 处理 GeoJSON 文件上传
+     * @param {Object} file 上传的文件对象
+     */
     function handleGeoJSONUpload(file) {
       const reader = new FileReader();
       reader.onload = e => {
@@ -2132,6 +2228,10 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       };
       reader.readAsText(file.raw);
     }
+
+    /** @description 根据 GeoJSON 自动推断几何类型
+     * @param {Object} geojson GeoJSON 对象
+     */
     function autoInferGeometryType(geojson) {
       let geomType = "";
       if (geojson.type === "FeatureCollection" && geojson.features && geojson.features.length > 0) {
@@ -2150,6 +2250,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         symbolSettings.shapeType = "faceData";
       }
     }
+
+    // 导出当前 GeoJSON 为文件
     function exportGeoJSON() {
       if (!currentGeoJSON) {
         (0, _message.default)({
@@ -2172,6 +2274,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         type: "success"
       });
     }
+
+    // 删除当前绘制中的要素
     function deleteCurrentDrawing() {
       removeCurrentEntities();
       currentGeoJSON = null;
@@ -2181,6 +2285,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         type: "success"
       });
     }
+
+    // 移除当前绘制产生的所有实体
     function removeCurrentEntities() {
       if (viewModel) {
         viewModel.removeCurrentDrawingEntities();
@@ -2189,6 +2295,9 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
     }
 
     // ==================== 表单操作 ====================
+    /** @description 要素分类变化回调，重置子类并同步绘图模式
+     * @param {String} val 分类 value
+     */
     function onFeatureClassChange(val) {
       // 仅当子类在当前分类下无效时才重置，避免编辑要素时被意外清空
       const validSubclasses = (subclassOptionsMap[val] || []).map(opt => opt.value);
@@ -2209,6 +2318,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         symbolSettings.bufferType = "cube";
       }
     }
+
+    // 重置表单数据及绘图状态
     function resetForm() {
       formData.code = "";
       formData.name = "";
@@ -2222,6 +2333,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       currentEditFeature = null;
       Object.assign(symbolSettings, defaultSymbolSettings());
     }
+
+    // 清空表单并清除绘制
     function clearForm() {
       resetForm();
       clearDrawHandler();
@@ -2231,6 +2344,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
         type: "info"
       });
     }
+
+    // 保存要素（新建或更新）
     function saveFeature() {
       // 验证要素编码
       if (!formData.code.trim()) {
@@ -2383,6 +2498,8 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       isEdit.value = false;
       resetForm();
     }
+
+    // 取消编辑/新增，关闭面板并清理状态
     function cancel() {
       isAddOrEdit.value = false;
       isEdit.value = false;
@@ -2390,9 +2507,13 @@ var _default = exports.A = /*@__PURE__*/Object.assign(__default__, {
       clearDrawHandler();
       removeCurrentEntities();
     }
+
+    // 切换右侧面板折叠状态
     function togglePanelCollapse() {
       panelCollapsed.value = !panelCollapsed.value;
     }
+
+    // 清除当前绘制事件处理器
     function clearDrawHandler() {
       if (viewModel) {
         viewModel.clearDraw();
@@ -3018,6 +3139,58 @@ var _default = exports.A = {
 
 /***/ }),
 
+/***/ 26188:
+/***/ (function(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+// ESM COMPAT FLAG
+__webpack_require__.r(__webpack_exports__);
+
+// EXPORTS
+__webpack_require__.d(__webpack_exports__, {
+  __esModule: function() { return /* reexport */ LowAltitudeFeaturevue_type_script_setup_true_lang_js/* __esModule */.B; },
+  "default": function() { return /* binding */ LowAltitudeFeature; }
+});
+
+// EXTERNAL MODULE: ./node_modules/babel-loader/lib/index.js??clonedRuleSet-1.use[0]!./node_modules/vue-loader/dist/index.js??ruleSet[0].use[0]!./src/webgl/lowaltitudefeature/LowAltitudeFeature.vue?vue&type=script&setup=true&lang=js
+var LowAltitudeFeaturevue_type_script_setup_true_lang_js = __webpack_require__(23043);
+;// ./src/webgl/lowaltitudefeature/LowAltitudeFeature.vue?vue&type=script&setup=true&lang=js
+ 
+// EXTERNAL MODULE: ./node_modules/style-loader/dist/runtime/injectStylesIntoStyleTag.js
+var injectStylesIntoStyleTag = __webpack_require__(85072);
+var injectStylesIntoStyleTag_default = /*#__PURE__*/__webpack_require__.n(injectStylesIntoStyleTag);
+// EXTERNAL MODULE: ./node_modules/css-loader/dist/cjs.js!./node_modules/vue-loader/dist/stylePostLoader.js!./node_modules/vue-loader/dist/index.js??ruleSet[0].use[0]!./src/webgl/lowaltitudefeature/LowAltitudeFeature.vue?vue&type=style&index=0&id=4aa57328&scoped=true&lang=css
+var LowAltitudeFeaturevue_type_style_index_0_id_4aa57328_scoped_true_lang_css = __webpack_require__(39502);
+;// ./node_modules/style-loader/dist/cjs.js!./node_modules/css-loader/dist/cjs.js!./node_modules/vue-loader/dist/stylePostLoader.js!./node_modules/vue-loader/dist/index.js??ruleSet[0].use[0]!./src/webgl/lowaltitudefeature/LowAltitudeFeature.vue?vue&type=style&index=0&id=4aa57328&scoped=true&lang=css
+
+            
+
+var options = {};
+
+options.insert = "head";
+options.singleton = false;
+
+var update = injectStylesIntoStyleTag_default()(LowAltitudeFeaturevue_type_style_index_0_id_4aa57328_scoped_true_lang_css/* default */.A, options);
+
+
+
+/* harmony default export */ var lowaltitudefeature_LowAltitudeFeaturevue_type_style_index_0_id_4aa57328_scoped_true_lang_css = (LowAltitudeFeaturevue_type_style_index_0_id_4aa57328_scoped_true_lang_css/* default */.A.locals || {});
+;// ./src/webgl/lowaltitudefeature/LowAltitudeFeature.vue?vue&type=style&index=0&id=4aa57328&scoped=true&lang=css
+
+// EXTERNAL MODULE: ./node_modules/vue-loader/dist/exportHelper.js
+var exportHelper = __webpack_require__(66262);
+;// ./src/webgl/lowaltitudefeature/LowAltitudeFeature.vue
+
+
+
+;
+
+
+const __exports__ = /*#__PURE__*/(0,exportHelper/* default */.A)(LowAltitudeFeaturevue_type_script_setup_true_lang_js/* default */.A, [['__scopeId',"data-v-4aa57328"]])
+
+/* harmony default export */ var LowAltitudeFeature = (__exports__);
+
+/***/ }),
+
 /***/ 26331:
 /***/ (function(__unused_webpack_module, exports, __webpack_require__) {
 
@@ -3198,6 +3371,22 @@ _Form.default.install = (Vue, opts) => {
 _KqGIS.kq_npm_client_common_vue.KqForm = _Form.default;
 _KqGIS.kq_npm_client_common_vue.KqFormItem = _FormItem.default;
 
+/***/ }),
+
+/***/ 39502:
+/***/ (function(module, __webpack_exports__, __webpack_require__) {
+
+/* harmony import */ var _node_modules_css_loader_dist_runtime_api_js__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(76314);
+/* harmony import */ var _node_modules_css_loader_dist_runtime_api_js__WEBPACK_IMPORTED_MODULE_0___default = /*#__PURE__*/__webpack_require__.n(_node_modules_css_loader_dist_runtime_api_js__WEBPACK_IMPORTED_MODULE_0__);
+// Imports
+
+var ___CSS_LOADER_EXPORT___ = _node_modules_css_loader_dist_runtime_api_js__WEBPACK_IMPORTED_MODULE_0___default()(function(i){return i[1]});
+// Module
+___CSS_LOADER_EXPORT___.push([module.id, "\n.kq-laf-geometry-status[data-v-4aa57328] {\n  display: flex;\n  align-items: center;\n  gap: 6px;\n  padding: 8px 12px;\n  margin: 10px 0;\n  border-radius: 4px;\n  background-color: #fef0f0;\n  border: 1px solid #fde2e2;\n  color: #f56c6c;\n  font-size: 12px;\n}\n.kq-laf-geometry-status.has-geometry[data-v-4aa57328] {\n  background-color: #f0f9eb;\n  border-color: #e1f3d8;\n  color: #67c23a;\n}\n.kq-laf-status-text[data-v-4aa57328] {\n  flex: 1;\n}\n", ""]);
+// Exports
+/* harmony default export */ __webpack_exports__.A = (___CSS_LOADER_EXPORT___);
+
+
 /***/ }),
 
 /***/ 39640:
@@ -3843,22 +4032,6 @@ const __exports__ = Dividervue_type_script_lang_js/* default */.A;
 
 module.exports = __WEBPACK_EXTERNAL_MODULE__74383__;
 
-/***/ }),
-
-/***/ 74703:
-/***/ (function(module, __webpack_exports__, __webpack_require__) {
-
-/* harmony import */ var _node_modules_css_loader_dist_runtime_api_js__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(76314);
-/* harmony import */ var _node_modules_css_loader_dist_runtime_api_js__WEBPACK_IMPORTED_MODULE_0___default = /*#__PURE__*/__webpack_require__.n(_node_modules_css_loader_dist_runtime_api_js__WEBPACK_IMPORTED_MODULE_0__);
-// Imports
-
-var ___CSS_LOADER_EXPORT___ = _node_modules_css_loader_dist_runtime_api_js__WEBPACK_IMPORTED_MODULE_0___default()(function(i){return i[1]});
-// Module
-___CSS_LOADER_EXPORT___.push([module.id, "\n.kq-laf-geometry-status[data-v-b3c8fafe] {\n  display: flex;\n  align-items: center;\n  gap: 6px;\n  padding: 8px 12px;\n  margin: 10px 0;\n  border-radius: 4px;\n  background-color: #fef0f0;\n  border: 1px solid #fde2e2;\n  color: #f56c6c;\n  font-size: 12px;\n}\n.kq-laf-geometry-status.has-geometry[data-v-b3c8fafe] {\n  background-color: #f0f9eb;\n  border-color: #e1f3d8;\n  color: #67c23a;\n}\n.kq-laf-status-text[data-v-b3c8fafe] {\n  flex: 1;\n}\n", ""]);
-// Exports
-/* harmony default export */ __webpack_exports__.A = (___CSS_LOADER_EXPORT___);
-
-
 /***/ }),
 
 /***/ 75797:
@@ -4717,11 +4890,11 @@ Object.defineProperty(exports, "__esModule", ({
   value: true
 }));
 exports.kq_npm_client_leaflet_vue = exports.kq_npm_client_common_vue = exports.kq_npm_client3d_webgl_vue = void 0;
-let kq_npm_client_common_vue = exports.kq_npm_client_common_vue = window.kq_npm_client_common_vue = window.kq_npm_client_common_vue || {};
+const kq_npm_client_common_vue = exports.kq_npm_client_common_vue = window.kq_npm_client_common_vue = window.kq_npm_client_common_vue || {};
 __webpack_require__.g.kq_npm_client_common_vue = kq_npm_client_common_vue;
-let kq_npm_client_leaflet_vue = exports.kq_npm_client_leaflet_vue = window.kq_npm_client_leaflet_vue = window.kq_npm_client_leaflet_vue || {};
+const kq_npm_client_leaflet_vue = exports.kq_npm_client_leaflet_vue = window.kq_npm_client_leaflet_vue = window.kq_npm_client_leaflet_vue || {};
 __webpack_require__.g.kq_npm_client_leaflet_vue = kq_npm_client_leaflet_vue;
-let kq_npm_client3d_webgl_vue = exports.kq_npm_client3d_webgl_vue = window.kq_npm_client3d_webgl_vue = window.kq_npm_client3d_webgl_vue || {};
+const kq_npm_client3d_webgl_vue = exports.kq_npm_client3d_webgl_vue = window.kq_npm_client3d_webgl_vue = window.kq_npm_client3d_webgl_vue || {};
 __webpack_require__.g.kq_npm_client3d_webgl_vue = kq_npm_client3d_webgl_vue;
 
 /***/ })
@@ -4833,7 +5006,7 @@ Object.defineProperty(exports, "default", ({
     return _LowAltitudeFeature.default;
   }
 }));
-var _LowAltitudeFeature = _interopRequireDefault(__webpack_require__(11583));
+var _LowAltitudeFeature = _interopRequireDefault(__webpack_require__(26188));
 var _LowAltitudeFeatureViewModel = _interopRequireDefault(__webpack_require__(4494));
 var _init = _interopRequireDefault(__webpack_require__(20455));
 /*