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) 密钥以获取全球实时船舶数据。 ![演示](https://raw.githubusercontent.com/jamalrfordii-arch/Vanguard-Map/main/docs/demo.gif) ## 开始体验 ``` 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, 地理信息系统, 态势感知, 情报分析, 网络诊断, 自定义脚本