name: adsb-overhead
description: 通过本地 ADS-B SBS/BaseStation 数据流（readsb 端口 30003），在可配置半径范围内检测飞机飞越并发送通知。适用于设置或调试飞机飞越警报、配置半径/家庭坐标/冷却时间，或创建 Clawdbot 定时任务，通过 WhatsApp 发送附近飞机通知。

adsb-overhead

从本地 readsb SBS/BaseStation TCP 数据流中检测（半径范围内的）飞机飞越事件，并通过 Clawdbot 发送消息通知。

本技能设计为周期性检查器（cron 任务），而非长期运行的后台服务。

快速开始（手动测试）

1) 运行检查器数秒，查看是否能检测到您附近的飞机：

python3 skills/public/adsb-overhead/scripts/sbs_overhead_check.py \
  --host <SBS_HOST> --port 30003 \
  --home-lat <纬度> --home-lon <经度> \
  --radius-km 2 \
  --listen-seconds 5 \
  --cooldown-min 15

• 若输出内容，则表示检测到新的警报（不在冷却期内）。
• 若无输出，则表示在采样窗口内未发现新的飞越飞机。

工作原理

• 连接 SBS 数据流（TCP），持续 --listen-seconds 秒。
• 跟踪每个 ICAO 十六进制代码的最新经纬度。
• 计算与 --home-lat/--home-lon 的距离（使用 Haversine 公式）。
• 仅当飞机在 --radius-km 半径内，且未在 --cooldown-min 分钟内触发过警报时，才发出警报。
• 将状态持久化保存到 JSON 文件（默认：~/.clawdbot/adsb-overhead/state.json）。

SBS 数据解析的假设条件详见：references/sbs-fields.md。

创建 Clawdbot 监控器（cron 任务）

使用 Clawdbot 定时任务定期运行脚本。该定时任务应：
1) exec 执行脚本
2) 若标准输出非空，则通过 WhatsApp message.send 发送该内容

代理的伪代码示例：

• 运行：
• python3 .../sbs_overhead_check.py ...
• 若标准输出（去除首尾空白）不为空：
• 将输出文本作为 WhatsApp 消息发送

建议的轮询间隔：
- 通常 30–60 秒足够（考虑到冷却时间）
- 使用 --listen-seconds 3..8，以便每次运行能收集若干位置帧

参数调优

• 若希望减少漏报，可增大 --radius-km。
• 若数据流繁忙但您错过了位置更新，可增加 --listen-seconds。
• 使用 --cooldown-min 防止消息轰炸（建议 15–60 分钟）。