koala73 worldmonitor

世界监控器简体中文

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

文档 · 发布 · 贡献

功能概述

500+ 精选新闻源，覆盖 15 个类别，经 AI 合成生成简报
双地图引擎——3D 地球（globe.gl）与 WebGL 平面地图（deck.gl），支持 56 种地图图层类型
跨流关联分析——军事、经济、灾害与升级信号的汇聚融合
国家不稳定指数（CII）——针对 31 个 Tier-1 国家的服务器权威 CII v8 压力评分
金融雷达——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 发布目标为 full 和 tech |

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

快速开始

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、静态部署）请参阅自托管指南。

技术栈

| 类别 | 技术 | |------|------| | 前端 | 原生 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 个 protos、35 个服务）、sebuf HTTP 注解 | | 部署 | Vercel Edge Functions（60+）、Railway 中继、Tauri、PWA | | 缓存 | Redis（Upstash）、三级缓存、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 | | Fork 并修改 | 是，在需要时按 AGPL-3.0-only 共享源代码 | | 商业使用 / SaaS | 是，在遵守 AGPL 义务的前提下遵循 AGPL-3.0-only | | 闭源专有使用或官方品牌使用权 | 需要单独的商业或商标许可 |

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

作者

Elie Habib — GitHub

贡献者

安全致谢

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

Cody Richard — 披露了三个安全问题，涵盖 IPC 命令暴露、渲染器到侧车信任边界分析以及 fetch patch 凭据注入架构（2026 年）

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

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

koala73 worldmonitor