Flight Monitor 技能

查询国内外实时机票价格，设置低价提醒，支持定时监控。无需浏览器自动化，无需 API 密钥。

快速开始

单程查询

查一下北京到三亚 3 月 25 日的机票价格
Check flights from BJS to SYX on 2026-03-25
查询杭州到西安 3 月 26 日，低于 500 元的机票

往返查询

帮我看看上海飞成都，4 月 1 日去 4 月 5 日回
上海到成都下周六往返票

设置价格监控与推送

监控赣州到哈尔滨 4 月 10 日，每天查一次，低于 700 提醒我
Monitor BJS to SYX on 2026-03-25, daily, alert if under ¥1500

管理监控任务

查看我所有的机票监控任务
暂停北京到三亚的监控
删除杭州到西安的监控任务

配置手机推送

设置推送 Bark Key: xxxxx

核心工作流

步骤 1 — 解析用户意图

从用户消息中提取以下参数：

城市名称 → IATA 代码的映射由脚本自动处理。 若城市未被识别，请查阅 references/city_codes.md。

步骤 2 — 查询航班数据

⚠️ 关键日期规则：始终使用用户指定的确切出行日期，绝不可替换为当前日期。

步骤 2a — 运行 search_flights.py（必须首先执行）

python scripts/search_flights.py --from  --to  --date 
python scripts/search_flights.py --from KOW --to HRB --date 2026-04-10 --max-price 700
python scripts/search_flights.py --from SHA --to CTU --date 2026-04-01 --return-date 2026-04-05

该脚本按顺序尝试三个数据源，并返回以下其中一种结果：

步骤 2b — 回退网页搜索（仅当 source == "fallback" 时）

使用脚本输出中 search_query 字段的**精确查询字符串**：

web_search("")

从搜索摘要中解析：航空公司名称、航班号、出发时间、到达时间、价格。 无论结果质量如何，本次搜索后立即停止。 使用摘要中包含的所有可用数据。

硬性规则 — 不允许例外

• 严禁调用 web_fetch（携程/去哪儿/Skyscanner 等主流 OTA 均为 JS 渲染；抓取将浪费算力且返回空或无用内容）。
• 每段行程（去程/返程）最多仅允许 1 次 web_search。
• 禁止尝试多个搜索引擎，也禁止在首次搜索返回部分数据时重新构造查询语句。
• 若一次搜索后数据仍不完整，请如实呈现已有信息，并注明局限性。

步骤 3 — 记录价格历史

查询完成后，始终记录结果以支持趋势追踪：

python scripts/price_history.py append 
  --from KOW --to HRB --date 2026-04-10 
  --price  --flight "" --threshold 700

# 查看某条航线的历史记录
python scripts/price_history.py show --from KOW --to HRB --date 2026-04-10

# 列出所有有历史记录的航线
python scripts/price_history.py list

历史记录文件路径：~/.workbuddy/flight-monitor/{DEP}-{ARR}-{DATE}.json

步骤 4 — 检查低价提醒并发送通知

记录价格后，检查是否达到或低于设定阈值：

python scripts/price_history.py show --from KOW --to HRB --date 2026-04-10

若输出中包含“低价提醒”（即价格 ≤ 阈值）：

python scripts/notify.py 
  --title "机票低价提醒 KOW→HRB" 
  --body "赣州→哈尔滨 2026-04-10 最低价 ¥，低于阈值¥700！推荐航班 " 
  --url "https://flights.ctrip.com/itinerary/oneway/kow-hrb?depdate=2026-04-10"

notify.py 将自动使用已配置的任一推送服务。 若尚未配置推送服务，则会打印配置指引。

步骤 5 — 设置监控任务（当用户请求周期性检查时）

# 添加每日监控并启用低价提醒
python scripts/monitor_manager.py add 
  --from KOW --to HRB --date 2026-04-10 
  --freq daily --threshold 700

# 每 6 小时一次
python scripts/monitor_manager.py add 
  --from HGH --to SIA --date 2026-03-26 --freq 6h

# 列出全部监控任务
python scripts/monitor_manager.py list

# 暂停某项监控
python scripts/monitor_manager.py pause --id flight-KOW-HRB-2026-04-10

# 删除某项监控
python scripts/monitor_manager.py remove --id flight-KOW-HRB-2026-04-10

# 查看详情 / 手动触发提示（不执行任何 shell 命令）
python scripts/monitor_manager.py run --id flight-KOW-HRB-2026-04-10

监控任务以 TOML 格式保存于 ~/.workbuddy/automations/ 目录下。

安全说明：

