jamalrfordii-arch/Vanguard-Map
GitHub: jamalrfordii-arch/Vanguard-Map
一款纯浏览器端的多域实时 3D 战术情报地图,整合船舶、航班、卫星、海底电缆等多源动态数据,支持时间回溯、场景编排与物理异常检测。
Stars: 8 | Forks: 2
# VANGUARD1 — 多域战术情报地图
一个关于世界移动事物的实时 3D 地图:实时船舶动态 (AIS)、飞机、
卫星、海底电缆、港口、咽喉要道以及空间天气 —— 以
150 万个点的地形点云进行渲染,包含昼夜交替、海洋模拟和电影级运镜。
使用 Three.js 和原生 ES modules 构建。无需构建步骤,无框架依赖。
**▶ [在线演示](https://jamalrfordii-arch.github.io/Vanguard-Map/)** — 无需注册:
在启动界面点击 **VIEW DEMO** 查看模拟流量,或者粘贴一个免费的
[aisstream.io](https://aisstream.io) 密钥以获取全球实时船舶数据。

## 开始体验
```
git clone https://github.com/jamalrfordii-arch/Vanguard-Map.git
cd Vanguard-Map
npx serve . # or: python -m http.server 3000
```
在启用了硬件加速的 Chromium 浏览器中打开 `http://localhost:3000`。
**实时船舶数据(免费):** 应用首次加载时会提示输入 [aisstream.io](https://aisstream.io)
API 密钥 —— 免费注册,该密钥将保存在你浏览器的 localStorage 中。
**高分辨率地形切片(可选):** 在
[cesium.com/ion](https://cesium.com/ion) 获取一个免费 token → Access Tokens,然后在 DevTools 中执行:
`localStorage.setItem('vg1_cesium_token', 'YOUR_TOKEN')`。若不进行此操作,地图在所有缩放级别下都将使用点云地形。
**航班与 AI copilot(可选):** 需要运行本地代理 ——
在第二个终端中执行 `node flight-proxy.js`。若不运行,这些图层将保持静默;
其他所有功能照常运作。
## 时间控制与场景
地图运行于模拟时钟之上,并支持可插拔的数据源 —— 在 DevTools 控制台中执行:
```
simClock.setTime('2026-05-10T12:00:00Z') // scrub the world to any moment
simClock.setRate(60) // 1 real second = 1 sim minute
vg1Scenario.load('./scenarios/hormuz-demo.json') // inject scripted synthetic vessels
vg1Scenario.record(); vg1Scenario.save() // capture live AIS to NDJSON
vg1Scenario.replay('./captures/x.ndjson') // replay a capture
vg1Invariants.stats() // physics-violation ledger (spoof/teleport detection)
```
模拟船只使用保留的 `999…` MMSI,并在 `scenarios/*.json` 中进行脚本化设定。
## 测试
```
node tests/invariants.test.mjs
```
## 架构
每个域对应一个管理器 (`aisManager`, `flightManager`, `satelliteManager`, …),
它们仅通过 `vg1:*` DOM 事件进行通信 —— 无交叉导入。所有位置报告
在移动实体之前,都必须通过物理不变性校验门 (`invariants.js`)。
完整模块映射和贡献规则请参阅 `CLAUDE.md`。
## 反馈
提交 [GitHub Issue](https://github.com/jamalrfordii-arch/Vanguard-Map/issues) ——
bug 报告、功能建议以及“这在我的机器上以 N fps 运行”的报告都非常有用。
标签:CMS安全, HTTP/HTTPS抓包, JavaScript, MITM代理, Three.js, 地理信息系统, 态势感知, 情报分析, 网络诊断, 自定义脚本