企业官网建设流程全解析

God's Eye View 本地部署怎么做：免密钥免费启动真实 3D 地球仪的完整指南

【免费下载链接】gods-eye-viewA spy satellite simulator in your browser, except the data is real. Live open source spatial intelligence on a photorealistic 3D globe.项目地址: https://gitcode.com/GitHub_Trending/go/gods-eye-view

God's Eye View 是一款跑在浏览器里的实时 3D 地球仪，支持免 API 密钥本地部署：真实航班、船舶、卫星、地震、城市公共摄像头，全部来自真实公开数据，不需要注册任何账号。本文给出 Pinokio 一键与终端两条路线的完整步骤，涵盖环境体检、常见报错处理和可选密钥升级。

本地部署路线选择：三种人，三种走法

先给结论：只看不改，用Pinokio 一键最省事；要读源码、加数据层、提 PR，用终端路线；无头服务器和 CI 脚本化部署只能走终端（直接注入环境变量）。两条路线打开的是同一个应用，随时可以互换，不是二选一。

终端路线配合 CONTRIBUTING.md 可以阅读源码、添加图层并提交流程化部署。

Pinokio 一键安装步骤：版本要求与四步操作

Pinokio 是"点一下就跑"的开源应用启动器，God's Eye View 在其应用列表内，Windows、macOS、Linux 均可用。操作四步：

1. 安装 Pinokio，或更新到8.2 或更高版本（旧版 8.0.40 存在安装缺陷，8.2 已修复）；
2. 在 Pinokio 中打开God's Eye View应用页；
3. 点击Install；
4. 安装完成后点击Start，浏览器自动打开应用。

背后发生的事一句话概括：启动器安装锁定版本的依赖、挑选一个空闲本地端口、把服务绑定到127.0.0.1并打开页面。菜单中 Install / Start / Update / Repair installation 四个动作由 pinokio/pinokio.js 定义，启动流程在pinokio/start.js和scripts/pinokio-start.mjs。

装不上时：先把 Pinokio 升到 8.2 再重试；仍异常时，用 Pinokio 菜单里的 "Repair installation" 一键修复（对应逻辑在pinokio/reset.js）。

终端启动：Node.js 版本要求与环境体检命令

前置条件：Node.js 24.x（≥24.14.0）或 26.x。Node 25 已停止维护（EOL），体检工具只给警告。命令如下：

git clone https://gitcode.com/GitHub_Trending/go/gods-eye-view cd gods-eye-view npm ci npm run doctor npm run dev

随后打开http://localhost:4173，首次运行面板提供四个入口：Live Contacts（实时航空）、Space Missions（太空任务）、Environmental（环境层）、Explore Manually（自由探索）。

npm run doctor建议每次运行前都跑。它由 scripts/setup-doctor.mjs 驱动，检查 Node/npm 版本、依赖是否装齐、各数据源能力现状，以及每个密钥从哪个来源读到（环境变量、.env或 macOS 钥匙串）——只报告来源，不打印密钥明文。

常见报错修复：版本过旧、依赖缺失、端口占用

• doctor 报too old; install Node 24.14 or newer：当前 Node 版本过旧，安装 Node 24.14.0 或更新版本、或 26.x 后重跑；
• doctor 提示dependencies missing：执行npm ci补齐依赖；
• doctor 对 Node 25 报 WARN（EOL）：可以运行，但建议升级到 24.x 或 26.x；
• 端口 4173 被占用或残留旧进程：运行./scripts/dev-fresh.sh，它会停掉旧 dev 服务器、清理占用端口的进程、清空 Vite 缓存后重新启动，同样支持无密钥启动；
• macOS 钥匙串里已存密钥：dev-fresh.sh会自动从 Keychain 拉取，无需手写.env。

性能预期：启动要多快

官方在 M5 芯片 + Chrome 环境实测：冷启动中位数约1.86 秒。这是单时间点基线，不是对你机器的保证值，硬件与网络不同会有出入，完整测量表见 docs/PERFORMANCE.md。

✅ 首跑验证：四步确认数据真的在工作

无论走哪条路线，启动后按下面的顺序走一遍即可确认：

先打开Live Flights图层——数千架真实航班基于实时遥测在球面上滑行；点击任意一架，相机锁定目标、身后绘出航迹、实时遥测卡片弹出。

然后对目标飞机按C进入Cockpit（驾驶舱）模式：视角贴着真实地形下潜，中途可以切换 FLIR / 夜视传感器。

接着打开Satellites图层点击 ISS，以轨道距离跟飞一圈，沿轨道环完整绕行。

最后按1–6依次切换 CRT、NVG、FLIR、Noir 等传感器风格滤镜，观察整个地球实时重渲染（Snow 滤镜已下线，其历史实测数据仍保留在性能报告中）。

🔑 可选密钥升级：Provider 配置位置与安全边界

密钥是"升级项"，不是"门槛"。需要某项能力时，点右下角POWER UP芯片打开 Provider Settings，粘贴密钥后点SAVE KEYS，应用自动重启并启用对应能力；全部配置完成后芯片显示POWERED UP。若紧凑布局把芯片藏起来了，在 URL 后加?setup=1可重新打开同一面板。

密钥全部在应用内粘贴，无需手改文件。落盘位置：Pinokio 路线写入pinokio/ENVIRONMENT，终端路线写入仓库根目录.env；两个文件在写入前都会先设为仅所有者可读写，内容是本地明文，且均被排除在版本库之外。网络边界：服务器默认只绑定 localhost；局域网共享（HOST=0.0.0.0）属于显式开启项，启动时会打印风险警告——任何能访问到该地址的人都能经由它使用你配置的密钥，更多细节见 SECURITY.md。

数据边界声明

God's Eye View 是公开数据的探索性可视化，数据可能存在延迟、缺失或推断成分，请勿用于飞行/航海导航、应急决策或投资判断。

【免费下载链接】gods-eye-viewA spy satellite simulator in your browser, except the data is real. Live open source spatial intelligence on a photorealistic 3D globe.项目地址: https://gitcode.com/GitHub_Trending/go/gods-eye-view