README

World Monitor

English | 日本語 | Русский

实时全球情报仪表盘 — 在统一的态势感知界面中，汇集 AI 驱动的新闻聚合、地缘政治监测和基础设施追踪。










   
   
   
   
   
  



   
   
   
   
  



   
   
   
  



  文档  · 
  发布版本  · 
  贡献指南


!World Monitor 仪表盘

---

 功能概览

- 精选新闻源，覆盖全球和区域类别，并由 AI 综合生成简报
- 双地图引擎 — 3D 地球仪（globe.gl）和 WebGL 平面地图（deck.gl），使用共享地图图层目录
- 跨信息流关联 — 汇聚军事、经济、灾害和升级信号
- 国家不稳定指数（CII） — 面向一级国家注册表的服务器权威 CII v14 压力评分
- 金融雷达 — 证券交易所、大宗商品、加密货币，以及市场综合指标
- 本地 AI — 通过 Ollama 运行全部功能，无需 API 密钥
- 站点变体，均来自同一代码库（World Monitor、Tech Monitor、Finance Monitor、Commodity Monitor、Happy Monitor、Energy Monitor）
- 原生桌面应用（Tauri 2），支持 macOS、Windows 和 Linux
- 多语言界面，提供本地语言信息流和 RTL 支持

完整的功能清单、架构、数据源和算法，请参阅文档。

---

 支持状态

所有站点变体和桌面二进制文件均从同一代码库构建，并通过同一发布流程交付。下表说明维护状态，帮助你判断哪些产品形态可放心依赖。

| 产品形态 | 状态 | 说明 |
|---------|--------|-------|
| worldmonitor.app、tech.、finance.、commodity.、happy.、energy. | 稳定 | 从本仓库构建的公开部署，持续维护中 |
| 桌面二进制文件（Windows / macOS Apple Silicon / macOS Intel / Linux AppImage） | 稳定 | 一个可在应用内切换变体的 Tauri 二进制文件；当前 CI 发布目标为 full 和 tech |

上述任一产品形态的问题都会进入同一待办队列；请查看问题看板了解当前公开工作。

---

 快速开始

bash
git clone https://github.com/koala73/worldmonitor.git
cd worldmonitor
npm install
npm run dev


打开 localhost:3000（可在 .env.local 中通过 DEV_PORT 覆盖端口）。应用无需环境变量即可运行。

特定功能的数据源可能需要凭据。完整列表请参阅 .env.example。

针对特定变体进行开发：

bash
npm run dev:tech        tech.worldmonitor.app
npm run dev:finance     finance.worldmonitor.app
npm run dev:commodity   commodity.worldmonitor.app
npm run dev:happy       happy.worldmonitor.app
npm run dev:energy      energy.worldmonitor.app


部署选项（Vercel、Docker、静态托管）请参阅自托管指南。

---

 技术栈

| 类别 | 技术 |
|----------|-------------|
| 前端 | Vanilla TypeScript、Vite、globe.gl + Three.js、deck.gl + MapLibre GL |
| 桌面 | Tauri 2（Rust）与 Node.js sidecar |
| AI/ML | Ollama / OpenRouter、Transformers.js（浏览器端） |
| API 契约 | Protocol Buffers 与 sebuf HTTP 注解 |
| 部署 | Vercel Edge Functions、Railway 中继、Tauri、PWA |
| 缓存 | Redis（Upstash）、3 层缓存、CDN、service worker |

完整技术栈详情请参阅架构文档。

---

 编程访问

World Monitor 同时为智能体、脚本和浏览器而构建：

- MCP Server — https://worldmonitor.app/mcp（Streamable HTTP）。公开提供 tools/list；tools/call 通过 X-WorldMonitor-Key 请求头或 OAuth 进行身份验证。
- REST API — 基础地址为 https://api.worldmonitor.app，详见 OpenAPI 规范。
- CLI — 官方 worldmonitor npm 包（源代码位于 cli/）：

  sh
  npx worldmonitor tools           run ad-hoc — list every MCP tool (no key needed)
  npm install -g worldmonitor      or install the worldmonitor (alias wm) command
  brew install worldmonitor        or install it with Homebrew
  worldmonitor risk IR --api-key wm_xxx
  

- SDK — 与 CLI 对应的官方零依赖客户端库：Python worldmonitor-sdk（源代码位于 sdk/python/）、Ruby worldmonitor（sdk/ruby/）、Go github.com/koala73/worldmonitor/sdk/go（sdk/go/）。指南：worldmonitor.app/docs/zh/sdks。

智能体发现文件：llms.txt · 智能体技能清单 · API 目录。请在 worldmonitor.app/pro 获取 API 密钥。

---

 航班数据

航班数据由 Wingbits 慷慨提供；Wingbits 是先进的 ADS-B 航班数据解决方案。

---

 支持

World Monitor 的 Web 应用和 API 运行在 Vercel 上。感谢 Vercel 对本项目的慷慨支持。

---

 数据源

WorldMonito

Top issues

Discussions

Latest release

What's Changed

- chore(release): bump desktop to 2.11.8 (10150)
- perf(blog): self-host subset web fonts with a preloaded core and on-demand extended files (10145)
- fix(panels): make table status and severity badges readable in both themes (10144)
- fix(panels): make price and stock table state colours readable in both themes (10143)
- fix(panels): collapse the badge and watchlist button in market headers up to 420px (10142)
- feat(self-host): unlock Pro on self-hosted dashboards with the user's own desktop key (10137)
- ci(deploy-gate): stop holding runners for waits and history the evaluat