Files
PolyWeather/README_ZH.md
T

123 lines
3.8 KiB
Markdown

# 🌡️ PolyWeather: 实时天气查询与分析机器人
一个智能天气信息机器人,专为提供超快、实时的气象数据、高保真预报和智能趋势分析而设计。通过绕过网络缓存,直接从全球气象站获取最新数据。
## 🚀 快速开始
### 环境要求
- **Python 3.11+**
- 依赖安装: `pip install -r requirements.txt`
### 本地运行 (Windows/Linux)
```bash
# Windows
py -3.11 run.py
# Linux/VPS
python3 run.py
```
_注意:系统当前处于 **天气查询模式**。主动市场监控和自动交易模块已暂停。_
---
## 🤖 Telegram 机器人指令
| 指令 | 功能 | 说明 |
| :------------- | :--------------- | :------------------------------- |
| `/city [城市]` | **查询城市天气** | 获取详细预报、机场实测与趋势分析 |
| `/id` | **获取 Chat ID** | 获取当前 Telegram 聊天 ID |
| `/help` | **帮助** | 显示所有可用指令 |
### /city 指令示例
```
/city 芝加哥
```
**实时输出:**
> 📍 **Chicago 天气详情**
> ⏱️ 生成时间: 12:45:30
> ════════════════════
> 🕐 当地时间: 12:45
>
> 📊 **Open-Meteo 7天预测**
> 👉 今天: 最高 22.4°F (NWS: 23°F)
> 02-08: 最高 26.2°F
> 02-09: 最高 37.2°F
>
> ✈️ **机场实测 (KORD)**
> 🌡️ 21.0°F (今日最高: 23.0°F)
> 💨 风速: 4kt
> 🕐 观测: 12:00 (当地)
>
> 💡 **态势分析**
> ⏱️ **预计峰值时刻**:今天 14:00 - 16:00 之间。
> **博弈建议**:关注该时段实测能否站稳 22.4°F。
> 📈 **升温进程中**:距离峰值还有约 1.4° 空间,正向高点冲击。
---
## ✨ 核心功能
### 1. 🏛️ 多源数据融合
机器人聚合多个权威数据源:
| 数据源 | 数据类型 | 覆盖范围 |
| -------------- | ------------ | ------------- |
| **Open-Meteo** | 7天预报 | 全球 |
| **NWS** | 美国官方预报 | 仅美国城市 ⚠️ |
| **METAR** | 机场实时观测 | 全球主要机场 |
- **⚠️ 分歧预警**:当 Open-Meteo 和 NWS 预测差异超过 1°F 时,机器人会标注提醒。
### 2. ⏱️ 峰值时刻预测
机器人分析每个城市的逐小时预报曲线,识别:
- **精确峰值窗口**:如 "14:00 - 16:00"
- **博弈建议**:在此窗口期关注实测数据变化
### 3. 📊 今日最高温追踪
METAR 数据按**当地日历日**过滤(使用 UTC 偏移):
- 只统计**当地零点之后**的观测记录
- 确保"今日最高"准确,不受昨天下午高温干扰
### 4. ✈️ 高保真机场数据 (METAR)
直连 **NOAA 航空气象中心**,获取原始 METAR 数据:
- 自动将 UTC 时间转换为**城市当地时间**
- 实时观测(温度、风速、露点)
### 5. ⚡ 超新鲜数据(缓存穿透)
专门设计以绕过 ISP 和代理缓存:
- 每次请求附带**微秒时间戳令牌**
- 强制 Open-Meteo/NOAA/NWS 返回最新数据
---
## 🎯 博弈策略提示
1. **检查模型共识**:如果 Open-Meteo 和 NWS 一致,置信度高。
2. **关注峰值窗口**:在预测的峰值时段多次刷新 METAR。
3. **使用"今日最高"**:对比实测峰值与预报值。
4. **解读 ⚠️ 警告**:分歧意味着不确定性——谨慎操作。
---
## 🏗️ 架构说明
项目包含一个遗留的**监控引擎**和**模拟交易系统**(位于 `main.py`)。这些功能目前**已停用**,以优先保障高速按需天气查询。
- 重新启用监控:取消 `run.py``monitor_thread.start()` 的注释。
- 已停用功能的文档:参见 [MARKET_DISCOVERY_ZH.md](./MARKET_DISCOVERY_ZH.md) 和 [PAPER_TRADING_GUIDE.md](./PAPER_TRADING_GUIDE.md)。