diff --git a/README.md b/README.md index fc6a97d0..3c62e90f 100644 --- a/README.md +++ b/README.md @@ -34,54 +34,83 @@ _Note: The system is currently in **Weather Query Mode**. Active market monitori ### /city Command Example ``` -/city London +/city Chicago ``` **Real-time Output:** -> 📍 **London 天气详情** -> ⏱️ 生成时间: 00:41:17 -> ═══ ═══ ═══ ═══ ═══ ═══ -> 🕐 当地时间: 16:41 +> 📍 **Chicago 天气详情** +> ⏱️ 生成时间: 12:45:30 +> ════════════════════ +> 🕐 当地时间: 12:45 > > 📊 **Open-Meteo 7天预测** -> 👉 今天: 最高 12°C -> 02-09: 最高 11°C +> 👉 今天: 最高 22.4°F (NWS: 23°F) +> 02-08: 最高 26.2°F +> 02-09: 最高 37.2°F > -> ✈️ **机场实测 (EGLC)** -> 🌡️ 10.0°C -> 💨 风速: 12kt -> 🕐 观测: 16:20 (当地) +> ✈️ **机场实测 (KORD)** +> 🌡️ 21.0°F (今日最高: 23.0°F) +> 💨 风速: 4kt +> 🕐 观测: 12:00 (当地) > > 💡 **态势分析** -> 📉 **处于降温期**：气温已开始从峰值下滑，今日大概率不会再反弹。 -> 🍃 **清劲风**：空气流动快，虽然有助于散热，但可能伴随阵风引起微小波动。 +> ⏱️ **预计峰值时刻**：今天 14:00 - 16:00 之间。 +> 🎯 **博弈建议**：关注该时段实测能否站稳 22.4°F。 +> 📈 **升温进程中**：距离峰值还有约 1.4° 空间，正向高点冲击。 --- ## ✨ Key Features -### 1. 💡 Intelligent Trend Analysis +### 1. 🏛️ Multi-Source Data Fusion -The bot doesn't just show numbers; it performs a **Live vs. Forecast** analysis: +The bot aggregates data from multiple authoritative sources: -- **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. +| Source | Data Type | Coverage | +| -------------- | ------------------------------ | ----------------- | +| **Open-Meteo** | 7-day forecast | Global | +| **NWS** | Official US forecast | US cities only ⚠️ | +| **METAR** | Real-time airport observations | Global airports | -### 2. ✈️ High-Fidelity Airport Data (METAR) +- **⚠️ Divergence Alerts**: When Open-Meteo and NWS disagree by >1°F, the bot flags it for your attention. + +### 2. ⏱️ Peak Timing Prediction + +For each city, the bot analyzes the hourly forecast curve to identify: + +- **Exact peak window**: e.g., "14:00 - 16:00" +- **Betting recommendation**: Monitor real-time data during this window + +### 3. 📊 Today's High Tracking + +METAR data is filtered by **local calendar day** using UTC offset: + +- Only observations from **local midnight onwards** are counted +- Ensures "Today's High" is accurate, not polluted by yesterday's warm afternoon + +### 4. ✈️ 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) +### 5. ⚡ 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. +- Forces weather servers (Open-Meteo/NOAA/NWS) to deliver fresh results instead of stale cached snapshots. + +--- + +## 🎯 Betting Strategy Tips + +1. **Check model consensus**: If Open-Meteo and NWS agree, confidence is high. +2. **Watch the peak window**: Monitor METAR during predicted peak hours. +3. **Use "Today's High"**: Track the actual recorded maximum vs forecast. +4. **Interpret ⚠️ warnings**: Divergence means uncertainty—proceed with caution. --- diff --git a/README_ZH.md b/README_ZH.md index dcd12b11..a0a0a5c4 100644 --- a/README_ZH.md +++ b/README_ZH.md @@ -1,15 +1,15 @@ -# 🌡️ PolyWeather: 实时天气查询与态势分析机器人 +# 🌡️ PolyWeather: 实时天气查询与分析机器人 -基于多源实时气象数据（Open-Meteo、NOAA METAR）的智能天气分析系统。该系统专为速度与准确性设计，通过强制穿透网络缓存，为用户提供全球气象站最即时的实测报告与态势逻辑分析。 +一个智能天气信息机器人，专为提供超快、实时的气象数据、高保真预报和智能趋势分析而设计。通过绕过网络缓存，直接从全球气象站获取最新数据。 ## 🚀 快速开始 -### 环境依赖 +### 环境要求 - **Python 3.11+** -- 安装依赖: `pip install -r requirements.txt` +- 依赖安装: `pip install -r requirements.txt` -### 启动运行 (Windows/Linux) +### 本地运行 (Windows/Linux) ```bash # Windows @@ -19,75 +19,104 @@ py -3.11 run.py python3 run.py ``` -_注：系统当前运行于**天气查询模式**。主动市场监控引擎和自动模拟交易模块已暂时关闭。_ +_注意：系统当前处于 **天气查询模式**。主动市场监控和自动交易模块已暂停。_ --- -## 🤖 电报机器人指令 (Telegram) +## 🤖 Telegram 机器人指令 -| 指令 | 描述 | 用法 | -| :--------------- | :--------------- | :--------------------------------------- | -| `/city [城市名]` | **查询城市天气** | 获取预测、机场实测及深度的“态势分析”结论 | -| `/id` | **获取 Chat ID** | 获取当前聊天的唯一 ID | -| `/help` | **帮助** | 显示所有可用指令 | +| 指令 | 功能 | 说明 | +| :------------- | :--------------- | :------------------------------- | +| `/city [城市]` | **查询城市天气** | 获取详细预报、机场实测与趋势分析 | +| `/id` | **获取 Chat ID** | 获取当前 Telegram 聊天 ID | +| `/help` | **帮助** | 显示所有可用指令 | ### /city 指令示例 ``` -/city 伦敦 +/city 芝加哥 ``` -**实时输出效果：** +**实时输出：** -> 📍 **London 天气详情** -> ⏱️ 生成时间: 00:41:17 -> ═══ ═══ ═══ ═══ ═══ ═══ -> 🕐 当地时间: 16:41 +> 📍 **Chicago 天气详情** +> ⏱️ 生成时间: 12:45:30 +> ════════════════════ +> 🕐 当地时间: 12:45 > > 📊 **Open-Meteo 7天预测** -> 👉 今天: 最高 12°C -> 02-09: 最高 11°C +> 👉 今天: 最高 22.4°F (NWS: 23°F) +> 02-08: 最高 26.2°F +> 02-09: 最高 37.2°F > -> ✈️ **机场实测 (EGLC)** -> 🌡️ 10.0°C -> 💨 风速: 12kt -> 🕐 观测: 16:20 (当地) +> ✈️ **机场实测 (KORD)** +> 🌡️ 21.0°F (今日最高: 23.0°F) +> 💨 风速: 4kt +> 🕐 观测: 12:00 (当地) > > 💡 **态势分析** -> 📉 **处于降温期**：气温已开始从峰值下滑，今日大概率不会再反弹。 -> 🍃 **清劲风**：空气流动快，虽然有助于散热，但可能伴随阵风引起微小波动。 +> ⏱️ **预计峰值时刻**：今天 14:00 - 16:00 之间。 +> � **博弈建议**：关注该时段实测能否站稳 22.4°F。 +> 📈 **升温进程中**：距离峰值还有约 1.4° 空间，正向高点冲击。 --- -## ✨ 核心特性 +## ✨ 核心功能 -### 1. 💡 智能态势分析 (Trend Analysis) +### 1. 🏛️ 多源数据融合 -机器人不再只是罗列数字，它通过**实测对比预测**的逻辑进行深度解读： +机器人聚合多个权威数据源： -- **峰值判定**：分析当前时间点，判断日间最高温是否已经产生。 -- **物理态势**：利用湿度和露点数据，分析夜间气温是否存在“跌不动”的支撑点。 -- **波动预警**：根据机场风速监控，预警可能导致气温突变的锋面过境。 +| 数据源 | 数据类型 | 覆盖范围 | +| -------------- | ------------ | ------------- | +| **Open-Meteo** | 7天预报 | 全球 | +| **NWS** | 美国官方预报 | 仅美国城市 ⚠️ | +| **METAR** | 机场实时观测 | 全球主要机场 | -### 2. ✈️ 高保真机场实测 (METAR) +- **⚠️ 分歧预警**：当 Open-Meteo 和 NWS 预测差异超过 1°F 时，机器人会标注提醒。 -直接对接 **NOAA (美国国家海洋和大气管理局)** 的官方接口： +### 2. ⏱️ 峰值时刻预测 -- **自动时区转换**：将机场 UTC 观测时间自动转换为**城市当地时间**。 -- **专业级参数**：获取温度、风速、露点、相对湿度等专业观测值。 +机器人分析每个城市的逐小时预报曲线，识别： -### 3. ⚡ 数据绝对实时 (Cache Busting) +- **精确峰值窗口**：如 "14:00 - 16:00" +- **博弈建议**：在此窗口期关注实测数据变化 -针对网络代理和 CDN 缓存进行了底层加固： +### 3. 📊 今日最高温追踪 -- 每一个 API 请求均带有**微秒级随机时间戳**。 -- 强制穿透所有中间缓存，确保获取的是气象站此时此刻的最新读数。 +METAR 数据按**当地日历日**过滤（使用 UTC 偏移）： + +- 只统计**当地零点之后**的观测记录 +- 确保"今日最高"准确，不受昨天下午高温干扰 + +### 4. ✈️ 高保真机场数据 (METAR) + +直连 **NOAA 航空气象中心**，获取原始 METAR 数据： + +- 自动将 UTC 时间转换为**城市当地时间** +- 实时观测（温度、风速、露点） + +### 5. ⚡ 超新鲜数据（缓存穿透） + +专门设计以绕过 ISP 和代理缓存： + +- 每次请求附带**微秒时间戳令牌** +- 强制 Open-Meteo/NOAA/NWS 返回最新数据 + +--- + +## 🎯 博弈策略提示 + +1. **检查模型共识**：如果 Open-Meteo 和 NWS 一致，置信度高。 +2. **关注峰值窗口**：在预测的峰值时段多次刷新 METAR。 +3. **使用"今日最高"**：对比实测峰值与预报值。 +4. **解读 ⚠️ 警告**：分歧意味着不确定性——谨慎操作。 --- ## 🏗️ 架构说明 -本项目包含一套遗留的 **监控引擎 (Monitoring Engine)** 和 **模拟交易系统 (Paper Trading)**（位于 `main.py`）。为了提供最高效的点对点天气查询服务，目前这些功能已处于**休眠状态**。 +项目包含一个遗留的**监控引擎**和**模拟交易系统**（位于 `main.py`）。这些功能目前**已停用**，以优先保障高速按需天气查询。 -- 如需重新启用：请取消 `run.py` 中 `monitor_thread.start()` 的注释。 -- 遗留功能文档参见：[市场扫描说明](./MARKET_DISCOVERY_ZH.md) 和 [模拟交易指南](./PAPER_TRADING_GUIDE.md)。 +- 重新启用监控：取消 `run.py` 中 `monitor_thread.start()` 的注释。 +- 已停用功能的文档：参见 [MARKET_DISCOVERY_ZH.md](./MARKET_DISCOVERY_ZH.md) 和 [PAPER_TRADING_GUIDE.md](./PAPER_TRADING_GUIDE.md)。