lessons-learned

经验教训

从实际搜索中积累的宝贵经验。在重蹈覆辙之前，请先参考这些内容。

Seats.aero：搜索所有来源，显示所有结果

搜索 Seats.aero 时，初次搜索绝 NEVER 按来源筛选。 始终先获取所有计划。

必须遵循的工作流程

对于任何航线：

1. 搜索 Seats.aero，不添加来源筛选条件。 获取所有计划。按价格从低到高显示完整结果。
2. 针对结果中的每个计划，追踪完整的可达路径： a. 是否有直接余额？（如果已连接，请检查 AwardWallet） b. 是否有转点路径？（检查每种货币对应的 data/transfer-partners.json：Amex MR、Chase UR、Bilt、Capital One） c. 是否有联盟路径？确定执飞航空公司所属的联盟（data/alliances.json），然后找出该联盟中的所有计划或具有双边合作关系的计划（data/partner-awards.json），再检查这些计划中哪些可以通过转点获取。 d. 是否有跨联盟路径？检查 data/partner-awards.json 中的 cross_alliance_highlights 和双边合作伙伴。
3. **对于可达但没有缓存 Seats.aero 数据的计划，**直接查看计划的网站（airfrance.com、united.com 等）。
4. **呈现完整情况：**列出所有选项，无论是否可达，并明确说明转点链路。
5. 只有这时才比较奖励兑换与现金购票。

常见失败模式

在结果中看到一家航空公司，只检查一两个显而易见的计划，就断定奖励兑换“无法实现”或“价值不高”，并建议用现金购票。你必须追踪所有可能的联盟和双边合作伙伴路径。如果执飞航空公司属于某个联盟，那么所有能够预订该联盟航班的计划都可能是可行路径。

“没有缓存的可用性”并非最终结论

这只意味着 Seats.aero 最近没有抓取到相关信息。如果某个可达计划没有缓存结果，请先直接搜索航空公司网站，再判断奖励兑换是否不可行。

切勿让数据文件凌驾于现实之上

数据文件是参考资料，不是绝对真理。航空公司的合作关系经常变化。如果用户表示某条预订路径可行，而数据文件中没有显示，请先在实际预订网站上核实，再提出异议。网站才是事实来源；你的文件只是缓存。如果数据文件与现实不符，就更新数据文件。

来源准确性层级

Duffel > 航空公司网站 > SerpAPI > Skiplagged/Kiwi

1. **Duffel 会返回按票价舱位划分的真实 GDS 价格。**这些价格可以预订。实测：Duffel 显示基础票价为 $271、主舱票价为 $325；SerpAPI 对同一航班显示 $541。多个行程都出现了相似差距。
2. **SerpAPI（Google Flights）会抬高价格。**Google Flights 经常显示“主舱”或捆绑票价，而不是最便宜且可预订的票价舱位。它适用于 Google Hotels 和目的地发现，但不要将其作为航班现金价格的唯一可靠来源。
3. **Kiwi 在小型市场的数据很不可靠。**对于飞往小型机场的国内航线，请严格筛选结果，或跳过 Kiwi。

Southwest 有其特殊性

1. **Southwest 不属于任何 GDS。**Duffel、Skiplagged、Kiwi 和 Seats.aero 都不会返回 SW 航班。唯一的信息来源是 Southwest 官网或用户提供的截图。
2. **SerpAPI 确实会返回 SW 价格，**但和所有 SerpAPI 航班价格一样，这些价格经常偏高。仅将其作为参考。
3. **SW 同伴通行证（CP）的计算方式与其他情况完全不同。**有 CP 时，你购买一张机票，同伴即可免费乘机。现金价格比较时，应使用一张机票的 Choice 票价（而非两张 Basic 票价）。积分比较时，总积分需覆盖两位旅客。这会显著影响 cpp 计算。
4. **SW 现金机票必须购买 Choice 票价或更高舱位，同伴才能免费乘机。**Wanna Get Away（Basic）不符合条件。这一点至关重要。
5. **SW 积分票价必须查询 southwest.com。**没有第三方来源提供这类信息。

Companion Pass CPP 计算

使用 Companion Pass 时，正确的公式是：

Total cash value = choice_fare_cash × 2 passengers
CPP = total_cash_value / total_points × 100

一张机票所需的积分即可为两人购买行程。始终表述为“积分为 2 人购买了价值 $X 的行程”。

小型市场机场

小型机场的奖励票可用性有限。Seats.aero 的缓存数据会比较稀疏。搜索小型市场时：

