法航荷航开放数据航班追踪器

快速开始（一次性状态查询）

1. 创建API密钥（及可选的密钥）

• 在以下网站注册：https://developer.airfranceklm.com
• 订阅您所需的开放数据产品（至少包括航班状态API）
• 生成凭证（API密钥；部分账户还会提供API密钥）

2. 提供API凭证（请勿打印它们）：

• 首选：环境变量AFKL_API_KEY（以及可选的AFKL_API_SECRET）
• 或存放在您的状态目录（CLAWDBOT_STATE_DIR或./state）中的文件：
  • afkl_api_key.txt（设置文件权限为chmod 600）
  • afkl_api_secret.txt（chmod 600，可选）

2. 查询航班状态：

• 运行：node skills/airfrance-afkl/scripts/afkl_flightstatus_query.mjs --carrier AF --flight 7 --origin JFK --dep-date 2026-01-29

注意：

• 发送Accept: */*（API 返回application/hal+json）。
• 保持在限制内：<= 1 次请求/秒。进行多次调用时，在调用之间休眠约 1100 毫秒。

启动监控（监视器）

当用户希望获得主动更新时使用。

• 运行：node skills/airfrance-afkl/scripts/afkl_watch_flight.mjs --carrier AF --flight 7 --origin JFK --dep-date 2026-01-29

功能说明：

• 获取日期窗口内的运营航班。
• 仅在有重要变化时发送一条消息。
• 同时遵循前序航班链(flightRelations.previousFlightData.id) 向上追溯至可配置的深度，并在前一航段出现延误/取消时发出警报。

轮询策略（默认）：

• 起飞前36小时：至多每60 分钟

• 36小时→12小时：每30 分钟
• 12小时→3小时：每15 分钟
• 3小时→起飞：每5–10 分钟（保持在每日配额内）
• 起飞后：每30 分钟直至抵达

实现细节：cron 每 5–15 分钟运行一次，但脚本使用状态文件进行自我节流，以避免在非轮询时间调用 API。监测器在无变化时无输出（因此 cron 作业可仅在标准输出非空时发送通知）。

输入速记

首选面向用户的格式：

• AF7 明天/AF7 周四

解释规则：

• 日期始终指出发日期（非抵达日期）。

实现说明：

• 除非明确知道出发地时区，否则将相对日期词转换为用户时区中的出发日期。
• 当存在歧义时（例如长途航班跨越午夜），如果已知出发地，则优先使用出发地的当地出发日期。

（对于脚本，仍需传递--origin+--dep-date YYYY-MM-DD。）

解释“有意义的”字段

请参阅references/fields.md了解：

• flightRelations（前序/后续航班）
• places.*（航站楼/登机口/值机区）
• 时间*（计划/预计/最晚/实际）
• 飞机（机型，注册号）
• “停机位” / 机位类型提示（如有）
• Wi-Fi 提示及如何推断机舱新旧程度

机舱新旧程度 / 升舱启发式判断

当可获得飞机注册号时：

• 使用尾号推断子机队及可能的机舱代际。
• 若数据表明配置较旧（或无 Wi-Fi），升舱可能更值得/更不值得。

保持谨慎：

• 开放数据通常不提供确切的座椅型号；请将此视为尽力而为 的信息。.