2026-05-19 12:41:38 +08:00
|
|
|
|
# 外部服务依赖总览
|
|
|
|
|
|
|
2026-05-29 01:57:42 +08:00
|
|
|
|
最后更新：`2026-05-29`
|
2026-05-19 12:41:38 +08:00
|
|
|
|
|
2026-05-28 20:46:35 +08:00
|
|
|
|
项目调用外部天气、鉴权、支付和实时事件服务。原则是：核心链路必须有明确健康检查；可选数据源不可拖垮已可用城市；实时事件层可从 Redis Stream 降级到 SQLite event log。
|
2026-05-19 12:41:38 +08:00
|
|
|
|
|
|
|
|
|
|
## 核心（必须有，挂了服务不可用）
|
|
|
|
|
|
|
2026-05-28 20:46:35 +08:00
|
|
|
|
| 服务 | 用途 | 状态 |
|
|
|
|
|
|
| --- | --- | --- |
|
|
|
|
|
|
| Open-Meteo | 51 城天气预报、多模型小时曲线、DEB hourly consensus 输入 | ✅ |
|
|
|
|
|
|
| AviationWeather (NOAA) | METAR / TAF 航空观测 | ✅ |
|
|
|
|
|
|
| MADIS (NOAA) | 美国机场 5 分钟高频观测 | ✅ |
|
|
|
|
|
|
| Supabase | 用户认证、订阅状态、会员恢复 | ✅ |
|
|
|
|
|
|
| Telegram Bot API | Bot 消息、群成员检查、双语跑道推送 | ✅ |
|
|
|
|
|
|
| Redis | `city_observation_patch.v1` Stream、SSE replay、多 worker fanout | ✅ |
|
|
|
|
|
|
| SQLite | 运行态数据库、支付审计、实时事件 fallback | ✅ |
|
|
|
|
|
|
|
|
|
|
|
|
## 国家气象源（特定城市必须）
|
|
|
|
|
|
|
|
|
|
|
|
| 服务 | 城市 | 状态 |
|
|
|
|
|
|
| --- | --- | --- |
|
|
|
|
|
|
| JMA AMeDAS | Tokyo | ✅ |
|
|
|
|
|
|
| AMOS (韩国) | Seoul, Busan 跑道传感器 | ✅ |
|
|
|
|
|
|
| AMSC AWOS (中国) | 北京、上海、广州、成都、重庆、武汉、青岛跑道端点气温 | ✅ |
|
|
|
|
|
|
| MGM (土耳其) | Ankara, Istanbul | ✅ |
|
|
|
|
|
|
| FMI (芬兰) | Helsinki | ✅ |
|
|
|
|
|
|
| KNMI (荷兰) | Amsterdam | ✅（需 key） |
|
|
|
|
|
|
| CoWIN 6087 (香港) | Hong Kong 1 分钟参考站 | ✅ |
|
|
|
|
|
|
| HKO (香港) | Hong Kong / Shenzhen / Lau Fau Shan 10 分钟官方气象层 | ✅ |
|
|
|
|
|
|
| CWA (台湾) | Taipei | ✅ |
|
|
|
|
|
|
| Singapore MSS | Singapore | ✅ |
|
|
|
|
|
|
| IMS Lod (以色列) | Tel Aviv | ✅ |
|
|
|
|
|
|
| AEROWEB / AROME HD | Paris | ✅ |
|
|
|
|
|
|
| NMC (中国) | 国内城市 fallback | ✅ |
|
|
|
|
|
|
| IMGW (波兰) | Warsaw | ⚠️ 未配 key |
|
2026-05-19 12:41:38 +08:00
|
|
|
|
|
|
|
|
|
|
## 可选 / 已禁用
|
|
|
|
|
|
|
2026-05-28 20:46:35 +08:00
|
|
|
|
| 服务 | 用途 | 状态 |
|
|
|
|
|
|
| --- | --- | --- |
|
2026-05-19 12:41:38 +08:00
|
|
|
|
| OpenWeatherMap | 天气 fallback | ⚠️ 未配 key |
|
2026-05-28 20:46:35 +08:00
|
|
|
|
| VisualCrossing | 历史天气 | ⚠️ 未配 key |
|
|
|
|
|
|
| SynopticData | 美国站点观测 | ⚠️ 未配 key |
|
|
|
|
|
|
| Meteoblue | 天气预报 | ❌ 已移除 |
|
|
|
|
|
|
| Russia pogodaiklimat | Moscow 历史源 | ❌ 已移除 |
|
|
|
|
|
|
| Groq | AI commentary | ❌ 已移除 |
|
2026-05-19 12:41:38 +08:00
|
|
|
|
|
2026-05-28 20:46:35 +08:00
|
|
|
|
## AI / 支付 / 前端
|
2026-05-19 12:41:38 +08:00
|
|
|
|
|
2026-05-28 20:46:35 +08:00
|
|
|
|
| 服务 | 用途 | 状态 |
|
|
|
|
|
|
| --- | --- | --- |
|
2026-05-19 12:41:38 +08:00
|
|
|
|
| MiMo (xiaomimimo) | 城市分析 AI 评论 | ✅ 当前使用 |
|
2026-05-28 20:46:35 +08:00
|
|
|
|
| DeepSeek | AI fallback | 备用 |
|
2026-05-29 01:57:42 +08:00
|
|
|
|
| Polygon RPC | checkout 合约支付、Polygon USDC / USDC.e 自动确认 | ✅ |
|
|
|
|
|
|
| Ethereum RPC | Ethereum 主网 USDC 直转确认 | ✅（启用多链支付时必须） |
|
2026-05-28 20:46:35 +08:00
|
|
|
|
| WalletConnect | 前端钱包连接 | ⚠️ 未配 key 时钱包入口降级 |
|
2026-05-19 12:41:38 +08:00
|
|
|
|
|
2026-05-28 20:46:35 +08:00
|
|
|
|
## 运维口径
|
2026-05-19 12:41:38 +08:00
|
|
|
|
|
2026-05-28 20:46:35 +08:00
|
|
|
|
- 生产实时事件推荐：`POLYWEATHER_EVENT_STORE=redis` + `POLYWEATHER_REDIS_URL=redis://polyweather_redis:6379/0`。
|
|
|
|
|
|
- 本地或单进程兜底：`POLYWEATHER_EVENT_STORE=sqlite`。
|
|
|
|
|
|
- Redis 只负责短窗口 replay 与多 worker fanout，不是长期天气历史库。
|
|
|
|
|
|
- DEB hourly consensus 依赖 Open-Meteo 多模型小时曲线；若上游限流，图表应保留已有 snapshot 和实测 patch，不把缺失模型误报为实测缺失。
|
2026-05-29 01:57:42 +08:00
|
|
|
|
- 支付多链确认依赖 `POLYWEATHER_PAYMENT_RPC_URLS_BY_CHAIN_JSON`；如果启用 Ethereum 主网 USDC，必须配置 `chain_id=1` 的 RPC，否则用户提交 Ethereum tx hash 后无法自动确认。
|
