2569718930@qq.com
94 lines
3.2 KiB
Markdown
94 lines
3.2 KiB
Markdown
# 🌡️ PolyWeather: Real-time Weather Query & Analysis Bot
|
|
|
|
An intelligent weather information bot designed to provide ultra-fast, live meteorological data, high-fidelity forecasts, and smart trend analysis. Built for speed and accuracy, it bypasses network caching to deliver the most up-to-date reports from global weather stations.
|
|
|
|
## 🚀 Quick Start
|
|
|
|
### Requirements
|
|
|
|
- **Python 3.11+**
|
|
- Dependencies: `pip install -r requirements.txt`
|
|
|
|
### Running Locally (Windows/Linux)
|
|
|
|
```bash
|
|
# Windows
|
|
py -3.11 run.py
|
|
|
|
# Linux/VPS
|
|
python3 run.py
|
|
```
|
|
|
|
_Note: The system is currently in **Weather Query Mode**. Active market monitoring and automated trading modules are suspended._
|
|
|
|
---
|
|
|
|
## 🤖 Telegram Bot Commands
|
|
|
|
| Command | Description | Usage |
|
|
| :------------- | :--------------------- | :--------------------------------------------- |
|
|
| `/city [name]` | **Query City Weather** | Get detailed forecasts, METAR & trend analysis |
|
|
| `/id` | **Get Chat ID** | Retrieve your current Telegram Chat ID |
|
|
| `/help` | **Help** | Display all available commands |
|
|
|
|
### /city Command Example
|
|
|
|
```
|
|
/city London
|
|
```
|
|
|
|
**Real-time Output:**
|
|
|
|
> 📍 **London 天气详情**
|
|
> ⏱️ 生成时间: 00:41:17
|
|
> ═══ ═══ ═══ ═══ ═══ ═══
|
|
> 🕐 当地时间: 16:41
|
|
>
|
|
> 📊 **Open-Meteo 7天预测**
|
|
> 👉 今天: 最高 12°C
|
|
> 02-09: 最高 11°C
|
|
>
|
|
> ✈️ **机场实测 (EGLC)**
|
|
> 🌡️ 10.0°C
|
|
> 💨 风速: 12kt
|
|
> 🕐 观测: 16:20 (当地)
|
|
>
|
|
> 💡 **态势分析**
|
|
> 📉 **处于降温期**：气温已开始从峰值下滑，今日大概率不会再反弹。
|
|
> 🍃 **清劲风**：空气流动快，虽然有助于散热，但可能伴随阵风引起微小波动。
|
|
|
|
---
|
|
|
|
## ✨ Key Features
|
|
|
|
### 1. 💡 Intelligent Trend Analysis
|
|
|
|
The bot doesn't just show numbers; it performs a **Live vs. Forecast** analysis:
|
|
|
|
- **Peak Detection**: Determines if the daily high has likely already passed.
|
|
- **Atmospheric Physics**: Uses humidity and dew point to predict if the temperature will "stall" at night.
|
|
- **Volatility Alerts**: Flags high wind speeds that might cause rapid temperature swings.
|
|
|
|
### 2. ✈️ High-Fidelity Airport Data (METAR)
|
|
|
|
Directly connected to **NOAA Aviation Weather**, the bot fetches raw METAR data from major international airports.
|
|
|
|
- Automatic conversion from UTC to **City Local Time**.
|
|
- Real-time station observations (Temperature, Wind, Dew Point).
|
|
|
|
### 3. ⚡ Ultra-Fresh Data (Cache Busting)
|
|
|
|
Engineered to bypass ISP and proxy caches:
|
|
|
|
- Every request includes a **micro-timestamp token**.
|
|
- Forces weather servers (Open-Meteo/NOAA) to deliver fresh results instead of stale cached snapshots.
|
|
|
|
---
|
|
|
|
## 🏗️ Architecture Note
|
|
|
|
The project contains a legacy **Monitoring Engine** and **Paper Trading System** (located in `main.py`). These features are currently **deactivated** to prioritize high-speed on-demand weather reporting.
|
|
|
|
- To re-enable monitoring: Uncomment `monitor_thread.start()` in `run.py`.
|
|
- Documentation for inactive features: See [MARKET_DISCOVERY.md](./MARKET_DISCOVERY.md) and [PAPER_TRADING_GUIDE.md](./PAPER_TRADING_GUIDE.md).
|