名称： flight-tracker
版本： 1.0.0
描述： 实时追踪航班，提供详细状态、登机口信息、延误情况及实时位置。当用户要求追踪航班、查询航班状态、通过航班号查找航班信息（例如"追踪 AA100"、"查询 United 2402 的状态"、"检查我的航班 BA123"）时，或希望以类似 Flighty 应用的格式化视图显示航班数据时使用。

航班追踪器

使用 AviationStack API 追踪全球任意航班，并以简洁、类似 Flighty 的格式展示信息。

快速开始

通过 IATA 航班号追踪航班：

scripts/track_flight.py AA100
scripts/track_flight.py UA2402
scripts/track_flight.py BA123

首次设置

使用本技能前，您需要获取一个 API 密钥（一次性设置）：

1. 获取免费 API 密钥：访问 https://aviationstack.com/signup/free（每月 100 次请求）
2. 设置环境变量：
   bash export AVIATIONSTACK_API_KEY='your-key-here'
3. 安装依赖：
   bash pip3 install requests

详细设置说明，请参阅 api-setup.md。

输出格式

本技能以清晰易读的格式展示航班信息，包括：

• ✈️ 航空公司及航班号
• 🛩️ 飞机型号及注册号
• 🛫 出发机场、航站楼、登机口、时间
• 🛬 到达机场、航站楼、登机口、时间
• 📊 航班状态（带视觉指示器）
• ⏱️ 延误计算（如适用）
• 🌐 实时位置、高度、速度（飞行中）

状态指示器：
- 🟢 活动/飞行中/途中
- ✅ 已降落/已到达
- 🟡 已计划
- 🟠 延误
- 🔴 已取消

高级用法

获取原始 JSON 数据：

scripts/track_flight.py AA100 --json

查看帮助：

scripts/track_flight.py --help

工作流程

当用户要求追踪航班时：

1. 从请求中提取航班号
2. 使用该航班号运行追踪脚本
3. 将格式化后的输出呈现给用户
4. 如需数据用于进一步处理，请使用 --json 标志

航班号格式

接受 IATA 航班代码：
- AA100 (美国航空)
- UA2402 (美联航)
- BA123 (英国航空)
- DL456 (达美航空)

脚本会自动转换为大写并处理查询。

错误处理

脚本处理常见错误：
- 缺少 API 密钥 → 显示设置说明
- 未找到航班 → 建议核实航班号
- API 错误 → 显示错误信息
- 超出速率限制 → 提示已达上限

API 限制

免费套餐：每月 100 次请求。请监控使用情况以保持在限制内。如需大量使用，请考虑升级或使用替代 API（参见 references/api-setup.md）。

注意事项

• 使用 AviationStack 免费套餐（免费计划不支持 HTTPS）
• 实时数据频繁更新
• 提供历史航班数据
• 全球覆盖（250+ 国家/地区，13,000+ 家航空公司）