transfer-bonuses

用途：在涉及积分转点的奖励票定价、判断是否值得立刻转点、以及识别可叠加奖励时提供当前转点奖励参考。主要能力：读取 data/transfer-bonuses.json，其中含 active_bonuses（bonus_pct、ratio、standard_ratio、effective_ratio、end_date_inclusive、confidence、sources、notes）、expired_recently、frequent_recurring_bonuses_to_watch 与 decision_rules；数据由 scripts/refresh-transfer-bonuses.py 每周一通过 .github/workflows/refresh-data.yml 自动刷新，也可手动运行，脚本抓取 Frequent Miler 并以 AwardWallet 交叉核对，置信度分为 VERIFIED、LIKELY、UNVERIFIED。使用方式：引用任何奖励前先做 Expiry Gate，取当天日期并与 end_date_inclusive 比较，过期项不得当作可用；若存在过期条目或 _meta.last_updated 超过 7 天，先运行 python3 scripts/refresh-transfer-bonuses.py（可加 --dry-run 预览）再读取。计算实际成本：无奖励为 miles_required / standard_ratio，有奖励为 miles_required / effective_ratio。限制与注意：数据文件只是快照，奖励常在月末到期；刷新失败时须附上到期日与时效说明，并提示以发卡行转点页面为准；TPG 仅作人工参考且常把过期奖励显示为有效；不得编造奖励，无法从主要来源核实就不要列出。不适用于查询无奖励的常规转点比例（用 transfer-partners）、积分估值（用 points-valuations）、奖励票余票（用 seats-aero）与预订指引（用 booking-guidance）。