当前系统功能与实现说明

更新时间：2026-05-22

1. 文档目的

本文档说明当前项目已经实现的能力、核心数据结构、关键模块职责和发布包接入方式。

它描述的是当前代码现状，不是未来设计稿。开发者需要快速理解系统能力、扩展点和运行边界时，可以优先阅读本文档。

2. 系统定位

openlayers2dsceneeditor 是一个基于 Vue 3 + OpenLayers 的二维想定编辑与态势显示通用 npm 库。

系统面向两类场景：

• 想定编辑：模型部署、模型属性编辑、航线编辑、挂载物管理、批量框选、批量移动/旋转、标绘、测量、导入导出、截图、回放。
• 态势显示：外部实时数据接入、模型位置增量更新、关系线、态势特效、事件特效、帧合并、性能等级控制。

核心库不绑定具体业务。宿主系统根据自己的业务判断“谁发现谁、谁锁定谁、谁攻击谁、谁失联/毁伤”，然后调用库的模型、关系、特效、态势帧 API 组合出最终显示效果。

仓库内置测试面板只是开发版 demo，主要用于快速预览功能和特效，不代表宿主业务流程。

3. 依赖与发布形态

当前发布包已经移除 Element Plus 和 @element-plus/icons-vue。

3.1 发布依赖

package.json 当前依赖结构：

• dependencies
  • ol
• peerDependencies
  • vue
• devDependencies
  • @vitejs/plugin-vue
  • less
  • vite

宿主安装方式：

npm i openlayers2dsceneeditor vue

样式引入：

import "openlayers2dsceneeditor/style.css";