Seats.aero Monitor 技能

无需依赖航司专属确认器，即可跟踪 Seats.aero 上的奖励舱位余量。

该技能的功能

1. 对多个监控项（watcher）批量查询 Seats.aero 的缓存搜索结果。
2. 将原始 API 返回记录标准化为稳定、统一的内部数据结构。
3. 使用 SQLite 或 JSON 持久化存储监控项配置及其运行状态，以支持幂等的 new_only 告警机制。
4. 当状态由“无余量”转变为“有余量”时，返回标记为 [UNCONFIRMED / Seats.aero] 的告警事件。

入口命令

python3 /scripts/check_awards.py --watchers-source db

# 使用 JSON 后端
python3 /scripts/check_awards.py 
  --state-backend json 
  --state-json /path/to/monitor.json 
  --watchers-source db

可选参数

# 仅检查单个监控项
python3 /scripts/check_awards.py --watchers-source auto --watcher ana_sfo_hnd

数据库中的监控项（Watchers）

将配置文件中的监控项导入数据库：

python3 /scripts/check_awards.py --watchers-import --replace-watchers --config /path/to/watchers.json

# 导入至 JSON 状态文件（而非 SQLite）
python3 /scripts/check_awards.py 
  --state-backend json 
  --state-json /path/to/monitor.json 
  --watchers-import --replace-watchers --config /path/to/watchers.json

列出数据库中所有监控项：

python3 /scripts/check_awards.py --watchers-list

# 列出 JSON 状态文件中存储的监控项
python3 /scripts/check_awards.py 
  --state-backend json 
  --state-json /path/to/monitor.json 
  --watchers-list

更新监控项的日期范围：

# 按 ID 更新指定监控项
python3 /scripts/update_watcher_dates.py 
  --watcher pvg_sfo_aeroplan_2026summer --start 2026-08-01 --end 2026-08-15

# 批量更新源自某机场的所有监控项
python3 /scripts/update_watcher_dates.py 
  --origin PVG --start 2026-08-01 --end 2026-08-15

# 预演模式（仅预览变更，不实际执行）
python3 /scripts/update_watcher_dates.py 
  --origin PVG --start 2026-08-01 --end 2026-08-15 --dry-run

# 在 JSON 后端中更新日期
python3 /scripts/update_watcher_dates.py 
  --state-backend json --state-json /path/to/monitor.json 
  --origin PVG --start 2026-08-01 --end 2026-08-15

# 跳过确认提示
python3 /scripts/update_watcher_dates.py 
  --origin PVG --start 2026-08-01 --end 2026-08-15 --yes

# 查看全部可用选项
python3 /scripts/update_watcher_dates.py --help

固定日期范围支持：

1. 通过 fixed_start_date 和 fixed_end_date（格式为 YYYY-MM-DD）定义固定时间窗口（例如：仅监控 8 月）。
2. 若两者设为同一天，则表示仅监控该单日。
3. 一旦设置了固定日期，window_days 参数将被忽略。

SQLite 状态数据库默认路径（可通过 --state-db 参数或 SEATS_AERO_DB 环境变量覆盖）：

• /data/monitor.db（相对于技能安装目录）
• 或在环境中设置 SEATS_AERO_DB=/path/to/monitor.db

使用 JSON 后端时，必须显式指定：--state-backend json --state-json /path/to/monitor.json。

依赖要求

• Python：3.11 及以上版本（使用 str | None 类型联合语法）
• SQLite3：Python 标准库内置；首次运行且启用 --state-backend sqlite 时，会自动创建数据库文件及表结构
• JSON：无需额外依赖；首次写入且启用 --state-backend json 时，会自动创建状态文件
• 可选依赖：brotli Python 包（仅当 Seats.aero API 返回 Brotli 压缩响应时需要）
• Seats.aero API Key：所有 API 调用均需提供

环境配置

运行前请先设置 Seats API 密钥：

export SEATS_AERO_API_KEY="pro_xxx..."

重要限制说明

所有告警均为 Seats.aero 提供的候选信号。本技能**刻意不执行航司侧的余量确认**，所有告警均标记为未确认（UNCONFIRMED）。

本脚本**不直接发送通知消息**；调用方或代理程序应读取 JSON 输出中的 data.alert_events 字段，并自行完成通知分发。