@jorgmoritz/gis-manager 0.1.31 → 0.1.32

package/dist/index.cjs

@@ -13,7 +13,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // package.json
 var package_default = {
   name: "@jorgmoritz/gis-manager",
-  version: "0.1.30"};
+  version: "0.1.31"};
 
 // src/utils/version.ts
 var version = package_default.version;
@@ -1330,12 +1330,10 @@ var StateManager = class {
     __publicField(this, "editing", false);
     __publicField(this, "editingTarget");
     __publicField(this, "previousView");
-    __publicField(this, "flightPreviewing", false);
     // Emitters
     __publicField(this, "onSelectionChange", new Emitter());
     __publicField(this, "onEditingChange", new Emitter());
     __publicField(this, "onPreviousViewChange", new Emitter());
-    __publicField(this, "onFlightPreviewChange", new Emitter());
   }
   // Selection
   setSelected(next) {
@@ -1382,35 +1380,6 @@ var StateManager = class {
   getPreviousCameraView() {
     return this.previousView;
   }
-  // Flight preview mode
-  /**
-   * 开始飞行预览模式（锁定交互）
-   */
-  startFlightPreview() {
-    if (this.flightPreviewing) return;
-    this.flightPreviewing = true;
-    this.onFlightPreviewChange.emit({ previewing: true });
-  }
-  /**
-   * 停止飞行预览模式（恢复交互）
-   */
-  stopFlightPreview() {
-    if (!this.flightPreviewing) return;
-    this.flightPreviewing = false;
-    this.onFlightPreviewChange.emit({ previewing: false });
-  }
-  /**
-   * 检查是否处于飞行预览模式
-   */
-  isFlightPreviewing() {
-    return this.flightPreviewing;
-  }
-  /**
-   * 检查当前是否允许交互（非编辑模式且非飞行预览模式）
-   */
-  isInteractionAllowed() {
-    return !this.editing && !this.flightPreviewing;
-  }
 };
 var globalState = new StateManager();
 
@@ -2864,6 +2833,10 @@ var AirplaneCursor = class {
     __publicField(this, "pyramidEntities", []);
     // 临时数据源，用于存储金字塔实体（避免污染宿主图层）
     __publicField(this, "pyramidLayer");
+    // 缓存的缩放因子，仅在相机变化时更新
+    __publicField(this, "cachedScaleFactor", 1);
+    // 相机变化事件监听器
+    __publicField(this, "cameraChangedListener");
     const C = this.CesiumNS;
     this.opts = opts;
     this.pose = { position: startPosition, heading: 0, pitch: -10, roll: 0 };
@@ -2883,14 +2856,39 @@ var AirplaneCursor = class {
       this.viewer.dataSources.add(this.pyramidLayer);
     }
     const modelHeadingOffset = 270;
-    const modelVerticalOffset = 35;
-    const modelForwardOffset = 5;
-    const modelRightOffset = -30;
+    const baseVerticalOffset = 10;
+    const baseForwardOffset = 5;
+    const baseRightOffset = -9;
+    const baseScale = 0.15;
+    const minScale = 0.025;
+    const maxScale = 1.5;
+    const referenceDistance = 800;
+    const computeScaleFactor = () => {
+      try {
+        const cameraPos = this.viewer.camera.positionWC;
+        const modelPos = this.pose.position;
+        const distance = C.Cartesian3.distance(cameraPos, modelPos);
+        const rawScale = baseScale * (distance / referenceDistance);
+        const clampedScale = Math.max(minScale, Math.min(maxScale, rawScale));
+        return clampedScale / baseScale;
+      } catch {
+        return 1;
+      }
+    };
+    this.cachedScaleFactor = computeScaleFactor();
+    this.cameraChangedListener = this.viewer.camera.changed.addEventListener(() => {
+      this.cachedScaleFactor = computeScaleFactor();
+      this.viewer.scene?.requestRender?.();
+    });
     this.modelEntity = this.pyramidLayer.entities.add({
       position: new C.CallbackProperty(() => {
         const pos = this.pose.position;
         const headingRad = C.Math.toRadians(this.pose.heading);
         const pitchRad = C.Math.toRadians(this.pose.pitch);
+        const scaleFactor = this.cachedScaleFactor;
+        const modelVerticalOffset = baseVerticalOffset * scaleFactor;
+        const modelForwardOffset = baseForwardOffset * scaleFactor;
+        const modelRightOffset = baseRightOffset * scaleFactor;
         const enu = C.Transforms.eastNorthUpToFixedFrame(pos);
         const east = C.Cartesian3.fromCartesian4(C.Matrix4.getColumn(enu, 0, new C.Cartesian4()));
         const north = C.Cartesian3.fromCartesian4(C.Matrix4.getColumn(enu, 1, new C.Cartesian4()));
@@ -2931,9 +2929,10 @@ var AirplaneCursor = class {
       }, false),
       model: {
         uri: wurenji_default,
-        scale: 0.5,
-        minimumPixelSize: 32,
-        maximumScale: 100,
+        scale: new C.CallbackProperty(() => {
+          return baseScale * this.cachedScaleFactor;
+        }, false),
+        minimumPixelSize: 24,
         silhouetteColor: C.Color.CYAN,
         silhouetteSize: 1
       },
@@ -3067,20 +3066,7 @@ var AirplaneCursor = class {
         moved = true;
       }
       if (this.keysPressed.has("z")) {
-        const newPos = addVec(pose.position, C.Cartesian3.multiplyByScalar(u3, -step, new C.Cartesian3()));
-        const cartographic = C.Cartographic.fromCartesian(newPos);
-        if (cartographic) {
-          const terrainHeight = this.viewer.scene.globe.getHeight(cartographic) ?? 0;
-          const minAltitude = terrainHeight + 1;
-          if (cartographic.height < minAltitude) {
-            cartographic.height = minAltitude;
-            setPos(C.Cartesian3.fromRadians(cartographic.longitude, cartographic.latitude, cartographic.height));
-          } else {
-            setPos(newPos);
-          }
-        } else {
-          setPos(newPos);
-        }
+        setPos(addVec(pose.position, C.Cartesian3.multiplyByScalar(u3, -step, new C.Cartesian3())));
         moved = true;
       }
       if (this.keysPressed.has("q")) {
@@ -3308,6 +3294,11 @@ var AirplaneCursor = class {
     } catch {
     }
     this.pyramidLayer = void 0;
+    try {
+      this.cameraChangedListener?.();
+    } catch {
+    }
+    this.cameraChangedListener = void 0;
     try {
       this.frustum?.destroy();
     } catch {
@@ -4626,34 +4617,6 @@ var PathEditingEventHandler = class {
    * 🆕 处理快速编辑模式的点击
    */
   handleQuickEditClick(movement) {
-    const C = this.CesiumNS;
-    try {
-      const picked = this.viewer.scene.pick?.(movement.position);
-      const entity = picked?.id;
-      if (entity?.properties) {
-        const props = entity.properties;
-        const vertexIndex = props._vertexIndex?.getValue?.() ?? props._vertexIndex;
-        const type = props._type?.getValue?.() ?? props._type;
-        if (typeof vertexIndex === "number" && (type === "path-vertex" || type === "vertex-label")) {
-          if (vertexIndex !== this.hiddenClimbIndex && vertexIndex !== 0) {
-            console.log("[QuickEdit] \u70B9\u51FB\u5230\u5DF2\u5B58\u5728\u822A\u70B9\uFF0C\u9009\u4E2D\u800C\u975E\u65B0\u589E:", vertexIndex);
-            if (this.callbacks.onVertexSelect) {
-              this.callbacks.onVertexSelect(vertexIndex);
-            }
-            if (this.callbacks.onVertexSelectDetail) {
-              try {
-                const detailInfo = this.buildVertexDetailInfo(vertexIndex);
-                this.callbacks.onVertexSelectDetail(detailInfo);
-              } catch (error) {
-                console.error("Error building vertex detail info:", error);
-              }
-            }
-            return;
-          }
-        }
-      }
-    } catch (error) {
-    }
     const position = this.getPositionFromMouse(movement);
     if (!position) {
       console.warn("[QuickEdit] \u65E0\u6CD5\u83B7\u53D6\u70B9\u51FB\u4F4D\u7F6E");
@@ -4662,6 +4625,7 @@ var PathEditingEventHandler = class {
     const quickEditOptions = this.callbacks.getQuickEditOptions?.();
     if (!quickEditOptions) return;
     const { climbHeight, altitudeMode } = quickEditOptions;
+    const C = this.CesiumNS;
     const originalCarto = C.Cartographic.fromCartesian(position);
     const originalHeight = originalCarto.height;
     const newPosition = this.applyClimbHeight(position, climbHeight, altitudeMode);
@@ -5516,10 +5480,6 @@ function startPathEditing(CesiumNS, viewer, entityOrId, options) {
   );
   const cleanupSession = () => {
     setActiveIndex(void 0);
-    try {
-      preview?.destroy();
-    } catch {
-    }
     try {
       handles.forEach((handle) => {
         if (handle) {
@@ -5929,6 +5889,13 @@ var ArrowShape = class {
     __publicField(this, "baseAlpha");
     __publicField(this, "outline");
     __publicField(this, "outlineColor");
+    // 动态缩放相关
+    __publicField(this, "dynamicScale");
+    __publicField(this, "viewer");
+    __publicField(this, "referenceDistance");
+    __publicField(this, "minScale");
+    __publicField(this, "maxScale");
+    __publicField(this, "cachedScaleFactor", 1);
     const C = this.CesiumNS;
     this.shaftHeight = opts.shaftHeight ?? 17;
     this.headHeight = opts.headHeight ?? 8;
@@ -5936,12 +5903,17 @@ var ArrowShape = class {
     this.shaftRadius = opts.shaftRadius ?? 3;
     this.headRadius = opts.headRadius ?? 6;
     this.baseRadius = opts.baseRadius ?? 8;
-    this.color = opts.color ? C.Color.fromCssColorString(opts.color) : C.Color.fromCssColorString("#2E77FB");
+    this.color = opts.color ? C.Color.fromCssColorString(opts.color) : C.Color.fromCssColorString("#FFD700");
     this.shaftAlpha = opts.shaftAlpha ?? 1;
     this.headAlpha = opts.headAlpha ?? 1;
-    this.baseAlpha = opts.baseAlpha ?? 1;
+    this.baseAlpha = opts.baseAlpha ?? 0.65;
     this.outline = opts.outline ?? false;
     this.outlineColor = opts.outlineColor ? C.Color.fromCssColorString(opts.outlineColor) : this.color.darken(0.3, new C.Color());
+    this.dynamicScale = opts.dynamicScale ?? false;
+    this.viewer = opts.viewer;
+    this.referenceDistance = opts.referenceDistance ?? 500;
+    this.minScale = opts.minScale ?? 0.3;
+    this.maxScale = opts.maxScale ?? 3;
   }
   /**
    * Create arrow entities at given position
@@ -5959,22 +5931,40 @@ var ArrowShape = class {
     const carto = C.Cartographic.fromCartesian(position);
     const lon = C.Math.toDegrees(carto.longitude);
     const lat = C.Math.toDegrees(carto.latitude);
-    const shaftPosition = C.Cartesian3.fromDegrees(lon, lat, baseHeight + this.shaftHeight / 2);
-    const headPosition = C.Cartesian3.fromDegrees(
-      lon,
-      lat,
-      baseHeight + this.shaftHeight + this.headHeight / 2
-    );
+    const computeScaleFactor = () => {
+      if (!this.dynamicScale || !this.viewer) return 1;
+      try {
+        const cameraPos = this.viewer.camera.positionWC;
+        const distance = C.Cartesian3.distance(cameraPos, position);
+        const rawScale = distance / this.referenceDistance;
+        return Math.max(this.minScale, Math.min(this.maxScale, rawScale));
+      } catch {
+        return 1;
+      }
+    };
+    if (this.dynamicScale && this.viewer) {
+      this.viewer.scene.preRender.addEventListener(() => {
+        this.cachedScaleFactor = computeScaleFactor();
+      });
+    }
     const hpr = new C.HeadingPitchRoll(0, 0, 0);
     const baseOrientation = C.Transforms.headingPitchRollQuaternion(position, hpr);
     const fixedOrientation = new C.ConstantProperty(baseOrientation);
+    const getShaftPosition = () => {
+      const scale = this.cachedScaleFactor;
+      return C.Cartesian3.fromDegrees(lon, lat, baseHeight + this.shaftHeight * scale / 2);
+    };
+    const getHeadPosition = () => {
+      const scale = this.cachedScaleFactor;
+      return C.Cartesian3.fromDegrees(lon, lat, baseHeight + this.shaftHeight * scale + this.headHeight * scale / 2);
+    };
     const shaftEntity = layer.entities.add({
-      position: new C.ConstantPositionProperty(shaftPosition),
+      position: this.dynamicScale ? new C.CallbackProperty(getShaftPosition, false) : new C.ConstantPositionProperty(C.Cartesian3.fromDegrees(lon, lat, baseHeight + this.shaftHeight / 2)),
       orientation: fixedOrientation,
       cylinder: {
-        length: this.shaftHeight,
-        topRadius: this.shaftRadius,
-        bottomRadius: this.shaftRadius,
+        length: this.dynamicScale ? new C.CallbackProperty(() => this.shaftHeight * this.cachedScaleFactor, false) : this.shaftHeight,
+        topRadius: this.dynamicScale ? new C.CallbackProperty(() => this.shaftRadius * this.cachedScaleFactor, false) : this.shaftRadius,
+        bottomRadius: this.dynamicScale ? new C.CallbackProperty(() => this.shaftRadius * this.cachedScaleFactor, false) : this.shaftRadius,
         material: this.color.withAlpha(this.shaftAlpha),
         outline: this.outline,
         outlineColor: this.outlineColor,
@@ -5987,13 +5977,13 @@ var ArrowShape = class {
     });
     entities.push(shaftEntity);
     const headEntity = layer.entities.add({
-      position: new C.ConstantPositionProperty(headPosition),
+      position: this.dynamicScale ? new C.CallbackProperty(getHeadPosition, false) : new C.ConstantPositionProperty(C.Cartesian3.fromDegrees(lon, lat, baseHeight + this.shaftHeight + this.headHeight / 2)),
       orientation: fixedOrientation,
       cylinder: {
-        length: this.headHeight,
+        length: this.dynamicScale ? new C.CallbackProperty(() => this.headHeight * this.cachedScaleFactor, false) : this.headHeight,
         topRadius: 0,
         // Creates cone shape
-        bottomRadius: this.headRadius,
+        bottomRadius: this.dynamicScale ? new C.CallbackProperty(() => this.headRadius * this.cachedScaleFactor, false) : this.headRadius,
         material: this.color.withAlpha(this.headAlpha),
         outline: this.outline,
         outlineColor: this.outlineColor,
@@ -6008,8 +5998,8 @@ var ArrowShape = class {
     const baseEntity = layer.entities.add({
       position,
       ellipse: {
-        semiMajorAxis: this.baseRadius,
-        semiMinorAxis: this.baseRadius,
+        semiMajorAxis: this.dynamicScale ? new C.CallbackProperty(() => this.baseRadius * this.cachedScaleFactor, false) : this.baseRadius,
+        semiMinorAxis: this.dynamicScale ? new C.CallbackProperty(() => this.baseRadius * this.cachedScaleFactor, false) : this.baseRadius,
         height: baseHeight,
         material: this.color.withAlpha(this.baseAlpha),
         outline: this.outline,
@@ -6148,7 +6138,13 @@ function startPathDrawing(CesiumNS, viewer, options, onComplete) {
       color: "#FFD700",
       shaftAlpha: 1,
       headAlpha: 1,
-      baseAlpha: 0.5
+      baseAlpha: 0.5,
+      // 启用动态缩放，和无人机模型一样根据相机距离调整大小
+      dynamicScale: true,
+      viewer,
+      referenceDistance: 300,
+      minScale: 0.3,
+      maxScale: 2
     });
     const arrowEntities = arrowShape.createEntities(
       layer,
@@ -6665,7 +6661,13 @@ function renderFlightPath(CesiumNS, viewer, options) {
         color: "#FFD700",
         shaftAlpha: 0.98,
         headAlpha: 0.98,
-        baseAlpha: 0.65
+        baseAlpha: 0.65,
+        // 启用动态缩放
+        dynamicScale: true,
+        viewer,
+        referenceDistance: 300,
+        minScale: 0.3,
+        maxScale: 2
       });
       arrowShape.createEntities(
         layer,
@@ -6789,515 +6791,6 @@ function renderFlightPathPreview(CesiumNS, viewer, options) {
   return { entity, controller };
 }
 
-// src/core/path-manager/FlightPreviewController.ts
-var FlightPreviewController = class {
-  constructor(CesiumNS, viewer, options) {
-    this.CesiumNS = CesiumNS;
-    this.viewer = viewer;
-    this.options = options;
-    // ========== 状态 ==========
-    __publicField(this, "state", "stopped");
-    __publicField(this, "destroyed", false);
-    // ========== 配置 ==========
-    __publicField(this, "speed");
-    __publicField(this, "loop");
-    __publicField(this, "showFrustum");
-    __publicField(this, "trackHighlightOptions");
-    // ========== 路径数据 ==========
-    __publicField(this, "waypoints", []);
-    __publicField(this, "totalDistance", 0);
-    // ========== 动画状态 ==========
-    __publicField(this, "currentDistance", 0);
-    // 当前已飞行距离
-    __publicField(this, "animationFrameId");
-    __publicField(this, "lastFrameTime");
-    // ========== 可视化组件 ==========
-    __publicField(this, "layer");
-    __publicField(this, "droneEntity");
-    __publicField(this, "frustum");
-    __publicField(this, "pathPreview");
-    // ========== 轨迹高亮 ==========
-    __publicField(this, "traveledPathEntity");
-    __publicField(this, "remainingPathEntity");
-    // ========== 事件 ==========
-    __publicField(this, "onStateChange", new Emitter());
-    __publicField(this, "onProgressChange", new Emitter());
-    this.speed = options.speed ?? 10;
-    this.loop = options.loop ?? true;
-    this.showFrustum = options.showFrustum ?? true;
-    this.trackHighlightOptions = {
-      enabled: true,
-      traveledWidth: 6,
-      remainingWidth: 4,
-      ...options.trackHighlight
-    };
-    this.initLayer();
-    this.parseWaylineData();
-    this.initVisualization();
-    console.log("[FlightPreviewController] \u521D\u59CB\u5316\u5B8C\u6210", {
-      waypointCount: this.waypoints.length,
-      totalDistance: this.totalDistance,
-      speed: this.speed
-    });
-  }
-  // ==================== 公共方法 ====================
-  /** 开始预览 */
-  start() {
-    if (this.destroyed) return;
-    if (this.state === "playing") return;
-    if (this.state === "stopped") {
-      this.currentDistance = 0;
-    }
-    this.setState("playing");
-    this.lastFrameTime = performance.now();
-    this.startAnimationLoop();
-    globalState.startFlightPreview();
-    this.pathPreview?.show();
-    console.log("[FlightPreviewController] \u5F00\u59CB\u64AD\u653E");
-  }
-  /** 暂停 */
-  pause() {
-    if (this.destroyed) return;
-    if (this.state !== "playing") return;
-    this.setState("paused");
-    this.stopAnimationLoop();
-    console.log("[FlightPreviewController] \u6682\u505C");
-  }
-  /** 继续 */
-  resume() {
-    if (this.destroyed) return;
-    if (this.state !== "paused") return;
-    this.setState("playing");
-    this.lastFrameTime = performance.now();
-    this.startAnimationLoop();
-    console.log("[FlightPreviewController] \u7EE7\u7EED\u64AD\u653E");
-  }
-  /** 停止并重置 */
-  stop() {
-    if (this.destroyed) return;
-    this.setState("stopped");
-    this.stopAnimationLoop();
-    this.currentDistance = 0;
-    globalState.stopFlightPreview();
-    this.updateVisualization();
-    this.pathPreview?.hide();
-    console.log("[FlightPreviewController] \u505C\u6B62");
-  }
-  /** 跳转到指定进度 (0-1) */
-  seek(progress) {
-    if (this.destroyed) return;
-    const clampedProgress = Math.max(0, Math.min(1, progress));
-    this.currentDistance = clampedProgress * this.totalDistance;
-    this.updateVisualization();
-    console.log("[FlightPreviewController] \u8DF3\u8F6C\u5230", (clampedProgress * 100).toFixed(1) + "%");
-  }
-  /** 设置速度 */
-  setSpeed(speed) {
-    this.speed = Math.max(1, speed);
-    console.log("[FlightPreviewController] \u8BBE\u7F6E\u901F\u5EA6:", this.speed, "m/s");
-  }
-  /** 获取当前状态 */
-  getState() {
-    return this.state;
-  }
-  /** 获取当前进度 (0-1) */
-  getProgress() {
-    if (this.totalDistance === 0) return 0;
-    return this.currentDistance / this.totalDistance;
-  }
-  /** 获取当前航点索引 */
-  getCurrentWaypointIndex() {
-    return this.findCurrentSegment().segmentIndex;
-  }
-  /** 销毁 */
-  destroy() {
-    if (this.destroyed) return;
-    this.destroyed = true;
-    this.stopAnimationLoop();
-    globalState.stopFlightPreview();
-    this.destroyVisualization();
-    this.onStateChange.clear();
-    this.onProgressChange.clear();
-    console.log("[FlightPreviewController] \u5DF2\u9500\u6BC1");
-  }
-  // ==================== 私有方法 - 初始化 ====================
-  /** 初始化图层 */
-  initLayer() {
-    const C = this.CesiumNS;
-    if (this.options.layer) {
-      this.layer = this.options.layer;
-    } else {
-      const newLayer = new C.CustomDataSource("FlightPreviewLayer");
-      this.layer = newLayer;
-      this.viewer.dataSources.add(newLayer);
-    }
-  }
-  /** 解析航线数据 */
-  parseWaylineData() {
-    const C = this.CesiumNS;
-    const { waylineData } = this.options;
-    const converted = convertSinoflyWayline(waylineData, { CesiumNS: this.CesiumNS });
-    const waypointData = converted.waypointData;
-    if (!waypointData || waypointData.length < 2) {
-      console.warn("[FlightPreviewController] \u822A\u70B9\u6570\u91CF\u4E0D\u8DB3");
-      return;
-    }
-    let cumulativeDistance = 0;
-    for (let i = 0; i < waypointData.length; i++) {
-      const wp = waypointData[i];
-      let distanceToNext = 0;
-      if (i < waypointData.length - 1) {
-        const nextWp = waypointData[i + 1];
-        distanceToNext = C.Cartesian3.distance(wp.position, nextWp.position);
-      }
-      this.waypoints.push({
-        position: wp.position,
-        heading: wp.heading ?? 0,
-        pitch: wp.pitch ?? -10,
-        roll: wp.roll ?? 0,
-        distanceToNext,
-        cumulativeDistance
-      });
-      cumulativeDistance += distanceToNext;
-    }
-    this.totalDistance = cumulativeDistance;
-  }
-  /** 初始化可视化组件 */
-  initVisualization() {
-    this.initDroneModel();
-    this.initFrustum();
-    this.initTrackHighlight();
-    this.initPathPreview();
-    this.updateVisualization();
-  }
-  /** 初始化无人机模型 */
-  initDroneModel() {
-    if (!this.layer || this.waypoints.length === 0) return;
-    const C = this.CesiumNS;
-    const layer = this.layer;
-    const modelHeadingOffset = 270;
-    const modelVerticalOffset = 35;
-    const modelForwardOffset = 5;
-    const modelRightOffset = -30;
-    this.droneEntity = layer.entities.add({
-      position: new C.CallbackProperty(() => {
-        const { position, heading, pitch } = this.getCurrentPose();
-        return this.applyModelOffset(position, heading, pitch, {
-          forward: modelForwardOffset,
-          right: modelRightOffset,
-          up: modelVerticalOffset
-        });
-      }, false),
-      orientation: new C.CallbackProperty(() => {
-        const { position, heading, pitch, roll } = this.getCurrentPose();
-        const hpr = new C.HeadingPitchRoll(
-          C.Math.toRadians(heading + modelHeadingOffset),
-          C.Math.toRadians(pitch),
-          C.Math.toRadians(roll)
-        );
-        return C.Transforms.headingPitchRollQuaternion(position, hpr);
-      }, false),
-      model: {
-        uri: wurenji_default,
-        scale: 0.5,
-        minimumPixelSize: 32,
-        maximumScale: 100,
-        silhouetteColor: C.Color.CYAN,
-        silhouetteSize: 1
-      },
-      properties: { _type: "flight-preview-drone" }
-    });
-  }
-  /** 应用模型偏移 */
-  applyModelOffset(position, heading, pitch, offset) {
-    const C = this.CesiumNS;
-    const headingRad = C.Math.toRadians(heading);
-    const pitchRad = C.Math.toRadians(pitch);
-    const enu = C.Transforms.eastNorthUpToFixedFrame(position);
-    const east = C.Cartesian3.fromCartesian4(C.Matrix4.getColumn(enu, 0, new C.Cartesian4()));
-    const north = C.Cartesian3.fromCartesian4(C.Matrix4.getColumn(enu, 1, new C.Cartesian4()));
-    const up = C.Cartesian3.fromCartesian4(C.Matrix4.getColumn(enu, 2, new C.Cartesian4()));
-    const horizForward = C.Cartesian3.add(
-      C.Cartesian3.multiplyByScalar(east, Math.sin(headingRad), new C.Cartesian3()),
-      C.Cartesian3.multiplyByScalar(north, Math.cos(headingRad), new C.Cartesian3()),
-      new C.Cartesian3()
-    );
-    const right = C.Cartesian3.add(
-      C.Cartesian3.multiplyByScalar(east, Math.cos(headingRad), new C.Cartesian3()),
-      C.Cartesian3.multiplyByScalar(north, -Math.sin(headingRad), new C.Cartesian3()),
-      new C.Cartesian3()
-    );
-    const forward = C.Cartesian3.add(
-      C.Cartesian3.multiplyByScalar(horizForward, Math.cos(pitchRad), new C.Cartesian3()),
-      C.Cartesian3.multiplyByScalar(up, Math.sin(pitchRad), new C.Cartesian3()),
-      new C.Cartesian3()
-    );
-    const upRotated = C.Cartesian3.add(
-      C.Cartesian3.multiplyByScalar(horizForward, -Math.sin(pitchRad), new C.Cartesian3()),
-      C.Cartesian3.multiplyByScalar(up, Math.cos(pitchRad), new C.Cartesian3()),
-      new C.Cartesian3()
-    );
-    let result = C.Cartesian3.clone(position);
-    result = C.Cartesian3.add(result, C.Cartesian3.multiplyByScalar(forward, offset.forward, new C.Cartesian3()), result);
-    result = C.Cartesian3.add(result, C.Cartesian3.multiplyByScalar(right, offset.right, new C.Cartesian3()), result);
-    result = C.Cartesian3.add(result, C.Cartesian3.multiplyByScalar(upRotated, offset.up, new C.Cartesian3()), result);
-    return result;
-  }
-  /** 初始化视锥体 */
-  initFrustum() {
-    if (!this.showFrustum || !this.layer) return;
-    const C = this.CesiumNS;
-    this.frustum = new FrustumPyramid(this.CesiumNS, this.layer, {
-      fov: 50,
-      length: 500,
-      color: C.Color.CYAN,
-      fillAlpha: 0.25,
-      width: 2
-    });
-    this.frustum.showAtDynamic(
-      () => this.getCurrentPose().position,
-      () => this.getCurrentPose().heading,
-      () => this.getCurrentPose().pitch,
-      () => this.getCurrentPose().roll,
-      () => 50,
-      () => 500
-    );
-  }
-  /** 初始化轨迹高亮 */
-  initTrackHighlight() {
-    if (!this.trackHighlightOptions.enabled || !this.layer) return;
-    if (this.waypoints.length < 2) return;
-    const C = this.CesiumNS;
-    const layer = this.layer;
-    const traveledColor = this.trackHighlightOptions.traveledColor ?? C.Color.fromCssColorString("#00FF88");
-    const remainingColor = this.trackHighlightOptions.remainingColor ?? C.Color.fromCssColorString("#4A90D9").withAlpha(0.7);
-    this.traveledPathEntity = layer.entities.add({
-      polyline: {
-        positions: new C.CallbackProperty(() => this.getTraveledPositions(), false),
-        width: this.trackHighlightOptions.traveledWidth ?? 6,
-        material: traveledColor,
-        clampToGround: false
-      },
-      properties: { _type: "flight-preview-traveled" }
-    });
-    this.remainingPathEntity = layer.entities.add({
-      polyline: {
-        positions: new C.CallbackProperty(() => this.getRemainingPositions(), false),
-        width: this.trackHighlightOptions.remainingWidth ?? 4,
-        material: remainingColor,
-        clampToGround: false
-      },
-      properties: { _type: "flight-preview-remaining" }
-    });
-  }
-  /** 初始化预览窗口 */
-  initPathPreview() {
-    this.pathPreview = new PathPreview(
-      this.CesiumNS,
-      this.viewer,
-      {
-        container: this.options.previewContainer,
-        fov: 50,
-        pitch: -10,
-        useGlobalEventBus: true
-      }
-    );
-    this.pathPreview.hide();
-  }
-  // ==================== 私有方法 - 动画循环 ====================
-  /** 启动动画循环 */
-  startAnimationLoop() {
-    if (this.animationFrameId) return;
-    const animate = (currentTime) => {
-      if (this.state !== "playing" || this.destroyed) {
-        this.animationFrameId = void 0;
-        return;
-      }
-      const deltaTime = this.lastFrameTime ? (currentTime - this.lastFrameTime) / 1e3 : 0;
-      this.lastFrameTime = currentTime;
-      this.currentDistance += this.speed * deltaTime;
-      if (this.currentDistance >= this.totalDistance) {
-        if (this.loop) {
-          this.currentDistance = this.currentDistance % this.totalDistance;
-        } else {
-          this.currentDistance = this.totalDistance;
-          this.setState("stopped");
-          this.stopAnimationLoop();
-          return;
-        }
-      }
-      this.updateVisualization();
-      this.animationFrameId = requestAnimationFrame(animate);
-    };
-    this.animationFrameId = requestAnimationFrame(animate);
-  }
-  /** 停止动画循环 */
-  stopAnimationLoop() {
-    if (this.animationFrameId) {
-      cancelAnimationFrame(this.animationFrameId);
-      this.animationFrameId = void 0;
-    }
-    this.lastFrameTime = void 0;
-  }
-  // ==================== 私有方法 - 路径插值 ====================
-  /** 查找当前所在航段 */
-  findCurrentSegment() {
-    if (this.waypoints.length === 0) {
-      return { segmentIndex: 0, progressInSegment: 0 };
-    }
-    for (let i = 0; i < this.waypoints.length - 1; i++) {
-      const wp = this.waypoints[i];
-      const nextWp = this.waypoints[i + 1];
-      if (this.currentDistance <= nextWp.cumulativeDistance) {
-        const segmentStart = wp.cumulativeDistance;
-        const segmentLength = wp.distanceToNext;
-        const distanceInSegment = this.currentDistance - segmentStart;
-        const progressInSegment = segmentLength > 0 ? distanceInSegment / segmentLength : 0;
-        return { segmentIndex: i, progressInSegment };
-      }
-    }
-    return { segmentIndex: this.waypoints.length - 2, progressInSegment: 1 };
-  }
-  /** 获取当前姿态 */
-  getCurrentPose() {
-    if (this.waypoints.length === 0) {
-      const C = this.CesiumNS;
-      return {
-        position: new C.Cartesian3(),
-        heading: 0,
-        pitch: -10,
-        roll: 0
-      };
-    }
-    const { segmentIndex, progressInSegment } = this.findCurrentSegment();
-    const wp = this.waypoints[segmentIndex];
-    const nextWp = this.waypoints[Math.min(segmentIndex + 1, this.waypoints.length - 1)];
-    const position = this.interpolatePosition(wp.position, nextWp.position, progressInSegment);
-    const heading = this.interpolateAngle(wp.heading, nextWp.heading, progressInSegment);
-    const pitch = this.lerp(wp.pitch, nextWp.pitch, progressInSegment);
-    const roll = this.lerp(wp.roll, nextWp.roll, progressInSegment);
-    return { position, heading, pitch, roll };
-  }
-  /** 位置插值 */
-  interpolatePosition(start, end, t) {
-    const C = this.CesiumNS;
-    return C.Cartesian3.lerp(start, end, t, new C.Cartesian3());
-  }
-  /** 角度插值（处理 0-360 环绕） */
-  interpolateAngle(start, end, t) {
-    let diff = end - start;
-    if (diff > 180) diff -= 360;
-    if (diff < -180) diff += 360;
-    let result = start + diff * t;
-    return (result % 360 + 360) % 360;
-  }
-  /** 线性插值 */
-  lerp(start, end, t) {
-    return start + (end - start) * t;
-  }
-  // ==================== 私有方法 - 轨迹高亮 ====================
-  /** 获取已飞过的位置数组 */
-  getTraveledPositions() {
-    if (this.waypoints.length === 0) return [];
-    const { segmentIndex, progressInSegment } = this.findCurrentSegment();
-    const currentPos = this.getCurrentPose().position;
-    const positions = [];
-    for (let i = 0; i <= segmentIndex; i++) {
-      positions.push(this.waypoints[i].position);
-    }
-    if (progressInSegment > 0) {
-      positions.push(currentPos);
-    }
-    return positions;
-  }
-  /** 获取未飞过的位置数组 */
-  getRemainingPositions() {
-    if (this.waypoints.length === 0) return [];
-    const { segmentIndex } = this.findCurrentSegment();
-    const currentPos = this.getCurrentPose().position;
-    const positions = [];
-    positions.push(currentPos);
-    for (let i = segmentIndex + 1; i < this.waypoints.length; i++) {
-      positions.push(this.waypoints[i].position);
-    }
-    return positions;
-  }
-  // ==================== 私有方法 - 更新 ====================
-  /** 更新可视化 */
-  updateVisualization() {
-    const pose = this.getCurrentPose();
-    if (this.pathPreview) {
-      this.pathPreview.setPose(
-        pose.position,
-        pose.heading,
-        pose.pitch,
-        pose.roll
-      );
-    }
-    this.viewer.scene?.requestRender?.();
-    const { segmentIndex } = this.findCurrentSegment();
-    this.onProgressChange.emit({
-      progress: this.getProgress(),
-      position: pose.position,
-      waypointIndex: segmentIndex,
-      pose: {
-        heading: pose.heading,
-        pitch: pose.pitch,
-        roll: pose.roll
-      }
-    });
-  }
-  /** 设置状态 */
-  setState(newState) {
-    if (this.state !== newState) {
-      this.state = newState;
-      this.onStateChange.emit({ state: newState });
-    }
-  }
-  /** 销毁可视化组件 */
-  destroyVisualization() {
-    const layer = this.layer;
-    if (this.droneEntity && layer) {
-      try {
-        layer.entities.remove(this.droneEntity);
-      } catch {
-      }
-    }
-    if (this.traveledPathEntity && layer) {
-      try {
-        layer.entities.remove(this.traveledPathEntity);
-      } catch {
-      }
-    }
-    if (this.remainingPathEntity && layer) {
-      try {
-        layer.entities.remove(this.remainingPathEntity);
-      } catch {
-      }
-    }
-    try {
-      this.frustum?.destroy();
-    } catch {
-    }
-    try {
-      this.pathPreview?.destroy();
-    } catch {
-    }
-    if (!this.options.layer && this.layer) {
-      try {
-        this.viewer.dataSources.remove(this.layer);
-      } catch {
-      }
-    }
-    this.droneEntity = void 0;
-    this.traveledPathEntity = void 0;
-    this.remainingPathEntity = void 0;
-    this.frustum = void 0;
-    this.pathPreview = void 0;
-    this.layer = void 0;
-  }
-};
-
 // src/core/CZMLPathManager.ts
 var _CZMLPathManager = class _CZMLPathManager {
   constructor(CesiumNS, viewer) {
@@ -7411,50 +6904,6 @@ var _CZMLPathManager = class _CZMLPathManager {
   renderFlightPathPreview(options) {
     return renderFlightPathPreview(this.CesiumNS, this.viewer, options);
   }
-  /**
-   * 开始飞行预览：飞机沿航线飞行动画
-   * 
-   * 功能：
-   * - 飞机游标沿航线从起点飞到终点，循环播放
-   * - 预览窗口实时显示飞机第一人称视角
-   * - 轨迹高亮显示已飞过/未飞过的航段
-   * - 预览模式下禁止选择/编辑航线、航点
-   * 
-   * @param options 飞行预览选项
-   * @returns 飞行预览控制器
-   * 
-   * @example
-   * ```typescript
-   * const preview = pathManager.startFlightPreview({
-   *   waylineData: myWayline,
-   *   speed: 15,          // 飞行速度 15m/s
-   *   loop: true,         // 循环播放
-   *   trackHighlight: {
-   *     enabled: true,
-   *     traveledColor: Cesium.Color.fromCssColorString('#00FF88'),
-   *     remainingColor: Cesium.Color.fromCssColorString('#4A90D9'),
-   *   },
-   * });
-   * 
-   * preview.start();  // 开始播放
-   * preview.pause();  // 暂停
-   * preview.resume(); // 继续
-   * preview.stop();   // 停止
-   * preview.seek(0.5); // 跳转到 50%
-   * preview.setSpeed(20); // 设置速度
-   * 
-   * // 监听进度变化
-   * preview.onProgressChange.on(({ progress, waypointIndex }) => {
-   *   console.log(`进度: ${(progress * 100).toFixed(1)}%`);
-   * });
-   * 
-   * // 销毁
-   * preview.destroy();
-   * ```
-   */
-  startFlightPreview(options) {
-    return new FlightPreviewController(this.CesiumNS, this.viewer, options);
-  }
   resolveEntity(entityOrId) {
     return typeof entityOrId === "string" ? this.viewer.entities.getById(entityOrId) : entityOrId;
   }
@@ -7650,6 +7099,8 @@ var PolygonEditor = class {
     __publicField(this, "keydownHandler");
     // 保存编码前的原始名称,用于还原
     __publicField(this, "originalPolygonNames", /* @__PURE__ */ new Map());
+    // 保存双击缩放是否被禁用的状态
+    __publicField(this, "doubleClickZoomDisabled", false);
   }
   /**
    * 根据图层名称获取颜色配置
@@ -7924,12 +7375,62 @@ var PolygonEditor = class {
     }
     this.handler = void 0;
   }
+  /**
+   * 禁用 Cesium 默认的双击缩放行为
+   * 在绘制/编辑过程中调用，防止双击导致相机乱飞
+   */
+  disableDoubleClickZoom() {
+    if (this.doubleClickZoomDisabled) return;
+    try {
+      const C = this.CesiumNS;
+      const cesiumWidget = this.viewer.cesiumWidget;
+      if (cesiumWidget?.screenSpaceEventHandler) {
+        cesiumWidget.screenSpaceEventHandler.removeInputAction(
+          C.ScreenSpaceEventType.LEFT_DOUBLE_CLICK
+        );
+        this.doubleClickZoomDisabled = true;
+      }
+    } catch (e) {
+      console.warn("[PolygonEditor] \u7981\u7528\u53CC\u51FB\u7F29\u653E\u5931\u8D25:", e);
+    }
+  }
+  /**
+   * 恢复 Cesium 默认的双击缩放行为
+   * 在绘制/编辑结束后调用
+   */
+  restoreDoubleClickZoom() {
+    if (!this.doubleClickZoomDisabled) return;
+    try {
+      const C = this.CesiumNS;
+      const viewer = this.viewer;
+      const cesiumWidget = viewer.cesiumWidget;
+      if (cesiumWidget?.screenSpaceEventHandler) {
+        cesiumWidget.screenSpaceEventHandler.setInputAction(
+          (movement) => {
+            try {
+              const pickedObject = viewer.scene.pick(movement.position);
+              if (pickedObject?.id && viewer.trackedEntity !== pickedObject.id) {
+                viewer.flyTo(pickedObject.id, { duration: 1.5 });
+              }
+            } catch {
+            }
+          },
+          C.ScreenSpaceEventType.LEFT_DOUBLE_CLICK
+        );
+        this.doubleClickZoomDisabled = false;
+      }
+    } catch (e) {
+      console.warn("[PolygonEditor] \u6062\u590D\u53CC\u51FB\u7F29\u653E\u5931\u8D25:", e);
+      this.doubleClickZoomDisabled = false;
+    }
+  }
   /**
    * 完成编辑/绘制的通用清理逻辑
    */
   finalizePolygonSession(layer, onComplete, entity) {
     this.destroyHandler();
     this.removeKeyboardListener();
+    this.restoreDoubleClickZoom();
     if (entity && onComplete) {
       onComplete(entity);
     }
@@ -7972,6 +7473,7 @@ var PolygonEditor = class {
     }
     this.clearAllPolygonHighlights();
     this.stopInternal(layer);
+    this.disableDoubleClickZoom();
     this.drawingPositions = [];
     this.drawHandles = [];
     this.rubberBandPoint = void 0;
@@ -8116,6 +7618,7 @@ var PolygonEditor = class {
     }
     this.destroyHandler();
     this.removeKeyboardListener();
+    this.restoreDoubleClickZoom();
   }
   /**
    * 开始编辑多边形
@@ -8127,6 +7630,7 @@ var PolygonEditor = class {
   startEditing(polygonEntity, layer, onComplete) {
     const C = this.CesiumNS;
     this.cleanupHandles(layer);
+    this.disableDoubleClickZoom();
     const colors = this.getColorConfig(layer.name);
     const line_color = colors.lineColor;
     const line_fina_color = colors.lineFinalColor;
@@ -9549,6 +9053,7 @@ var PolygonEditor = class {
     const nameStr = `circle_${(circleCount + 1).toString().padStart(2, "0")}`;
     this.clearAllPolygonHighlights();
     this.stopInternal();
+    this.disableDoubleClickZoom();
     let centerPosition = null;
     let currentRadius = 0;
     let tempCenterPoint;
@@ -9762,6 +9267,7 @@ var PolygonEditor = class {
       currentRadius = 0;
       this.destroyHandler();
       this.removeKeyboardListener();
+      this.restoreDoubleClickZoom();
     };
     this.handler && this.handler.setInputAction(
       cancelCircleDrawing,
@@ -9797,6 +9303,7 @@ var PolygonEditor = class {
     const line_fina_color = colors.lineFinalColor;
     this.clearAllPolygonHighlights();
     this.stopInternal();
+    this.disableDoubleClickZoom();
     let pointCount = 0;
     this.handler = new C.ScreenSpaceEventHandler(this.viewer.scene.canvas);
     this.handler && this.handler.setInputAction(
@@ -9891,6 +9398,7 @@ var PolygonEditor = class {
     const stopPointDrawing = () => {
       this.destroyHandler();
       this.removeKeyboardListener();
+      this.restoreDoubleClickZoom();
     };
     this.handler && this.handler.setInputAction(
       stopPointDrawing,
@@ -11396,6 +10904,368 @@ function convertPathToSinofly(data, options) {
   return sinoflyData;
 }
 
+// src/core/path-manager/PathSafetyChecker.ts
+var PathSafetyChecker = class {
+  constructor(CesiumNS, viewer) {
+    __publicField(this, "CesiumNS");
+    __publicField(this, "viewer");
+    this.CesiumNS = CesiumNS;
+    this.viewer = viewer;
+  }
+  /**
+   * 检测整条路径的安全性
+   * @param positions 航点位置数组
+   * @param options 检测选项
+   */
+  checkPath(positions, options) {
+    const defaultDistance = options?.safetyDistance ?? 20;
+    const terrainSafetyDistance = options?.terrainSafetyDistance ?? defaultDistance;
+    const pointCloudSafetyDistance = options?.pointCloudSafetyDistance ?? defaultDistance;
+    const minWaypointDistance = options?.minWaypointDistance ?? 0;
+    const sampleInterval = options?.sampleInterval ?? 5;
+    const results = [];
+    const startSegment = 1 ;
+    console.log("=".repeat(60));
+    console.log("[PathSafetyChecker] \u5F00\u59CB\u5B89\u5168\u68C0\u6D4B");
+    console.log(`  \u5730\u5F62\u5B89\u5168\u8DDD\u79BB: ${terrainSafetyDistance}m`);
+    console.log(`  \u70B9\u4E91\u5B89\u5168\u8DDD\u79BB: ${pointCloudSafetyDistance}m`);
+    if (minWaypointDistance > 0) {
+      console.log(`  \u822A\u70B9\u95F4\u6700\u5C0F\u8DDD\u79BB: ${minWaypointDistance}m`);
+    }
+    console.log(`  \u91C7\u6837\u95F4\u9694: ${sampleInterval}m`);
+    console.log(`  \u822A\u70B9\u603B\u6570: ${positions.length}`);
+    console.log(`  \u68C0\u6D4B\u822A\u6BB5: ${startSegment} ~ ${positions.length - 2}`);
+    console.log("=".repeat(60));
+    for (let i = startSegment; i < positions.length - 1; i++) {
+      const from = positions[i];
+      const to = positions[i + 1];
+      const segmentName = i === 1 ? "S" : String(i);
+      console.log(`
+[\u68C0\u6D4B\u822A\u6BB5 ${segmentName}]`);
+      const segmentResult = this.checkSegment(
+        from,
+        to,
+        i,
+        i + 1,
+        terrainSafetyDistance,
+        pointCloudSafetyDistance,
+        minWaypointDistance,
+        sampleInterval
+      );
+      results.push(segmentResult);
+      const terrainStatus = segmentResult.minTerrainDistance < 0 ? "\u2753" : segmentResult.isTerrainSafe ? "\u2705" : "\u26A0\uFE0F";
+      const pointCloudStatus = segmentResult.minPointCloudDistance < 0 ? "\u2705" : segmentResult.isPointCloudSafe ? "\u2705" : "\u26A0\uFE0F";
+      const terrainDistStr = segmentResult.minTerrainDistance < 0 ? "\u672A\u68C0\u6D4B\u5230" : `${segmentResult.minTerrainDistance.toFixed(1)}m`;
+      const pointCloudDistStr = segmentResult.minPointCloudDistance < 0 ? "\u65E0\u70B9\u4E91" : `${segmentResult.minPointCloudDistance.toFixed(1)}m`;
+      console.log(`  \u5730\u5F62\u8DDD\u79BB: ${terrainStatus} ${terrainDistStr} (\u8981\u6C42 >= ${terrainSafetyDistance}m)`);
+      console.log(`  \u70B9\u4E91\u8DDD\u79BB: ${pointCloudStatus} ${pointCloudDistStr} (\u8981\u6C42 >= ${pointCloudSafetyDistance}m)`);
+      if (minWaypointDistance > 0) {
+        const distanceStatus = segmentResult.isDistanceSafe ? "\u2705" : "\u26A0\uFE0F";
+        console.log(`  \u822A\u70B9\u95F4\u8DDD: ${distanceStatus} ${segmentResult.segmentLength.toFixed(1)}m (\u8981\u6C42 >= ${minWaypointDistance}m)`);
+      }
+      if (!segmentResult.isSafe) {
+        console.log(`  \u26A0\uFE0F \u8BE5\u822A\u6BB5\u4E0D\u5B89\u5168\uFF01\u5371\u9669\u70B9\u6570\u91CF: ${segmentResult.dangerPoints.length}`);
+      }
+    }
+    const unsafeSegments = results.filter((r) => !r.isSafe);
+    console.log("\n" + "=".repeat(60));
+    console.log("[PathSafetyChecker] \u68C0\u6D4B\u5B8C\u6210");
+    console.log(`  \u603B\u822A\u6BB5\u6570: ${results.length}`);
+    console.log(`  \u5B89\u5168\u822A\u6BB5: ${results.length - unsafeSegments.length}`);
+    console.log(`  \u5371\u9669\u822A\u6BB5: ${unsafeSegments.length}`);
+    if (unsafeSegments.length > 0) {
+      console.log("\n\u26A0\uFE0F \u5371\u9669\u822A\u6BB5\u8BE6\u60C5:");
+      unsafeSegments.forEach((seg) => {
+        const issues = [];
+        if (!seg.isTerrainSafe) {
+          issues.push(`\u5730\u5F62\u8DDD\u79BB ${seg.minTerrainDistance.toFixed(1)}m < ${terrainSafetyDistance}m`);
+        }
+        if (!seg.isPointCloudSafe) {
+          issues.push(`\u70B9\u4E91\u8DDD\u79BB ${seg.minPointCloudDistance.toFixed(1)}m < ${pointCloudSafetyDistance}m`);
+        }
+        if (!seg.isDistanceSafe) {
+          issues.push(`\u822A\u70B9\u95F4\u8DDD ${seg.segmentLength.toFixed(1)}m < ${minWaypointDistance}m`);
+        }
+        const segName = seg.fromIndex === 1 ? "S" : String(seg.fromIndex);
+        console.log(`  \u822A\u6BB5 ${segName}: ${issues.join(", ")}`);
+      });
+    }
+    console.log("=".repeat(60));
+    return {
+      allSafe: unsafeSegments.length === 0,
+      segments: results,
+      unsafeSegments,
+      terrainSafetyDistance,
+      pointCloudSafetyDistance,
+      minWaypointDistance
+    };
+  }
+  /**
+   * 检测单个航段的安全性
+   * 支持多方向检测（上下左右前后6方向）和按间隔采样
+   */
+  checkSegment(from, to, fromIndex, toIndex, terrainSafetyDistance, pointCloudSafetyDistance, minWaypointDistance, sampleInterval) {
+    const C = this.CesiumNS;
+    const scene = this.viewer.scene;
+    const dangerPoints = [];
+    let minTerrainDistance = Infinity;
+    let minPointCloudDistance = Infinity;
+    const segmentLength = C.Cartesian3.distance(from, to);
+    const sampleCount = Math.max(2, Math.ceil(segmentLength / sampleInterval) + 1);
+    for (let i = 0; i < sampleCount; i++) {
+      const t = i / (sampleCount - 1);
+      const samplePoint = C.Cartesian3.lerp(from, to, t, new C.Cartesian3());
+      const cartographic = C.Cartographic.fromCartesian(samplePoint);
+      const sampleHeight = cartographic.height;
+      try {
+        const terrainHeight = scene.globe.getHeight(cartographic);
+        if (terrainHeight !== void 0 && terrainHeight !== null) {
+          const terrainDistance = sampleHeight - terrainHeight;
+          minTerrainDistance = Math.min(minTerrainDistance, terrainDistance);
+          if (terrainDistance < terrainSafetyDistance) {
+            dangerPoints.push(C.Cartesian3.clone(samplePoint));
+          }
+        }
+      } catch (e) {
+      }
+      if (pointCloudSafetyDistance <= 0) {
+        continue;
+      }
+      try {
+        const forward = C.Cartesian3.subtract(to, from, new C.Cartesian3());
+        C.Cartesian3.normalize(forward, forward);
+        const localUp = C.Cartesian3.normalize(samplePoint, new C.Cartesian3());
+        let right = C.Cartesian3.cross(forward, localUp, new C.Cartesian3());
+        let rightMag = C.Cartesian3.magnitude(right);
+        if (rightMag < 1e-3) {
+          right = C.Cartesian3.cross(forward, new C.Cartesian3(1, 0, 0), new C.Cartesian3());
+          rightMag = C.Cartesian3.magnitude(right);
+          if (rightMag < 1e-3) {
+            right = C.Cartesian3.cross(forward, new C.Cartesian3(0, 1, 0), new C.Cartesian3());
+            rightMag = C.Cartesian3.magnitude(right);
+          }
+        }
+        if (rightMag > 1e-3) {
+          C.Cartesian3.normalize(right, right);
+        } else {
+          continue;
+        }
+        const up2 = C.Cartesian3.cross(right, forward, new C.Cartesian3());
+        C.Cartesian3.normalize(up2, up2);
+        const numDirections = 16;
+        for (let d = 0; d < numDirections; d++) {
+          const angle = d / numDirections * Math.PI * 2;
+          const outwardDir = new C.Cartesian3();
+          C.Cartesian3.multiplyByScalar(right, Math.cos(angle), outwardDir);
+          const upComponent = new C.Cartesian3();
+          C.Cartesian3.multiplyByScalar(up2, Math.sin(angle), upComponent);
+          C.Cartesian3.add(outwardDir, upComponent, outwardDir);
+          C.Cartesian3.normalize(outwardDir, outwardDir);
+          const surfacePoint = new C.Cartesian3();
+          C.Cartesian3.multiplyByScalar(outwardDir, pointCloudSafetyDistance, surfacePoint);
+          C.Cartesian3.add(samplePoint, surfacePoint, surfacePoint);
+          const inwardDir = C.Cartesian3.negate(outwardDir, new C.Cartesian3());
+          const ray = new C.Ray(surfacePoint, inwardDir);
+          const intersections = scene.drillPickFromRay(ray, 10);
+          for (const intersection of intersections || []) {
+            if (!intersection?.position) continue;
+            const primitive = intersection.object?.primitive;
+            const primitiveName = primitive?.constructor?.name || "";
+            if (primitiveName === "Polyline" || primitiveName === "PointPrimitive" || primitiveName === "PointPrimitiveCollection" || primitiveName === "Billboard" || primitiveName === "Label" || primitiveName === "Cylinder" || primitiveName === "Ellipse" || primitiveName === "Model" || primitiveName === "ModelExperimental" || primitiveName === "Globe" || primitiveName === "GlobeSurfaceTile") {
+              continue;
+            }
+            if (primitiveName === "Primitive" && primitive?.appearance) {
+              const appearanceName = primitive.appearance?.constructor?.name || "";
+              if (appearanceName === "PerInstanceColorAppearance" || appearanceName === "MaterialAppearance" || appearanceName === "EllipsoidSurfaceAppearance") {
+                continue;
+              }
+            }
+            const is3DTiles = primitive?.tileset !== void 0 || primitive?._tileset !== void 0 || intersection.object?.content?.tileset !== void 0;
+            if (!is3DTiles && primitiveName !== "Cesium3DTilePointFeature") {
+              continue;
+            }
+            if (i === 0 && d === 0) {
+              console.log("[\u8C03\u8BD5] \u68C0\u6D4B\u5230\u70B9\u4E91\u5BF9\u8C61:", primitiveName);
+              console.log("[\u8C03\u8BD5] primitive:", primitive);
+            }
+            const distFromCenter = C.Cartesian3.distance(samplePoint, intersection.position);
+            minPointCloudDistance = Math.min(minPointCloudDistance, distFromCenter);
+            if (distFromCenter < pointCloudSafetyDistance) {
+              const alreadyAdded = dangerPoints.some(
+                (p) => C.Cartesian3.distance(p, samplePoint) < 0.1
+              );
+              if (!alreadyAdded) {
+                dangerPoints.push(C.Cartesian3.clone(samplePoint));
+                console.log(`[\u5371\u9669] \u91C7\u6837\u70B9 ${i}, \u65B9\u5411 ${d}: \u70B9\u4E91(${primitiveName})\u5728\u5706\u67F1\u4F53\u5185\uFF0C\u8DDD\u4E2D\u5FC3 ${distFromCenter.toFixed(1)}m`);
+              }
+            }
+            break;
+          }
+        }
+      } catch (e) {
+      }
+    }
+    const isTerrainSafe = minTerrainDistance !== Infinity && minTerrainDistance >= terrainSafetyDistance;
+    const isPointCloudSafe = minPointCloudDistance === Infinity || minPointCloudDistance >= pointCloudSafetyDistance;
+    const isDistanceSafe = minWaypointDistance <= 0 || segmentLength >= minWaypointDistance;
+    return {
+      fromIndex,
+      toIndex,
+      isTerrainSafe,
+      isPointCloudSafe,
+      isDistanceSafe,
+      isSafe: isTerrainSafe && isPointCloudSafe && isDistanceSafe,
+      minTerrainDistance: minTerrainDistance === Infinity ? -1 : minTerrainDistance,
+      minPointCloudDistance: minPointCloudDistance === Infinity ? -1 : minPointCloudDistance,
+      segmentLength,
+      dangerPoints
+    };
+  }
+  /**
+   * 可视化危险点（用于调试）
+   */
+  visualizeDangerPoints(result, layer) {
+    const C = this.CesiumNS;
+    const entities = [];
+    result.unsafeSegments.forEach((seg) => {
+      seg.dangerPoints.forEach((point, idx) => {
+        const entity = layer.entities.add({
+          position: point,
+          point: {
+            pixelSize: 10,
+            color: C.Color.RED,
+            outlineColor: C.Color.WHITE,
+            outlineWidth: 2,
+            disableDepthTestDistance: Number.POSITIVE_INFINITY
+          },
+          label: {
+            text: `\u26A0\uFE0F ${seg.fromIndex}-${seg.toIndex}`,
+            font: "12px sans-serif",
+            fillColor: C.Color.RED,
+            outlineColor: C.Color.WHITE,
+            outlineWidth: 2,
+            style: C.LabelStyle.FILL_AND_OUTLINE,
+            pixelOffset: new C.Cartesian2(0, -20),
+            disableDepthTestDistance: Number.POSITIVE_INFINITY
+          },
+          properties: {
+            _type: "safety-danger-point",
+            _segmentFrom: seg.fromIndex,
+            _segmentTo: seg.toIndex
+          }
+        });
+        entities.push(entity);
+      });
+    });
+    return entities;
+  }
+  /**
+   * 清除危险点可视化
+   */
+  clearDangerPoints(layer) {
+    const C = this.CesiumNS;
+    const toRemove = [];
+    layer.entities.values.forEach((entity) => {
+      const type = entity.properties?._type?.getValue?.(C.JulianDate.now());
+      if (type === "safety-danger-point") {
+        toRemove.push(entity);
+      }
+    });
+    toRemove.forEach((entity) => {
+      layer.entities.remove(entity);
+    });
+  }
+  /**
+   * 沿航线创建3D安全管道可视化（使用 Cylinder）
+   * 每个航段创建一个水平圆柱体，圆柱轴心与航线重合
+   * @param positions 航点位置数组
+   * @param layer 实体图层
+   * @param options 可视化选项
+   */
+  visualizeSafetyTube(positions, layer, options) {
+    const C = this.CesiumNS;
+    const entities = [];
+    const radius = options?.radius ?? 20;
+    const color = options?.color ?? C.Color.YELLOW.withAlpha(0.3);
+    const skipFirst = options?.skipFirstSegment ?? true;
+    const startIndex = skipFirst ? 1 : 0;
+    if (positions.length < startIndex + 2) {
+      console.warn("[PathSafetyChecker] \u822A\u70B9\u4E0D\u8DB3\uFF0C\u65E0\u6CD5\u521B\u5EFA\u5B89\u5168\u7BA1\u9053");
+      return entities;
+    }
+    console.log("[PathSafetyChecker] \u521B\u5EFA\u5B89\u5168\u7BA1\u9053\uFF08Cylinder \u65B9\u5F0F\uFF09");
+    console.log(`  \u534A\u5F84: ${radius}m`);
+    console.log(`  \u8D77\u59CB\u822A\u6BB5: ${startIndex}`);
+    for (let i = startIndex; i < positions.length - 1; i++) {
+      const from = positions[i];
+      const to = positions[i + 1];
+      const midPoint = C.Cartesian3.midpoint(from, to, new C.Cartesian3());
+      const length = C.Cartesian3.distance(from, to);
+      const direction = C.Cartesian3.subtract(to, from, new C.Cartesian3());
+      C.Cartesian3.normalize(direction, direction);
+      const localUp = C.Cartesian3.normalize(midPoint, new C.Cartesian3());
+      const zAxis = direction;
+      let xAxis = C.Cartesian3.cross(localUp, zAxis, new C.Cartesian3());
+      if (C.Cartesian3.magnitude(xAxis) < 1e-3) {
+        xAxis = C.Cartesian3.cross(new C.Cartesian3(1, 0, 0), zAxis, new C.Cartesian3());
+      }
+      C.Cartesian3.normalize(xAxis, xAxis);
+      const yAxis = C.Cartesian3.cross(zAxis, xAxis, new C.Cartesian3());
+      C.Cartesian3.normalize(yAxis, yAxis);
+      const rotationMatrix = new C.Matrix3(
+        xAxis.x,
+        yAxis.x,
+        zAxis.x,
+        xAxis.y,
+        yAxis.y,
+        zAxis.y,
+        xAxis.z,
+        yAxis.z,
+        zAxis.z
+      );
+      const orientation = C.Quaternion.fromRotationMatrix(rotationMatrix);
+      console.log(`[\u822A\u6BB5 ${i}] \u957F\u5EA6: ${length.toFixed(1)}m, \u65B9\u5411: (${direction.x.toFixed(2)}, ${direction.y.toFixed(2)}, ${direction.z.toFixed(2)})`);
+      const entity = layer.entities.add({
+        position: midPoint,
+        orientation,
+        cylinder: {
+          length,
+          topRadius: radius,
+          bottomRadius: radius,
+          material: color,
+          outline: true,
+          outlineColor: C.Color.YELLOW,
+          outlineWidth: 1
+        },
+        properties: {
+          _type: "safety-tube",
+          _segmentIndex: i
+        }
+      });
+      entities.push(entity);
+    }
+    console.log(`[PathSafetyChecker] \u521B\u5EFA\u4E86 ${entities.length} \u4E2A\u822A\u6BB5\u5706\u67F1`);
+    return entities;
+  }
+  /**
+   * 清除安全管道可视化
+   */
+  clearSafetyTube(layer) {
+    const C = this.CesiumNS;
+    const toRemove = [];
+    layer.entities.values.forEach((entity) => {
+      const type = entity.properties?._type?.getValue?.(C.JulianDate.now());
+      if (type === "safety-tube") {
+        toRemove.push(entity);
+      }
+    });
+    toRemove.forEach((entity) => {
+      layer.entities.remove(entity);
+    });
+    console.log(`[PathSafetyChecker] \u6E05\u9664\u4E86 ${toRemove.length} \u4E2A\u5B89\u5168\u7BA1\u9053`);
+  }
+};
+
 // src/index.ts
 var placeholder = { ready: true };
 
@@ -11404,9 +11274,9 @@ exports.CameraEventBus = CameraEventBus;
 exports.CameraFOVController = CameraFOVController;
 exports.CameraManager = CameraManager;
 exports.Emitter = Emitter;
-exports.FlightPreviewController = FlightPreviewController;
 exports.FrustumPyramid = FrustumPyramid;
 exports.LayerManager = LayerManager;
+exports.PathSafetyChecker = PathSafetyChecker;
 exports.PolygonEditor = PolygonEditor;
 exports.SceneManager = SceneManager;
 exports.Selector = Selector;