上帝视角（God's Eye View）

项目概览

God's Eye View 是一个在浏览器中运行的"间谍卫星模拟器"，把公开的实时信号汇聚到同一个可探索的地球仪上：航班、船舶、卫星、地震、摄像头、无线电、火情等。整套应用在本地浏览器中运行，源代码可审计、可扩展。所有数据源均为公开信号，多数图层无需 API 密钥即可启动。

核心口号：让全球态势既能纵览全貌，也能下钻到单架飞机、单艘船舶或某条街道。

主要特性

• 驾驶舱视角：跟随被追踪的飞行器俯冲，镜头始终锁定下方地形。
• 通讯录式目标：当前目标周围 250 公里内的全部目标列表，逐个切换并可即时进入下一架飞机的驾驶舱。
• 点击追踪：锁定目标后绘制衰减尾迹、显示完整元数据；火点或船舶可一键转交最近的实时摄像头。
• 语音白板：通过语音在真实地理上绘制边界、多边形、标注和路线，这些标注均为持久化矢量对象。
• 3D 机库：按机型分类的真实三维模型（787、ATR-72、Citation、Bell 206、MQ-9 等），接近时自动从符号切换为模型。
• 传感器滤镜：GLSL 着色器覆盖普通地球，支持 CRT、夜视、FLIR 热成像、Noir、Snow 等模式。
• 检测叠加层：在屏幕空间为每个目标绘制包围盒和编号。
• 战术 HUD：军用风格的平视显示器，提供情报式遥测数据。
• 天气系统：GFS 或 ECMWF 预报风场、回放实测雷达、卫星云图与闪电，可在统一时间轴上播放，并跟踪 NHC/CPHC 飓风路径。
• ALPR 摄像头：按城市范围加载 OpenStreetMap 中标注的车牌识别摄像头位置。
• 过境预报：可语音询问某颗已加载卫星何时从所在地上升、达到峰值和落下。
• 分析问答：通过语音对卫星、数据中心、水坝、航班、船舶、火点和地震进行计数、过滤与排序。
• 视角控制：在正俯视与 35° 倾斜视角之间切换，或固定北方朝上，被追踪目标始终居中。
• 导演模式：录制电影感镜头轨迹，便于制作演示片段。
• 可分享链接：相机、样式、图层甚至追踪目标都会被序列化进 URL，活目标对应实时交接而非书签。
• 场景共享：导演场景可作为文件导入、预览与分享，包含相机锚点、动作与数据包。

快速开始

应用默认无需账户或 API 密钥即可启动，自带 Esri 卫星影像与免密钥地形。航班、军事交通、卫星、地震、摄像头、无线电与发射任务均可直接使用。若需照片级 3D，可在应用内的 POWER UP 面板添加 Cesium ion token（符合条件的个人非商业用途）或 Google Maps 密钥。

路径一：图形化安装

1. 将 Pinokio 更新至 8.2 或更高版本。
2. 在 Pinokio 中打开 God's Eye View 应用页。
3. 点击 Install，再点击 Start。

支持 Windows、macOS 与 Linux。安装器会自动锁定依赖、寻找空闲本地端口并启动应用。

路径二：终端或代码 Agent

需要 Node.js 24.x（24.14.0 起）或 26.x。Node 25 已停止维护，启动检查会给出警告。

git clone https://github.com/bilawalsidhu/gods-eye-view.git
cd gods-eye-view
npm ci         # 安装锁定依赖
npm run doctor # 环境自检
npm run dev    # 启动开发服务

随后打开 http://localhost:4173，在首屏选择 Live Contacts、Space Missions、Environmental 或 Explore Manually。

macOS 用户可使用 ./scripts/dev-fresh.sh，该脚本会清理 Vite 缓存并自动从 Keychain 读取已配置的密钥；不配置密钥也能直接启动。

在应用内配置密钥

密钥是能力升级而非前置条件。点击右下角 POWER UP，在 Provider Settings 中查看每个密钥对应的能力与获取地址，粘贴后点击 SAVE KEYS，应用会以新能力重启。配置完成后，芯片状态会显示 POWERED UP。

