chama-x/openworldeye
GitHub: chama-x/openworldeye
一款开源的战术 OSINT 三维地球仪，整合航班追踪、卫星轨道、地震数据等公开情报源，为安全研究和态势感知提供交互式可视化平台。
Stars: 0 | Forks: 0
# OpenWorldEye
**OPEN WORLD EYE** · 开源地理空间 OSINT 地球仪：实时航班、来自 CelesTrak TLEs + `satellite.js` 的卫星位置、USGS 地震信息以及示例冲突标记——由 **react-globe.gl** 渲染，并配备战术指挥台 UI（时钟调整、图层轨道、情报面板）。
| | |
| --- | --- |
| **实时演示** | **[openworldeye.vercel.app](https://openworldeye.vercel.app/)** — 生产环境（在 Vercel 上进行 Vite 静态构建） |
| **仓库** | [github.com/chama-x/openworldeye](https://github.com/chama-x/openworldeye) |
| **文档** | [docs/README.md](docs/README.md) · [发布清单](docs/PUBLISH_CHECKLIST.md) · [品牌](BRANDING.md) |
生产环境仅托管在 **Vercel** 上（[控制面板](https://vercel.com/dashboard)）。在 `git push` 之后，可通过 Vercel UI 或使用 `vercel --prod` 重新部署。
## 快速开始
```
npm install
npm run dev
```
- **构建：** `npm run build`
- **预览构建：** `npm run preview`
## 通过 Vercel 部署
1. 安装 CLI：`npm i -g vercel`
2. 在此目录下（登录使用：`vercel login`）：
```
vercel link # first time: link to a Vercel team/project
vercel # preview deployment
vercel --prod # production URL — put it in the table above + GitHub About → Website
```
3. **环境变量**（Vercel → Project → Settings → Environment Variables），参照 [`.env.example`](.env.example)：可选的 `VITE_GROQ_API_KEY`、`VITE_GROQ_MODEL`。修改后需重新部署。
4. **GitHub 集成（推荐）：** 在 Vercel 中，**Add New Project → Import** `chama-x/openworldeye`。每次推送到 `main` 分支时，都可以根据您的 Vercel 设置自动部署预览/生产环境。
[](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fchama-x%2Fopenworldeye)
## 技术栈
- Vite 6 · React 19 · TypeScript
- Tailwind CSS v4 (`@tailwindcss/vite`)
- `react-globe.gl` / Three.js · `satellite.js` (SGP4)
## 环境变量
| 变量 | 用途 |
| --- | --- |
| `VITE_GROQ_API_KEY` | 可选 — 在情报面板中启用 **Synthesize** 功能（Groq OpenAI 兼容 API）。 |
| `VITE_GROQ_MODEL` | 可选 — 默认为 `llama-3.1-8b-instant`。 |
将 [`.env.example`](.env.example) 复制为 `.env.local` 用于本地开发。生产环境请使用 Vercel 环境变量 UI。
## CORS 和网络
所有数据源均使用浏览器的 `fetch()`。公司网络或拦截器可能会导致 OpenSky/USGS 请求失败；应用会在 `src/lib/osint-services.ts` 中实现的地方回退到示例数据。
## 项目结构
```
src/
CommandDeck.tsx # Shell: header, rails, globe, intelligence, timeline
components/ # Globe, timeline scrubber, intelligence brief
contexts/ # Global clock, data layers, shared OSINT snapshot
hooks/ # Polling hooks (free-tier aware)
lib/osint-services.ts # API + propagation
docs/
design-brief.md # UI / tactical direction
research/ # External WorldView reference material (not the product name)
vercel.json # Vercel framework + build output
```
## Git 克隆
```
git clone https://github.com/chama-x/openworldeye.git
cd openworldeye
npm install
```
首次 Vercel 生产部署后，请完成 **[docs/PUBLISH_CHECKLIST.md](docs/PUBLISH_CHECKLIST.md)**（GitHub About URL、topics、README 实时链接）。
## 许可证
[MIT](LICENSE)
标签：3D地球, CelesTrak, DLL 劫持, ESC4, GIS, OpenSky, OSINT, OSV, React, React 19, satellite.js, SGP4, Syscalls, Tailwind CSS, Three.js, TypeScript, USGS, Vercel, Vite, WebGL, 全球态势感知, 冲突标记, 卫星追踪, 地理空间情报, 地震监测, 大语言模型, 安全插件, 战术指挥, 自动化攻击, 航班追踪