开发指南

环境搭建、本地开发、构建发布、代码规范

环境要求

• Node.js >= 20
• pnpm >= 9
• Cesium Ion Token（用于访问 Cesium 地形和底图服务）

快速开始

# 克隆仓库
git clone <repo-url>
cd nexa

# 安装依赖
pnpm install

# 启动战术仿真引擎
cd products/tactics-sim-engine
pnpm dev

# 启动 GIS Cesium 示例中心
cd packages/gis-cesium
pnpm dev

构建

# 构建所有子包
bash build.sh

# 或单独构建
cd products/tactics-sim-engine
pnpm build

依赖与升级

• 依赖变更清单 — 通用 PR 依赖变更流程
• Cesium 升级清单 + 回归矩阵 — Cesium 版本升级专用流程、私有 API 表面矩阵与回归门禁

发布治理

• 发布治理 SOP — 弃用周期、破坏性变更定义、版本单一来源、体积/导出面门禁与发布检查单

包列表

包	路径	说明
@nexa/gis-cesium	packages/gis-cesium	API 文档
@nexa/scenario-data	packages/common-data	通用数据模型
@nexa/earth-viewer	apps/earth-viewer	Vue 3 地球组件
@nexa/cesium-timeline-tracks	apps/cesium-timeline-tracks	时间轴组件
tactics-sim-engine	products/tactics-sim-engine	战术仿真引擎