🌡️ PolyWeather Pro

专业级博弈情报系统 —— 专注边缘气象数据采集、DEB 智能融合与实时决策预警。

💎 项目愿景

PolyWeather 是一套专为 Polymarket 深度博弈者设计的实时情报系统。我们不只提供天气预报，而是通过聚合全球气象源、应用自研 DEB (Dynamic Error Balancing) 算法，并在关键时间节点输出可执行的异动信号。

🏗️ 生产架构

本项目采用生产级解耦架构，确保高可用与迭代效率：

前端：部署在 Vercel 上的 Next.js + React 组件化仪表盘。
后端 API：运行在 VPS 上的 FastAPI，负责多源聚合与分析计算。
机器人与预警心跳：运行在 VPS 上的 Telegram Bot，执行分钟级扫描与推送。

🔗 官方访问地址：polyweather-pro.vercel.app

🖼️ 预览与交互

📊 深度查询效果：DEB 融合预测 + 结算概率 + AI 分析上下文

🗺️ 全景仪表盘：全球站点标记 + 周边站点联动 + 右侧城市详情卡片

🚀 核心功能

📡 多源全量采集
- 主流模型：ECMWF、GFS、ICON、GEM、JMA、Open-Meteo 的日/小时指导。
- 实测数据：Aviation Weather / METAR 为主观测源，安卡拉叠加 Turkish MGM 官方网络。
- 城市特化：安卡拉保留 17130（Ankara (Bölge/Center)）领先站逻辑，不替代 LTAC 结算主站。
⚖️ DEB 智能融合
- 基于城市历史表现与当前模型分歧动态调整权重。
🧩 React 仪表盘运行时
- 类型化 Store + 类型化 Data Client + Leaflet/Chart.js 生命周期封装。
- 点击城市：地图聚焦 + 右侧卡片打开 + 周边站点展示。
- 点击“今日日内分析”：打开模态框并冻结地图动画。
🔔 异动预警系统
- 动量突变：捕捉短窗口温度斜率变化。
- 预测突破：实测突破模型包络与安全边际时触发。
- 平流监测：结合前导站和风向识别冷暖平流。

🔐 预警逻辑深度说明

触发器名称	核心逻辑	博弈价值
Center Hit	仅识别安卡拉总部 `17130` 站点的 DEB 触发信号	最高级信号，定盘星
Momentum	30min 温度斜率超过	捕捉突发天气系统（如锋面）
Breakthrough	击穿所有预报上限 + 安全边际	捕捉市场极少数情况下的暴利点
Advection	前导站温升 + 风向匹配	获得 20-40 分钟的提前离场/建仓时间

🧭 当前数据逻辑

主观测源：Aviation Weather / METAR
安卡拉增强逻辑：
- 结算主观测：LTAC / Esenboğa
- 官方领先站：Ankara (Bölge/Center) / 17130
- 周边站层：土耳其 MGM 网络（含安卡拉优先站筛选）
其他城市周边站层：
- 当前生产环境使用 Aviation Weather METAR cluster
- 美国城市后续可叠加 Mesonet，但 METAR 仍为基础层
前端请求优化口径：
- 首屏先走 /api/city/{name}/summary 预热地图温度
- 城市详情 5 分钟 TTL，revision 不变则跳过重拉
- 地图联动、侧卡开关、modal 开关不会重复请求
- 手动刷新强制绕过缓存（force_refresh=true）

🏗️ 架构解析

graph TD
    subgraph "客户端 / 终端"
        Web[Next.js React 网页端]
        TG[Telegram 客户端]
    end

    subgraph "云端部署 (Vercel)"
        Web --> |BFF 路由| Fast[FastAPI API]
    end

    subgraph "核心引擎 (VPS)"
        Fast --- |Shared Logic| Worker[Alert Engine / Worker]
        Bot[Telegram Bot] --- |Shared Logic| Worker
    end

    subgraph "外部数据源"
        Worker --> |Pull| MGM[MGM 气象局]
        Worker --> |Pull| METAR[机场实测]
        Worker --> |Pull| OM[Open-Meteo]
        Worker --> |Pull| MM[多模型集成]
    end

    Worker --> |Push Alert| TG
    Bot --> |Query| Worker

🛠️ 部署指南

1. 后端 / 机器人 (VPS)

# 获取源码
git pull

# 环境配置
# 编辑 .env 文件，填入 TELEGRAM_BOT_TOKEN 等关键参数

# 一键启动
docker-compose up -d --build

2. 前端 (Vercel)

关联本项目 frontend 目录作为根目录，启用自动 CI/CD。

💬 机器人指令

命令	说明	示例
`/city`	查询指定城市实时分析	`/city ankara`
`/deb`	查看 DEB 模型的历史准确率	`/deb london`
`/top`	查看活跃积分排行榜	`/top`
`/help`	获取详细功能说明	`/help`

Note

商业化提示：当前仍以 Web 仪表盘 ($5/月) 与 Telegram 信号频道 ($1/月) 为核心入口套餐。自动化支付与订阅鉴权规划见 docs/COMMERCIALIZATION.md。

Note

前端现状：生产环境页面已由 frontend/components/dashboard 与 frontend/hooks 完整接管渲染。 legacy 静态文件仅保留为历史参考，不再作为主运行入口。

📅 最后更新：2026-03-09 🚀 状态：v1.1 稳定版 - React 运行时已上线

Tip

生产提示：在不改变既有 UI 布局与视觉层级的前提下，数据流、地图联动和模态行为已迁移到类型化 React 组件体系。

5.9 KiB Raw Permalink Blame History Unescape Escape