From 963e71752388fe540030a7d06fee1fce936939f4 Mon Sep 17 00:00:00 2001
From: "2569718930@qq.com" <2569718930@qq.com>
Date: Tue, 12 May 2026 21:17:42 +0800
Subject: [PATCH] =?UTF-8?q?=E6=96=B0=E5=A2=9E=E6=9C=BA=E5=9C=BA=E9=AB=98?=
 =?UTF-8?q?=E9=A2=91=E5=AE=9E=E6=97=B6=E6=95=B0=E6=8D=AE=E6=BA=90=E5=8F=82?=
 =?UTF-8?q?=E8=80=83=E6=96=87=E6=A1=A3=20docs/AIRPORT=5FREALTIME=5FSOURCES?=
 =?UTF-8?q?.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

汇总已接入 7 城的数据源、频率、推送机制、消息模板和未接入原因。
---
 docs/AIRPORT_REALTIME_SOURCES.md | 50 ++++++++++++++++++++++++++++++++
 1 file changed, 50 insertions(+)
 create mode 100644 docs/AIRPORT_REALTIME_SOURCES.md

diff --git a/docs/AIRPORT_REALTIME_SOURCES.md b/docs/AIRPORT_REALTIME_SOURCES.md
new file mode 100644
index 00000000..489fb57c
--- /dev/null
+++ b/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 小时 |
+| 米兰/华沙/莫斯科 | 无已知实时源 |