From 476a4f85d8ca716aa1e1304e411bb0f0af6a34d6 Mon Sep 17 00:00:00 2001
From: "2569718930@qq.com" <2569718930@qq.com>
Date: Tue, 19 May 2026 12:41:38 +0800
Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E7=A7=BB=E5=8A=A8=E7=AB=AF?=
 =?UTF-8?q?=E7=82=B9=E5=87=BB=E5=9F=8E=E5=B8=82=E5=88=97=E8=A1=A8=E8=A7=A6?=
 =?UTF-8?q?=E5=8F=91=20Leaflet=20flyTo=20NaN=20=E5=B4=A9=E6=BA=83=EF=BC=9A?=
 =?UTF-8?q?=E9=9A=90=E8=97=8F=E5=9C=B0=E5=9B=BE=E5=AE=B9=E5=99=A8=E8=B7=B3?=
 =?UTF-8?q?=E8=BF=87=E5=8A=A8=E7=94=BB?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/SERVICES_ZH.md             | 56 +++++++++++++++++++++++++++++++++
 frontend/hooks/useLeafletMap.ts | 17 +++++++---
 2 files changed, 68 insertions(+), 5 deletions(-)
 create mode 100644 docs/SERVICES_ZH.md

diff --git a/docs/SERVICES_ZH.md b/docs/SERVICES_ZH.md
new file mode 100644
index 00000000..23da9257
--- /dev/null
+++ b/docs/SERVICES_ZH.md
@@ -0,0 +1,56 @@
+# 外部服务依赖总览
+
+最后更新：`2026-05-19`
+
+项目调用了 24 个外部服务，按状态分为三类。
+
+## 核心（必须有，挂了服务不可用）
+
+| 服务                   | 用途                  | 状态 |
+| ---------------------- | --------------------- | ---- |
+| Open-Meteo             | 52 城天气预报         | ✅   |
+| AviationWeather (NOAA) | METAR/TAF 航空观测    | ✅   |
+| MADIS (NOAA)           | 美国 5 分钟高频观测   | ✅   |
+| Supabase               | 用户认证 + 订阅       | ✅   |
+| Telegram Bot API       | Bot 消息 + 群成员检查 | ✅   |
+| KNMI                   | Amsterdam 10 分钟观测 | ✅   |
+| Polymarket Gamma/CLOB  | 市场数据读取          | ✅   |
+
+## 国家气象源（特定城市必须）
+
+| 服务                 | 城市                  | 状态        |
+| -------------------- | --------------------- | ----------- |
+| JMA (日本)           | Tokyo                 | ✅          |
+| KMA + AMOS (韩国)    | Seoul, Busan          | ✅          |
+| AMSC AWOS (中国)     | 北京/上海/广州等 6 城 | ✅          |
+| MGM (土耳其)         | Ankara, Istanbul      | ✅          |
+| FMI (芬兰)           | Helsinki              | ✅          |
+| HKO (香港)           | Hong Kong             | ✅          |
+| CWA (台湾)           | Taipei                | ✅          |
+| NMC (中国)           | 国内城市 fallback     | ✅          |
+| Singapore MSS        | Singapore             | ✅          |
+| IMGW (波兰)          | Warsaw                | ⚠️ 未配 key |
+| Russia pogodaiklimat | Moscow                | ✅          |
+
+## 可选 / 已禁用
+
+| 服务           | 用途          | 状态        |
+| -------------- | ------------- | ----------- |
+| OpenWeatherMap | 天气 fallback | ⚠️ 未配 key |
+| VisualCrossing | 历史天气      | ⚠️ 未配 key |
+| Meteoblue      | 天气预报      | ⚠️ 未配 key |
+| SynopticData   | 美国站点观测  | ⚠️ 未配 key |
+
+## AI / 其他
+
+| 服务              | 用途             | 状态        |
+| ----------------- | ---------------- | ----------- |
+| MiMo (xiaomimimo) | 城市分析 AI 评论 | ✅ 当前使用 |
+| DeepSeek          | AI fallback      | - 备用      |
+| Groq              | AI commentary    | ⚠️ 未配 key |
+| Polygon RPC       | 链上支付         | ✅          |
+| WalletConnect     | 前端钱包连接     | ⚠️ 未配 key |
+
+## 合计
+
+18 个在用，6 个可选/未配置。
diff --git a/frontend/hooks/useLeafletMap.ts b/frontend/hooks/useLeafletMap.ts
index 17dbf21a..9ad3ff89 100644
--- a/frontend/hooks/useLeafletMap.ts
+++ b/frontend/hooks/useLeafletMap.ts
@@ -677,6 +677,8 @@ export function useLeafletMap({
                 const currentMap = mapRef.current;
                 currentMap?.stop();
                 if (currentMap && !suspendMotionRef.current) {
+                  const c = currentMap.getContainer();
+                  if (!c || c.offsetWidth <= 0 || c.offsetHeight <= 0) return;
                   currentMap.flyTo([city.lat, city.lon], 11, {
                     animate: true,
                     duration: 1.05,
@@ -810,11 +812,14 @@ export function useLeafletMap({
 
       if (!nearbyStations.length) {
         if (!preserveView && detail.lat != null && detail.lon != null) {
-          map.flyTo([detail.lat, detail.lon], 10, {
-            animate: true,
-            duration: 1.5,
-            easeLinearity: 0.25,
-          });
+          const container = map.getContainer();
+          if (container && container.offsetWidth > 0 && container.offsetHeight > 0) {
+            map.flyTo([detail.lat, detail.lon], 10, {
+              animate: true,
+              duration: 1.5,
+              easeLinearity: 0.25,
+            });
+          }
         }
         return;
       }
@@ -1058,6 +1063,8 @@ export function useLeafletMap({
       )
         return;
 
+      const container = currentMap.getContainer();
+      if (!container || container.offsetWidth <= 0 || container.offsetHeight <= 0) return;
       currentMap.stop();
       currentMap.flyTo([entry.city.lat, entry.city.lon], 11, {
         animate: true,