PolyWeather/README_ZH.md

# 🌡️ PolyWeather: 量化天气交易与 AI 控制中枢

![Banner Placeholder: Futuristic Weather Trading System]

PolyWeather 不仅仅是一个天气查询工具，它是专为 **Polymarket/天气衍生品** 等预测市场打造的**机构级气象量化交易辅助系统**。它通过直连全球航空级别气象站 (METAR)，结合多模型动态权重融合 (DEB)、实时微气候特征工程，并由庞大的 LLaMA 70B AI 大模型剥离人工情绪，为您提供极速、客观、致命的交易信号。

---

## 🚀 核心战力矩阵 (Core Features)

### 1. 🧠 独家护城河：动态权重集合算法 (DEB - Dynamic Ensemble Blending)

传统气象机器人只会机械地计算欧洲 ECMWF 和美国 GFS 的死板平均值。PolyWeather 引入了**动态记账与回溯算法**：

- **自适应权重进化**：基于过去 7-14 天内各个模型在特定机场（如 Ankara 的 Esenboğa 机场）的Mean Absolute Error (平均绝对误差 MAE) 表现，系统在每次查询时会自动对 5 大预测模型（ECMWF, GFS, ICON, GEM, JMA）进行误差惩罚。
- **高频并发安全锁 (Thread-Safe Database)**：搭载底层内存态单例缓存机制与系统级文件并发锁 (fcntl Lock)，即使在 500 人以上的超级大群遭遇瞬间峰值查询，系统依然能保证 0 I/O 拥堵和微秒级响应。

### 2. 🤖 人工智能交易老手 (Groq AI Agent)

系统不再输出枯燥的数字或废话模版。我们将**所有复杂的动力学参数**(风向、风速矩阵、降温惯性、进位阻力) 投喂给 LLaMA 3.3 70B (通过极速 Groq 接口)：

- **🧊 强制冷静，剥离情绪**：独创强迫逻辑约束提示词，AI 会精准判断诸如“下午3点吹 15kt 偏北冷风，且辐射跌破 50W/m²”的情况，并直接宣布“已过最热时点核心区，盘口冻结”。
- **🎯 量化置信度 (Confidence Scoring)**：直接给出带有强指导意义的 1-10 满分制置信度。置信度极高意味着“立刻建仓”，置信度极低则警告系统遇到了风向或降雨的不确定性博弈。

### 3. ⏱️ 绝对实况统治力 (Zero-Cache METAR Extraction)

在 Polymarket 结算的绞肉机里，**1 分钟的延迟可能意味着 100% 的本金亏损**。

- PolyWeather 设计为每次调用均动态附加一次性戳环，强制穿透所有代理网络（CDN）的静态缓存池。
- 提取出的不仅是“当下几度”，而是精确到小数点的结算分析（包括 Wunderground X.5 四舍五入进制边界的死亡预警）。

### 4. 📈 历史大数据挖掘基建 (Data Mining Foundation)

内置 `fetch_history.py` 原生爬虫系统。

- 一键下拉全球任意城市基准点过去 3-5 年的小时级历史物理沙盒数据特征矩阵（包含湿度、长短波辐射、地表气压等 10 余个维度），最高达数十万行量级。
- 随时为下一代 XGBoost / LightGBM 的机器学习偏差校正（MOS）提供无限火力弹药。

---

## ⚡ 部署指南 (Deployment & Operations)

### 环境架构要求

- **内核驱动**: Python 3.11+ (严格遵守)
- **依赖栈**: `pip install -r requirements.txt`
- **系统挂载**: 极简配置，仅需 `.env` 文件注册您的 `TELEGRAM_BOT_TOKEN` 及 `GROQ_API_KEY` 即可召唤 AI。

### VPS 推荐一键上线 (Production)

**步骤一：构建与注册**

```bash
git clone https://github.com/yangyuan-zhen/PolyWeather.git
cd PolyWeather
pip install -r requirements.txt
cp .env.example .env  # 务必填入您的加密 API 密钥
```

**步骤二：守护进程一键装配 (Daemon Updater)**
建立自动化保活脚本，将更新、防冲突、重载集成在一条指令内：

