jamalrfordii-arch/Vanguard-Map

来源：https://github.com/jamalrfordii-arch/Vanguard-Map

VANGUARD1 — 多域战术情报地图

一张实时3D地图，展示全球移动物体：实时船舶交通（AIS）、飞机、卫星、海底光缆、港口、咽喉要道以及空间天气——以150万个点的地形云形式呈现，包含昼夜循环、海洋模拟和电影级镜头控制。基于Three.js和纯ES模块构建，无需构建步骤，不依赖框架。

▶ 在线演示（https://jamalrfordii-arch.github.io/Vanguard-Map/） —— 无需注册：打开页面点击查看演示即可体验模拟流量，或者粘贴免费的aisstream.io（https://aisstream.io）API密钥以获取全球实时船舶数据。

演示

尝试运行

git clone https://github.com/jamalrfordii-arch/Vanguard-Map.git
cd Vanguard-Map
npx serve .        # 或：python -m http.server 3000

在支持硬件加速的Chromium浏览器中打开 http://localhost:3000。

实时船舶数据（免费）： 应用首次加载时会提示输入aisstream.io（https://aisstream.io）API密钥——免费注册即可获得，密钥将保存在浏览器本地存储中。

高分辨率地形瓦片（可选）： 在cesium.com/ion（https://cesium.com/ion）免费获取令牌 → 访问令牌，然后在开发者工具中执行：localStorage.setItem('vg1_cesium_token', 'YOUR_TOKEN')。若未设置，地图将在所有缩放级别使用点云地形。

航班与AI副驾驶（可选）： 需要本地代理——在第二个终端中运行 node flight-proxy.js。若不启动，这两个图层将保持静默；其余功能不受影响。

时间控制与场景

地图运行在模拟时钟和可插拔数据源之上——在开发者工具控制台中操作：

simClock.setTime('2026-05-10T12:00:00Z')   // 将世界快进到任意时刻
simClock.setRate(60)                        // 1实际秒 = 1模拟分钟
vg1Scenario.load('./scenarios/hormuz-demo.json')  // 注入脚本化的模拟船舶
vg1Scenario.record(); vg1Scenario.save()    // 捕获实时AIS数据为NDJSON
vg1Scenario.replay('./captures/x.ndjson')   // 回放捕获的数据
vg1Invariants.stats()                       // 物理违规账本（欺骗/瞬移检测）

模拟船舶使用保留的999... MMSI编号，并在 scenarios/*.json 中通过脚本定义。

测试

node tests/invariants.test.mjs

架构

每个领域有一个独立的管理器（aisManager、flightManager、satelliteManager……），仅通过 vg1:* DOM 事件通信——无交叉导入。所有位置报告在移动实体前必须通过物理不变量门控（invariants.js）。完整模块映射和贡献规则请参见 CLAUDE.md。

反馈

欢迎在 GitHub Issues（https://github.com/jamalrfordii-arch/Vanguard-Map/issues）中提交——无论是错误报告、功能建议，还是“我的设备上运行帧率为N FPS”的报告，都非常有用。