PolyWeather/README_ZH.md

PolyWeather Pro

面向温度结算市场的生产级气象情报系统。

官方看板：polyweather-pro.vercel.app

这个项目在做什么

• 聚合监控城市的实测与预报数据。
• 用 DEB（Dynamic Error Balancing）做动态融合预测。
• 计算结算导向的温度概率分布（μ + 温度桶）。
• 将模型概率与 Polymarket 只读市场数据对齐，输出错价/风险信号。
• Web 仪表盘与 Telegram 机器人共用同一套核心逻辑。

思维导图

mindmap
  root((PolyWeather Pro))
    数据层
      "METAR(Aviation Weather / METAR)"
      "MGM(土耳其 MGM)"
      "安卡拉主站(17130 Center)"
      Open-Meteo
      "weather.gov(美国城市)"
      "Polymarket(P0 只读)"
    分析层
      "DEB(动态误差平衡)"
      "概率引擎(mu + 桶分布)"
      趋势引擎
      城市风险档案
      错价雷达
    交付层
      FastAPI
      "Next.js 仪表盘"
      "Telegram Bot"
      预警推送
    运维层
      "Docker Compose(VPS)"
      "Vercel(前端)"
      "缓存 + force_refresh"
      Speed Insights

系统架构

graph TD
    User[Web / Telegram 用户] --> FE[Vercel Next.js 前端]
    User --> Bot[VPS Telegram Bot]
    FE --> API[FastAPI 服务]
    Bot --> API

    API --> WX[Weather Collector]
    WX --> METAR[METAR / Aviation Weather]
    WX --> MGM[MGM API / 周边站]
    WX --> OM[Open-Meteo]
    WX --> NWS[weather.gov]

    API --> DEB[DEB + 趋势 + 概率引擎]
    API --> PM[Polymarket 只读层]
    PM --> Gamma[Gamma API]
    PM --> CLOB[CLOB / py-clob-client]

当前数据源口径

领域	当前口径
主观测源	Aviation Weather / METAR
Ankara 增强	MGM + 周边站，领先站固定 17130
预报基线	Open-Meteo
美国官方语义层	weather.gov
市场层	Polymarket P0 只读发现 + 报价
已移除	Meteoblue（代码与文档已全部移除）

最近更新（2026-03-11）

• 完整移除 Meteoblue API 及全部引用。
• 修复市场“最热温度桶”重复温度刷屏问题（后端按温度去重 + 前端兜底去重）。
• 修复详情面板可访问性告警（aria-hidden 焦点冲突），改为 inert + blur。
• 集成 Vercel Speed Insights（frontend/app/layout.tsx）。

目录说明

• 前端：frontend/（Next.js App Router）
• 后端：web/app.py 与 src/
• 机器人：bot_listener.py + src/analysis/*
• 文档：docs/

快速启动

后端 + 机器人（VPS / Docker）

docker compose up -d --build

前端本地运行

cd frontend
npm install
npm run dev

前端构建校验

cd frontend
npm run build

Telegram 命令

命令	用途
/city <name>	城市实时分析
/deb <name>	DEB 历史对账
/top	用户排行榜
/help	帮助说明

文档索引

• API 文档（中文）：docs/API_ZH.md
• 商业化路线：docs/COMMERCIALIZATION.md
• 技术债（英文）：docs/TECH_DEBT.md
• 技术债（中文）：docs/TECH_DEBT_ZH.md
• 英文总览：README.md

当前状态

• 版本：v1.3
• 最后更新：2026-03-11
• 状态：稳定运行（Web + Bot + 市场只读层）