koala73 worldmonitor

世界监控简体中文

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

文档 · 发布 · 贡献

功能概述

500+ 精选新闻源，覆盖15个类别，经AI综合生成简报
双地图引擎——3D地球（globe.gl）与WebGL平面地图（deck.gl），支持56种地图图层类型
跨流关联分析——军事、经济、灾害与升级信号汇聚
国家不稳定指数（CII）——服务器权威CII v8压力评分，覆盖31个一级国家
金融雷达——29个证券交易所、大宗商品、加密货币及7信号市场综合指数
本地AI——使用Ollama运行一切，无需API密钥
单一代码库生成6个站点变体（世界、科技、金融、大宗商品、快乐、能源）
原生桌面应用（Tauri 2），支持macOS、Windows和Linux
25种语言，支持母语新闻源与从右至左（RTL）布局

完整功能列表、架构、数据源及算法，请参阅文档。

支持状态

所有站点变体及桌面二进制文件均基于单一代码库构建，并通过同一发布流程交付。下表明确了维护状态，以便您了解哪些部分可安全依赖。

| 表面层 | 状态 | 备注 | |--------|------|------| | worldmonitor.app、tech.、finance.、commodity.、happy.、energy. | 稳定 | 基于此仓库的公开部署，积极维护 | | 桌面二进制文件（Windows / macOS Apple Silicon / macOS Intel / Linux AppImage） | 稳定 | 单一Tauri二进制文件，可在应用内切换变体；当前CI发布目标为完整版和科技版 |

针对上述任一表面层提交的问题，均从同一待办事项列表中进行分类处理——请参阅问题面板查看当前进行中的工作。

快速开始

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

打开 localhost:3000（可通过 .env.local 中的 DEV_PORT 覆盖端口）。应用无需任何环境变量即可运行。特定功能的数据源可能需要凭据。完整列表请参阅 .env.example。

针对特定变体的开发：

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 侧车进程 | | AI/ML | Ollama / Groq / OpenRouter、Transformers.js（浏览器端） | | API 契约 | Protocol Buffers（281个协议、35个服务）、sebuf HTTP 注解 | | 部署 | Vercel Edge Functions（60+）、Railway 中继、Tauri、PWA | | 缓存 | Redis (Upstash)、3层缓存、CDN、Service Worker |

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

程序化访问

World Monitor 不仅面向浏览器，也为代理和脚本构建：

MCP 服务器 — 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/ 目录）：

  npx worldmonitor tools   # 临时运行——列出所有 MCP 工具（无需密钥）
  npm install -g worldmonitor   # 或安装 `worldmonitor`（别名 `wm`）命令
  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/sdks
代理发现文件：llms.txt · agent-skills manifest · api-catalog

在 worldmonitor.app/pro 获取 API 密钥。

航班数据

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

数据源

WorldMonitor 整合了 65+ 个外部提供商和 API，涵盖地缘政治、金融、能源、气候、航空、网络、军事、基础设施及新闻情报——通过 500+ 个精选新闻源呈现，并由覆盖 35 个源组的 freshness monitor 追踪。完整数据源目录请参阅提供商、新闻源层级及采集方法。

贡献

欢迎贡献！请参阅 CONTRIBUTING.md 了解指南。

npm run typecheck      # 类型检查
npm run build:full     # 生产构建

许可证

源代码采用 AGPL-3.0-only 许可证。在遵守其 copyleft 和源代码可用性条款的前提下，允许商业使用。

| 使用场景 | 是否允许？ | |----------|------------| | 个人/研究/教育用途 | 是，基于 AGPL-3.0-only | | 自托管实例 | 是，基于 AGPL-3.0-only | | 分叉并修改 | 是，在需要时以 AGPL-3.0-only 共享源代码 | | 商业使用/SaaS | 是，基于 AGPL-3.0-only，需遵守 AGPL 义务 | | 私有闭源专有使用或官方品牌使用权 | 需要单独的商业或商标许可 |

完整代码许可证请参阅 LICENSE，通俗语言摘要请参阅 docs/license.mdx。对于需要非 AGPL 条款的团队，商业许可作为替代选项提供。

作者

Elie Habib — GitHub

贡献者

安全致谢

我们感谢以下研究人员负责任地披露安全问题：

Cody Richard — 披露了三项安全发现，涵盖 IPC 命令暴露、渲染器到侧车进程信任边界分析，以及 fetch 补丁凭据注入架构（2026年）

请参阅我们的安全策略了解负责任披露指南。

worldmonitor.app · docs.worldmonitor.app · finance.worldmonitor.app · commodity.worldmonitor.app

koala73 worldmonitor