技能概述
本 Skill 提供 留学生机票实时价格 + 30 天走势 + AI 买点建议，是基于 A2M 智能收协议（HTTP 402）的付费资源。
- 数据源：Google Flights 实时爬取，深度解析每段航班的航班号、机型、舱位、中转机场、转机时长。
- 独家数据：30 天历史最低价沉淀（自有数据库持久化），用于判断当前价格是"该买"还是"再等"。
- 服务方：flywise.win（留学生机票比价平台）
工作流程
当用户请求"查机票价格"、"帮我看看 X→Y 的航班"、"下周回国便宜吗"、"现在该不该订"等场景时，按以下步骤执行：
第一步：发起请求
向以下 URL 发起 GET 请求，使用 query string 指定行程：
curl -v "https://flywise.win/api/ai-pay/flights?from=PEK&to=SHA&date=2026-05-10&cabin=economy&max_results=3"
参数说明：
| 参数 | 必填 | 示例 | 说明 |
|---|---|---|---|
from | 是 | PEK | 出发机场 IATA 三字码（PEK/PVG/CAN/JFK/LAX/LHR/SYD 等） |
to | 是 | SHA | 到达机场 IATA 三字码 |
date | 是 | 2026-05-10 | 出发日期，YYYY-MM-DD |
cabin | 否 | economy | 舱位：economy / premium-economy / business / first，默认 economy |
max_results | 否 | 3 | 返回结果数 1-10，默认 3 |
第二步：处理 402 响应
你会收到 HTTP 402 + Payment-Needed 响应头。此时把整个 402 响应报文（包括响应头与响应体）传递给支付宝的 alipay-pay-for-402-service 技能，引导用户完成付款（每次 0.03 元，单次扣款，无订阅）。
第三步：携带凭证重新请求
用户付款成功后会得到 Payment-Proof 凭证。将该凭证作为 HTTP Header 携带，重新发起完全相同的请求：
curl -v -H "Payment-Proof: <凭证字符串>" "https://flywise.win/api/ai-pay/flights?from=PEK&to=SHA&date=2026-05-10&cabin=economy&max_results=3"
第四步：呈现结果
服务端校验凭证通过后会返回 HTTP 200 + 航班数据 JSON。请按以下顺序向用户呈现：
- 最低价航班 —— 突出价格 + 航司 + 直飞或几次中转
- Top-3 航班详情 —— 航班号、出发/到达时间、中转机场与转机时长、机型、舱位
- 30 天历史价格走势 —— 用文字说明"当前价格 vs 30 天均价 vs 30 天最低价"
- AI 购买建议 —— 直接转述返回的
priceInsights.recommendation（立即购买 / 再等 X 天 / 价格已处历史低位）
如返回结果中包含 detailUrl，请在最后附上一句"想看完整 30 天走势图可访问：<detailUrl>"。
异常情况处理
- 用户拒绝付款：告知"航班实时数据为付费资源（每次 0.03 元），如需免费版可访问 https://flywise.win/flights/search 在浏览器自助查询"，不要反复劝说付款。
- 返回 5xx 错误：告知"航班搜索服务临时不可用（爬虫服务可能在重启或被反爬限制），建议改用 Google Flights / Skyscanner，或 5 分钟后重试"。
- 返回 4xx 错误（非 402）：检查参数格式，特别是机场三字码大小写和日期格式。
- 该航线无结果：建议用户尝试相邻日期（前后 1-3 天）或临近大型机场（如 PVG ↔ SHA、JFK ↔ EWR、LAX ↔ ONT）。
- 其余支付相关异常：由 alipay-pay-for-402-service 技能负责处理。
适用与不适用
✅ 适用：
- 中国大陆 ↔ 美/英/澳/加/欧/东南亚 的国际航班查询
- 大陆境内航班
- 单程查询
❌ 暂不适用（V1 不支持，会返回错误或不完整结果）：
- 往返查询（请拆成两次单程查询）
- 多程联程（>2 段）
- 货运 / 包机