新增机场高频实时数据源参考文档 docs/AIRPORT_REALTIME_SOURCES.md

汇总已接入 7 城的数据源、频率、推送机制、消息模板和未接入原因。

docs/AIRPORT_REALTIME_SOURCES.md

@@ -0,0 +1,50 @@
+# 机场高频实时数据源
+
+## 已接入城市
+
+| 城市 | 机场 | ICAO/站点 | 数据源 | 频率 | 类型 | 费用 |
+|------|------|-----------|--------|------|------|------|
+| 首尔 | 仁川国际 | RKSI | AMOS (`global.amo.go.kr`) | 1 分钟 | 跑道对温度（2对） | 免费 |
+| 釜山 | 金海国际 | RKPK | AMOS (`global.amo.go.kr`) | 1 分钟 | 跑道对温度（1对） | 免费 |
+| 东京 | 羽田 | RJTT | JMA AMeDAS (`jma.go.jp`) | 10 分钟 | 机场站点实时温度 | 免费 |
+| 安卡拉 | Esenboğa | 17128 | MGM (`servis.mgm.gov.tr`) | 5-15 分钟 | 机场站点实时温度 | 免费 |
+| 伊斯坦布尔 | 伊斯坦布尔机场 | 17058 | MGM (`servis.mgm.gov.tr`) | 5-15 分钟 | 机场站点实时温度 | 免费 |
+| 赫尔辛基 | Vantaa | EFHK | FMI (`opendata.fmi.fi`) | 10 分钟 | 机场站点实时温度 | 免费 |
+| 阿姆斯特丹 | Schiphol | EHAM | KNMI (`dataplatform.knmi.nl`) | 10 分钟 | 机场站点实时温度 | 免费（需注册） |
+
+## 推送机制
+
+- 每城按原生频率独立推送，不捆绑
+- 首尔/釜山 60s，其余 600s
+- 循环轮询 60s 以匹配最快频率
+- 仅当当前温度距 DEB 预测最高 ≤3°C 时推送
+- 确认过峰值后自动停止
+
+## 消息模板
+
+```
+Seoul / Incheon 16:03
+
+15L/33R 14.6°C
+15R/33L 15.2°C
+今日DEB预报最高：18.2°C
+今日实测最高：16.5°C（15:30）
+```
+
+## 环境变量
+
+| 变量 | 说明 | 默认值 |
+|------|------|--------|
+| `TELEGRAM_AIRPORT_PUSH_ENABLED` | 启用机场推送 | `true` |
+| `TELEGRAM_AIRPORT_PUSH_INTERVAL_SEC` | 循环轮询间隔 | `60` |
+| `KNMI_API_KEY` | KNMI API 密钥（阿姆斯特丹必填） | — |
+
+## 未接入城市
+
+| 城市 | 原因 |
+|------|------|
+| 巴黎/Le Bourget | Météo-France 注册认证失败 |
+| 马德里/Barajas | AEMET 注册页面失效 |
+| 伦敦/Heathrow | Met Office 仅 1 小时更新 |
+| 慕尼黑 | DWD 延迟 ~1 小时 |
+| 米兰/华沙/莫斯科 | 无已知实时源 |