• monitor_manager.py **不导入** os 模块，且**不含任何** os.system() 或 subprocess 调用。
• 所有 --id 参数在访问文件系统前均通过严格白名单正则表达式校验（flight-[A-Z]+-[A-Z]+-YYYY-MM-DD），防止路径遍历攻击。
• run 子命令仅打印安全提示 — 绝不执行外部命令。

推送通知配置

支持三种免费推送服务。请选择其一进行配置：

选项 A — Bark（仅限 iOS，iPhone 用户推荐）

1. 从 App Store 安装 Bark 应用
2. 打开应用 → 复制设备密钥（Device Key）
3. 配置命令：python scripts/notify.py --setup bark --key

选项 B — Server酱（微信通知，Android 与 iOS 均支持）

1. 访问 https://sct.ftqq.com/ 并使用 GitHub 登录
2. 复制您的 SendKey
3. 配置命令：python scripts/notify.py --setup serverchan --key

选项 C — PushDeer（开源方案，Android 与 iOS 均支持）

1. 安装 PushDeer 应用，或使用网页版 https://www.pushdeer.com/
2. 创建设备并复制推送密钥（Push Key）
3. 配置命令：python scripts/notify.py --setup pushdeer --key

配置信息将保存至 ~/.workbuddy/flight-monitor/notify_config.json。

监控频率选项

按提前预订天数推荐的频率：

输出格式

查询结果（面向用户展示）

始终以如下表格格式呈现结果。对于中转航班，“中转”列必须明确列出中转城市及等待时长（例如：“转上海 1h20m”）。

## 机票查询：赣州(KOW) → 哈尔滨(HRB)

**出行日期：** 2026-04-10（⚠️ 以下均为该日期价格）
**价格筛选：** ≤ ¥700

| 航班 | 价格(含税) | 出发 | 到达 | 全程时长 | 中转（城市 + 等待时间） |
|------|-----------|------|------|----------|------------------------|
| 祥鹏 8L9549 | ¥620 | 09:35 | 13:30 | 3h55m | 直飞 |
| 东航 MU2993+MU5619 | ¥650 | 20:10 | 00:35+1 | 7h25m | 转上海虹桥 1h50m |

最低价：¥620  [立即预订 →](https://flights.ctrip.com/itinerary/oneway/kow-hrb?depdate=2026-04-10)

各列定义：

• 全程时长：从出发至最终抵达的总耗时（含中转等待时间）
• 中转（城市 + 等待时间）：中转航班需列出中转城市及等待时长；直飞航班填写“直飞”

低价提醒（推送至手机）

🔔 机票低价提醒！

赣州(KOW) → 哈尔滨(HRB)  |  出行日期：2026-04-10
当前最低价：¥620（低于阈值 ¥700）
推荐航班：祥鹏 8L9549  09:35 → 13:30（直飞）

立即预订：https://flights.ctrip.com/...

注意事项

• ⚠️ 日期规范：始终查询用户指定的确切出行日期，该日期并非当前日期。
• 查询流程：始终以 search_flights.py 为起点；仅当脚本返回 source: fallback 时才回退至 web_search；每段行程（去程/返程）最多执行 1 次搜索。
• 严禁使用 web_fetch：所有主流在线旅行社（OTA）网站（如携程、去哪儿、Skyscanner）均采用 JavaScript 渲染；抓取将返回空白或无效内容，且浪费 token。
• 数据源优先级：Ctrip AJAX API（最丰富，无需密钥）→ zbape.com（需密钥，仅提供最低价）→ 单次网页搜索回退。
• zbape 密钥（可选）：运行 python scripts/search_flights.py --setup-zbape 一次即可启用。当 Ctrip API 遭遇限流时，可补充提供按日期粒度的最低价信息。
• 推送通知：配置一次后，每次监控周期中只要价格跌破阈值，系统将自动触发提醒。
• 城市代码：完整城市名 ↔ IATA 代码对照表请参阅 references/city_codes.md。

文件概览

flight-monitor/
├── SKILL.md                    ← 本文档
├── scripts/
│   ├── search_flights.py       ← 主要脚本：多源航班查询（Ctrip API → zbape → 回退）
│   ├── query_flights.py        ← 遗留脚本：搜索查询生成器 + 预订链接
│   ├── price_history.py        ← 追加/读取/触发价格历史记录
│   ├── monitor_manager.py      ← 增删改查定时监控任务
│   └── notify.py               ← 移动端推送通知（Bark/Server酱/PushDeer）
└── references/
    └── city_codes.md           ← 完整城市名 → IATA 代码对照表

可选：zbape API 密钥（当 Ctrip API 失效时补充提供按日期粒度的最低价）

python scripts/search_flights.py --setup-zbape 
# 免费密钥申请地址：https://api.zbape.com/doc/54