1. 使用 Duffel 查询现金价格（效果不错，GDS 中有库存）
2. 不用费心搜索 Seats.aero 缓存（数据太稀疏）
3. 如有需要，通过航空公司计划的网站查询具体奖励票价格
4. 在小型国内市场中，SW Companion Pass 通常更划算，因为积分成本低，而且 CP 能让价值翻倍

中转和时间偏好

首次搜索时，询问用户的偏好。关键问题包括：

• 最短和最长中转时间
• 可接受的最早出发时间
• 是否接受红眼航班
• 贵宾室使用权限（会影响用户对中转时长的感受）

保存用户的回答，并在本次会话的所有后续搜索中应用。

Duffel 的局限

• 不包含 Southwest。 SW 未加入任何 GDS。就是这样。
• 不提供奖励票价格。 Duffel 只显示现金票价。使用 Seats.aero 查询奖励票可用性。
• 报价会在 15-30 分钟后过期。 不要跨会话缓存 Duffel 结果。
• 速率限制为每 60 秒 60 次请求。 可以并行搜索，但不要过度请求。
• 同一航班会返回多个舱位等级。 这是正常情况。同一路线可能会显示一个价格的基础经济舱，以及另一个价格的主舱。除非用户指定票价偏好，否则 CPP 比较应使用最便宜的可订舱位。

相关参考技能（在适用时加载）

并非每次搜索都需要加载这些技能，但如果对话上下文表明相关，请加载：

• transfer-bonuses — 在推荐任何信用卡积分转入忠诚度计划前加载。提供当前有效转点奖励的每周实时数据（例如，Amex MR → Hilton 20%，Chase UR → Aeroplan 20%，还可叠加持卡人奖励）。30% 的奖励会改变转点合作伙伴优化中的最低成本货币。
• stopovers — 行程中有接近 24 小时的中途停留，或用户想“途中在 X 停留”时加载。记录了 17 个计划，并提供主要来源：Aeroplan（1 次中途停留，附加费用 5K）、TAP（合作伙伴奖励机票可中途停留 1 次）、Turkish（伊斯坦布尔免费中途停留）、Etihad（阿布扎比）、Icelandair（雷克雅未克最多免费停留 7 天，堪称传奇）、Alaska（免费，仅限电话办理）、Flying Blue（免费，可能不限次数）、JAL 多承运人（最多 3 次）、Singapore Saver/Advantage 等级、AF/KLM、Cathay（2+2）。也记录了哪些计划不允许中途停留（BA Avios、AA AAdvantage、Delta SkyMiles、JetBlue、Virgin Atlantic、Iberia Avios）——这是一项重要的否定性发现。
• award-holds — 在提出任何“先转积分”建议前加载。根据当前数据记录了奖励机票保留政策：AA 允许在线自助保留 24 小时（唯一支持在线保留的计划；此前的 5 天政策已于 2024 年末取消）。Virgin Atlantic Flying Club 可免费电话保留 1-2 天。Flying Blue 可电话保留最多 3 天，出票时需支付 25 美元电话预订费。Lufthansa M&M 最多 5 天。Cathay 约 2 天。Singapore 由客服人员酌情处理。主要的西方计划中不允许保留的有：United、Alaska、Delta、BA、Aeroplan。请务必查阅数据文件，不要只依赖这份简要摘要。
• round-the-world — 行程涉及 3 个或更多停留点，或多个地区时加载。记录了 13 项仍有效的产品和 4 项已停办的产品。环球旅行产品正在不断减少（过去 18 个月内有 4 项停办），但 Star Alliance + oneworld + Lufthansa M&M + Qantas 仍然可靠。特别值得一提的是，26,000 英里商务舱环球旅行产品非常划算。还包括 Iberia Plus 欧洲境内的高价值兑换，以及 Aeroplan 基于距离的区域奖励机票。
• status-match — 用户询问精英会籍捷径、会籍匹配、会籍挑战、“更换忠诚度计划”，或提及偶尔开放的机会（Hyatt Globalist Challenge、Marriott Platinum Challenge）时加载。务必注意终身/每隔数年限一次的限制：Alaska Atmos = 终身一次，AA = 每 2 年一次，Delta/United = 每 3 年一次，Hyatt Globalist Challenge = 终身一次。此技能会区分免费直接匹配、付费代办服务（statusmatch.com 确实存在，但会收费），以及由信用卡授予且可续期的会籍（Amex Platinum 自动赠送 Hilton Gold + Marriott Gold）。