```bash
cat > ~/update.sh << 'EOF'
#!/bin/bash
cd ~/PolyWeather
git fetch origin
git reset --hard origin/main
pkill -f run.py
pkill -f bot_listener.py
sleep 1
nohup python3 bot_listener.py > bot.log 2>&1 &
echo "✅ PolyWeather 量化终端已成功重启并搭载最新模块！"
EOF
chmod +x ~/update.sh
```

**日常战争指令 (Push & Play)：**

```bash
~/update.sh
```

> 一键抹平 Git 冲突、热冷重启及日志切割。

---

## 🕹️ Telegram 指控终端 (Command Center)

| 战术指令           | 触发动作     | 模块反馈                                                                                |
| :----------------- | :----------- | :-------------------------------------------------------------------------------------- |
| `/city [城市代码]` | **火力侦察** | 发起全维度气象扫描，返回 DEB 加权预报、实测跟踪、进位结算风险预警，及 AI 量化看盘结论。 |
| `/id`              | **身份确认** | 映射当前交战信道（Chat ID）。                                                           |
| `/help`            | **终端手册** | 拉取最新指令集。                                                                        |

### 支持的主力猎场 (Target Arenas)

从低风险高容错的中东非靶场，到高风险巨大滑点的北美绞肉机，PolyWeather 均提供了不同的机场偏误(Risk Profile)补偿模板：
`lon`(伦敦 EGLC)、`par`(巴黎 LFPG)、`ank`(安卡拉 LTAC)、`nyc`(纽约 KLGA)、`chi`(芝加哥 KORD)、`ba`(布宜诺斯艾利斯 SAEZ)... 以及更多。

> **示例射击:**
> `/city 巴黎`
> `/city london`
> `/city ba`

---

## 🏗️ 引擎架构剖析 (System Architecture)

```mermaid
graph TD
    classDef ai fill:#f9f,stroke:#333,stroke-width:2px;
    classDef core fill:#bbf,stroke:#333,stroke-width:2px;
    classDef data fill:#dfd,stroke:#333,stroke-width:1px;

    User[Telegram / 信号接收方] -->|触发扫描指令| Bot[bot_listener.py 核心调度器]:::core

    subgraph 异构数据获取层
        Bot --> Collector[WeatherDataCollector]
        Collector --> OM[Open-Meteo 归档/实时]:::data
        Collector --> MM[多模型预测集 (ECMWF...)]:::data
        Collector --> METAR[机场真实塔台日志]:::data
    end

    subgraph 模型计算与熔断层
        Collector --> DEB[DEB 动态融合加权算法]:::core
        DEB --> DB[(daily_records JSON 数据库<br/>并发安全保护)]
        Collector --> Logic[结算进位判定 / 冷却判定]
    end

    subgraph AI 量度生成层
        DEB --> AIAnalyzer[Groq/LLaMA 深度认知模型]:::ai
        Logic --> AIAnalyzer
        METAR --> AIAnalyzer
    end

    AIAnalyzer -->|生成: 盘口+逻辑+置信度| Bot
    Bot -->|组合高维信息切片| User
```

---

## 🎯 实战交易纲领 (Trader's Playbook)

作为 PolyWeather 的指挥官，请将以下准则刻入 DNA 之中：

1. 🧬 **信仰 DEB 基准线**：比起单方面相信 ECMWF 或 GFS 的某个极端值，请紧盯开头那一行 `DEB 融合预测`。因为那是系统吸收了最近几天这两个模型挨过的毒打之后，为您重新调整过的公论。
2. 🎯 **严守 AI 置信度红线**：一旦 AI 反馈 `置信度 ≤ 4/10`，代表模型数据严重滞后于实况机场风速带来的博弈冲突，立即**切断**盲目押注的手，这属于高风险混沌区。
3. ⚖️ **敬畏 X.5 结界**：Polymarket 天气盘底层以 Wunderground 取整数结算为准。当你看到终端闪烁 `⚖️ 结算边界... 刚刚越过进位线` 时，这往往是盘面上流动性抽干、盘口滑点最凶残的地方。
4. 🌙 **识破假阳性 (暖平流侦测)**：若气温在辐射低谷的夜间和清晨依然狂飙，此时系统必然触发 `🌙 暖平流动力异常`。这一机制经常会在绝大多数赌客看跌时，为您指出真正做多打穿预报上限的信号。

---

_The weather changes. Our edge remains. | 更新于 2026_