latemonk/k-watch
GitHub: latemonk/k-watch
K-Watch 是一个以韩国为中心的开源 AI 态势感知仪表板，将新闻、船舶、航空、海洋气象与 AI 分析整合在单一界面，解决多源信号实时监控与情报聚合的难题。
Stars: 0 | Forks: 0
# K-Watch — 大韩民国 AI 综合管控制台
**以韩国为中心、基于 AI 的态势感知控制台** — 这是一个开源的综合管控仪表板，可在单一界面上实时监控朝鲜半岛地区的新闻、海洋、航空、安全和灾难信号。
🔗 **实时演示**: https://k-watch.onpod.ai
[](https://k-watch.onpod.ai)
[](https://www.gnu.org/licenses/agpl-3.0)
[](https://www.typescriptlang.org/)
## 项目介绍
K-Watch 基于 [World Monitor](https://github.com/koala73/worldmonitor)（© Elie Habib, AGPL-3.0）出色的仪表板架构起步，是一个**针对韩国态势感知需求重建了几乎所有内容的衍生项目**。除了 UI 骨架外，大部分数据层都以韩国为核心进行了重构，我们根据 AGPL-3.0 协议将整体成果重新回馈给开源社区。
相较于原项目的主要修改与新增开发：
| 领域 | 内容 |
|---|---|
| 🗺 **地图与区域** | 以朝鲜半岛为中心的区域预设、韩国近海监控瓦片设计、图层全面重组 |
| 📰 **新闻** | 整合韩国主要媒体（通讯社、广播、报纸）的实时 Feed，分类为综合/海洋/航空/安全/灾难频道，实时突发新闻流 |
| 🤖 **AI 分析** | 韩语 AI 洞察简报（新闻聚类摘要、局势分析）、按国家划分的 AI 简报 — 兼容任何 OpenAI 标准的 LLM，推荐使用 [BizRouter](https://bizrouter.ai) 智能路由 |
| 🚢 **船舶 (AIS)** | aisstream websocket（主）+ VesselAPI 扫描（辅助）双数据源中继，每月配额原子化预留引擎，釜山、仁川、蔚山的进出港事件 |
| 🌊 **海洋气象与水温** | [BluePin](https://bluepin.ai) 海洋观测与预测 API — 整合国立海洋调查院、气象厅海洋浮标及水产科学院数据，沿海 6 个区域的水温、波高、阵风 |
| ✈️ **航空** | 基于 adsb.lol 的无密钥真实军机追踪数据，紧急应答机代码（7500/7600/7700）检测 |
| 🎯 **关注目标追踪** | 船舶/航空器观察列表：轨迹叠加、信号丢失、长期徘徊、急剧转向、进入敏感海域、急剧下降警报 |
| 🌏 **国家信息** | 全面移除原项目的付费 (PRO) 限制 — 使用 IMF、美国财政部（国家债务）、OFAC（制裁）、UN Comtrade（进口项目与贸易流向）、World Bank（关税）等**全部免费的公共数据替代** |
| 🇰🇷 **韩语化** | UI、数据标签乃至 AI 输出全面韩文化 |
| 📦 **自托管** | 单容器 all-in-one 镜像（内置 redis、中继、API、nginx） |
我们对原作者 Elie Habib 的工程技术表示深深的敬意和感谢。如果您喜欢这个项目，也请给[原项目 World Monitor](https://github.com/koala73/worldmonitor) 点亮 ⭐。
## 快速开始 (自托管)
```
git clone https://github.com/latemonk/k-watch.git
cd k-watch
# all-in-one 镜像 (redis + AIS 中继 + API + nginx)
docker build -f Dockerfile.onpod -t k-watch .
docker run -p 8080:8080 \
-e AISSTREAM_API_KEY=... \
-e VESSELAPI_API_KEY=... \
-e LLM_API_URL=https://api.openai.com/v1 \
-e LLM_API_KEY=... \
-e LLM_MODEL=gpt-4o-mini \
k-watch
```
→ http://localhost:8080
所有的 key 都是**可选的**。如果没有配置 key，相关功能会被禁用，其余部分仍会正常运行。多容器配置请参阅 [SELF_HOSTING.md](SELF_HOSTING.md)，本地开发请参阅 `.env.example`。
## API 密钥获取指南
| 环境变量 | 功能 | 获取处 | 备注 |
|---|---|---|---|
| `AISSTREAM_API_KEY` | 实时船舶 (AIS) websocket | https://aisstream.io — 注册后在仪表板中免费获取 | 免费版本。通过订阅朝鲜半岛区域框使用 |
| `VESSELAPI_API_KEY` | 船舶扫描增强、搜索、轨迹、进出港 | https://vesselapi.com — 注册后获取 API 密钥 | 付费（每月调用配额）。内置配额引擎基于每月 1,500 次调用进行预算管理。可通过 `VESSELAPI_MAX_SWEEP_CALLS`、`VESSELAPI_SWEEP_INTERVAL_MS` 进行调整 |
| `BIZROUTER_API_KEY` | AI 洞察、简报、摘要（推荐） | https://bizrouter.ai — 注册后获取 API 密钥 | 兼容 OpenAI 的 LLM 网关。默认的 `route` 模型会为每次请求自动选择最优模型（智能路由），韩语输出质量极佳。可通过 `BIZROUTER_MODEL` 固定模型 |
| `LLM_API_URL` / `LLM_API_KEY` / `LLM_MODEL` | AI 洞察、简报生成（直接指定时） | 任何兼容 OpenAI 的 endpoint — OpenAI(platform.openai.com)、自托管 vLLM 等 | 建议使用韩语输出质量较好的模型 |
| `GROQ_API_KEY` | （可选）摘要降级链 | https://console.groq.com | 免费套餐每日 14,400 次 |
| `BLUEPIN_API_URL` / `BLUEPIN_API_KEY` | （可选）海洋气象与水温（沿海 6 个区域） | https://bluepin.ai — BluePin 海洋观测与预测 API | 默认的公开预览 endpoint **无需 key 即可运行**。仅在使用专属套餐时需要配置 |
| `WM_SESSION_SECRET` | 浏览器会话 HMAC | 任意随机字符串 | 若未设置，则每次启动时自动生成（若是单一 replica 则直接使用即可） |
航空（军机）数据使用 [adsb.lol](https://adsb.lol) 的公开 API，因此**不需要 key**。国家信息卡片（国家债务、制裁、贸易、关税）同样使用 IMF、OFAC、UN Comtrade、World Bank 的公开 API，无需 key。海洋气象与水温面板使用 [BluePin](https://bluepin.ai) 海洋观测与预测 API（整合了国立海洋调查院、气象厅海洋浮标、水产科学院的数据），默认的公开 endpoint 无需 key 即可运行。其他可选 key（用于原项目功能的 FRED、NASA FIRMS 等）已在 `.env.example` 中列出。
## English 摘要
K-Watch is a Korea-focused, AI-powered situational awareness console derived from [World Monitor](https://github.com/koala73/worldmonitor) by Elie Habib (AGPL-3.0). While it inherits the excellent dashboard architecture of the original, most of the data plane has been rebuilt for the Korean theater: Korean major-media news feeds and breaking-news streams, a dual-source AIS vessel relay (aisstream websocket + VesselAPI sweeps with an atomic monthly-quota engine), keyless military aviation tracking via adsb.lol, vessel/aircraft watchlists with anomaly alerts (signal loss, loitering, sharp turns, sensitive-water entry, emergency squawks), Korean-language AI insight briefs that work with any OpenAI-compatible LLM, port arrival/departure events for Busan/Incheon/Ulsan, full Korean localization, and a single-container self-hosting image. The upstream paid (PRO) gates were removed entirely and replaced with free public data sources (IMF, US Treasury, OFAC, UN Comtrade, World Bank).
We are deeply grateful to the original author — if you like this project, please star the [original World Monitor](https://github.com/koala73/worldmonitor) too.
## 许可证
本项目基于 **GNU AGPL-3.0** 协议发布。请参阅 [LICENSE](LICENSE)。
- 原项目: World Monitor — Copyright (C) 2024-2026 Elie Habib ([koala73/worldmonitor](https://github.com/koala73/worldmonitor))
- 修改版: K-Watch modifications — Copyright (C) 2026 AI3 Inc. ([latemonk](https://github.com/latemonk))
- 本仓库是修改原项目后产生的衍生作品（修改日期：2026-07），全部源代码均根据 AGPL-3.0 条款公开。如果您通过网络将该软件作为服务提供，则必须根据 AGPL §13 的规定向用户提供源代码访问权限。
## 贡献
欢迎提交 Issue 和 PR。关于安全漏洞，请使用 [GitHub 私密漏洞报告](../../security/advisories/new) 代替公开 Issue。
标签：HTTP/HTTPS抓包, TypeScript, 人工智能, 信息聚合, 地图可视化, 安全插件, 态势感知, 搜索引擎查询, 用户模式Hook绕过, 监控大屏, 自定义脚本, 请求拦截