• 密钥存储路径：Pinokio 安装写入其忽略的 pinokio/ENVIRONMENT；终端克隆写入仓库根目录的 .env。两种文件在写入密钥前都会被设为仅所有者可读，属于本地明文文件并被 Git 忽略。
• 外部已存在的密钥：从 Shell 环境或 macOS Keychain 读取的值会显示为"外部已配置"，面板中只读。
• 推荐优先配置：先获取免费的 Cesium ion token 以启用照片级 3D 与全球地形；仅在需要按量计费路线或 Google 地点搜索时再申请 Google Maps 密钥；启用语音交互则需要 OpenAI 密钥。服务仅监听本地端口，浏览器侧密钥需在各供应商后台自行限制来源 IP 或域名。

语音与控制

语音默认走 OpenAI API key 路径；也可在 Provider Settings 中选择使用本机已登录的 ChatGPT/Codex OAuth 会话，该方式为实验性，仅在本地读取 Codex 凭据且不会写回。

点击 GEV MIC 授予麦克风权限后，可直接对地球说话。语音 Agent 具备以下能力：

• 场景感知：回答前会拉取实时场景上下文，包括坐标、街道名、激活图层与视图尺度。
• 目标问答：点击飞机、船舶或数据中心后直接询问"这是什么"。
• 视觉定位：在街道尺度下会读取视口截图以识别标牌与建筑名。
• 导演式运镜：例如"展示上空的飞机"，会自动调整相机角度并构图。
• 安全机制：仅报告实际执行成功的动作；OPENAI_API_KEY 不会离开服务器，浏览器只获得短时会话令牌。

Agent 配套约 30 个工具，覆盖四类任务：

• 指挥相机："带我去东京""绕这个区域慢速环绕""画出从州议会到 Zilker 公园的步行路线""沿刚才画的路线飞一遍""缩小到全球视角"。
• 地图白板："画出得克萨斯州的边界""标注州议会及其院区"，绘制的是真实边界而非圆圈；"埃菲尔铁塔到卢浮宫有多远"会画一条带箭头的连线并读出距离。
• 分析图层："得州上空现在有多少航班""哪些船正驶向奥克兰""洛杉矶附近最大的火点是哪一处""有没有飞行高度超过四万英尺的目标""ISS 何时过境""视野内有多少数据中心"。
• 操控面板："切换到夜视并打开航班图层""打开摄像头视域""播放奥斯汀附近的新闻广播""追踪那架飞机""进入驾驶舱"。

键盘快捷键：1–7 切换视觉样式，H 切换 HUD，D 切换检测叠加层，C 切换驾驶舱，` 显示帧率，Esc 退出。触控板捏合可缩放地球。

图层与数据源

应用内置二十个图层与地图源，其中十七个具备免密钥路径。

图层	数据	鉴权
地图栈	Esri 卫星、谷歌照片级 3D、OSM、Ion 托管图层	Esri 与 OSM 免费；Ion 托管谷歌 3D 与全球地形需免费 token；直连谷歌与地点搜索按量计费
实时航班	11,000+ 实时飞机与航线历史	OpenSky + adsb.lol，免费（可选 token 提高轮询额度）
军事航班	ADS-B 军事交通	adsb.lol，免费
实时船舶	全球数千艘船舶	AISStream，需免费密钥
卫星	按类别着色的目录，含 Starlink 完整壳层	CelesTrak，免费
地震	全球最近 24 小时地震活动	USGS，免费
交通	基于 OSM 道路的模拟车辆；接入 TomTom 后可由实时路况驱动	模拟免费；实时路况需免费密钥
摄像头网格	约 3,900 个公共摄像头投射进 3D 空间，覆盖奥斯汀、得州、加州、伦敦、安大略、芬兰、不列颠哥伦比亚、爱沙尼亚、特拉华、新南威尔士、卡尔加里、挪威等	各城市 API，免费
ALPR 摄像头	OpenStreetMap 贡献者标注的车牌识别摄像头位置	OSM，免费
街景	Mapillary 与 Google Street View 街景照片	Mapillary token 免费；谷歌按量计费
无线电	全球电台，可拖动指针在最多 750 个电台之间切换	Radio Browser，免费
公交	波士顿、奥斯汀、明尼阿波利斯、赫尔辛基、荷兰、挪威、昆士兰东南部的实时巴士、有轨电车、地铁、火车与渡轮	GTFS-Realtime，免费
共享单车	站点可用车辆	GBFS，免费
路径规划	街道级驾车、步行、骑行路线，铺设在地形上，可沿路线飞行	OSRM on FOSSGIS，免费
活跃火点	NASA FIRMS 最近 24 小时探测