From b4e323402d3224ba08ce8022fade988a998d3889 Mon Sep 17 00:00:00 2001 From: "2569718930@qq.com" <2569718930@qq.com> Date: Thu, 5 Mar 2026 18:53:05 +0800 Subject: [PATCH] feat: Document new zoom-based intelligence and technical guide features, and add `TECH_DEBT.md` and update `README` files. --- README.md | 6 ++++-- README_ZH.md | 16 +++++++++------- docs/TECH_DEBT.md | 2 +- 3 files changed, 14 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 986d9a59..ff9a7b8e 100644 --- a/README.md +++ b/README.md @@ -27,6 +27,8 @@ PolyWeather is a multi-source weather analysis and quantification tool. It aggre - **Global Overview**: Real-time Leaflet-based dark-themed map pinpointed to official Polymarket settlement airport coordinates. - **Progressive Background Loading**: Intelligently fetches multi-source data across all cities without hitting API rate limits. - **Rich Visualization**: Chart.js-powered temperature trends with METAR scatter overlay, multi-model comparison bars, Gaussian probability distribution, and dynamic risk badges. +- **Zoom-based Intelligence**: Map automatically filters minor cities (e.g., Atlanta/Ankara) and local station labels at lower zoom levels to maintain clarity, showing only major global hubs when zoomed out. +- **Technical Guide Interface**: Features an interactive on-map technical guide explaining DEB prediction curves, probability bands, and risk factors. - **Cinematic Interaction & Sync**: City selection triggers a smooth fly-to zoom animation. The **Multi-Model Forecast** panel automatically synchronizes with the selected day in the 5-day forecast table, showing historical model performance and future projections. - **Forced Sync & Cache Control**: For specific regions like Ankara, the dashboard supports a 60-second real-time cache TTL with a manual "Force Refresh" button to bypass global caches and fetch the absolute latest MGM/METAR data. - **Dual-Engine Architecture**: Runs concurrently with the Telegram bot via a FastAPI backend, sharing the same data collection, analysis logic (`analyze_weather_trend`), and AI prompt pipeline. @@ -137,7 +139,7 @@ _(Note: The `update.sh` script automatically fetches the latest code, kills old | Command | Description | | :------------------ | :---------------------------------------------------------------------------------------------------------------------------------- | -| `/city [city_name]` | Get weather analysis, settlement probabilities, METAR tracking, and AI insights. | +| `/city [city_name]` | Get weather analysis, settlement probabilities, METAR tracking, and AI insights. (Includes "Bölge/Center" detail for Ankara). | | `/deb [city_name]` | View DEB accuracy: daily hit/miss breakdown, bias analysis (underestimate/overestimate), model MAE comparison, trading suggestions. | | `/id` | View the Chat ID of the current conversation. | | `/help` | Display help information. | @@ -215,4 +217,4 @@ git pull --- -_Updated 2026-03-04_ +_Updated 2026-03-05_ diff --git a/README_ZH.md b/README_ZH.md index e1408d8a..11d39c7b 100644 --- a/README_ZH.md +++ b/README_ZH.md @@ -27,6 +27,8 @@ PolyWeather 是一款多模型气象分析与量化工具。它通过聚合高 - **全球纵览**：基于 Leaflet 的暗黑全屏实时地图，直接采用官方结算机场经纬度进行追踪与显示。 - **渐进式数据流加载**：进图后智能在后台无感知拉取，不触发 API 频率限制。 - **数据可视化**：Chart.js 温度走势图叠加 METAR 实测散点，多模型对比条形图，高斯概率分布条，实时风险等级色彩系统。 +- **智能缩放过滤**：地图会根据缩放等级自动隐藏次要城市（如亚特兰大、安卡拉）和局部观测点标签，以保持全局视野清晰，仅在放大时显示细节。 +- **内置技术指南**：新增交互式技术手册面板，详细解释 DEB 预测曲线、概率区间及各类风险因子。 - **镜头与日期联动**：点击城市平滑飞入面板。**多模型预报区域**会根据“逐日预报”选中的日期自动刷新，支持查看未来 5 天各模型的历史表现与融合预测值。 - **强制同步与缓存控制**：针对安卡拉等重点区域，Web 端支持 60 秒极速缓存 TTL，并提供手动“强制刷新”按钮，可穿透全局缓存获取最及时的 MGM/METAR 实测数据。 - **周边测站热力图**：不仅追踪目标机场，还能并发抓取目标城市周边 20~50 公里内的所有气象站实测。通过地图上的“微型标签”可视化城市热岛效应与锋面推进，辅助判断冷空气过境的时间差。 @@ -136,12 +138,12 @@ _(该脚本将自动执行 git 抓取、杀僵尸进程、解绑端口、并分 ## 🕹️ 机器人指令 -| 指令 | 说明 | -| :--------------- | :------------------------------------------------------------------------------ | -| `/city [城市名]` | 获取深度气象分析、结算概率、实测追踪及 AI 决策建议。 | -| `/deb [城市名]` | 查看 DEB 准确率：逐日命中明细、偏差分析（低估/高估）、模型 MAE 对比、交易建议。 | -| `/id` | 查看当前对话的 Chat ID。 | -| `/help` | 显示说明信息。 | +| 指令 | 说明 | +| :--------------- | :--------------------------------------------------------------------------------------- | +| `/city [城市名]` | 获取深度气象分析、结算概率、实测追踪及 AI 决策建议。（安卡拉支持显示市区 Center 细节）。 | +| `/deb [城市名]` | 查看 DEB 准确率：逐日命中明细、偏差分析（低估/高估）、模型 MAE 对比、交易建议。 | +| `/id` | 查看当前对话的 Chat ID。 | +| `/help` | 显示说明信息。 | ### 支持城市示例 @@ -216,4 +218,4 @@ git pull --- -_更新于 2026-03-04_ +_更新于 2026-03-05_ diff --git a/docs/TECH_DEBT.md b/docs/TECH_DEBT.md index dbe4a9cc..32f78856 100644 --- a/docs/TECH_DEBT.md +++ b/docs/TECH_DEBT.md @@ -1,6 +1,6 @@ # PolyWeather 技术债与演进路线 -> 最后更新：2026-03-04 +> 最后更新：2026-03-05 ---