修复移动端点击城市列表触发 Leaflet flyTo NaN 崩溃：隐藏地图容器跳过动画

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 个可选/未配置。

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,