用途:查询美国航空 AAdvantage 账户信息,包括可兑换奖励里程余额、精英等级(Gold/Platinum/Platinum Pro/Executive Platinum)、当年忠诚积分、百万里程累计进度、账户名与注册日期。因 AA.com 会拦截常规浏览器自动化,需使用 Patchright(Playwright 的反检测分支)。
主要能力:输出 JSON 结果,字段含 miles、elite_status、loyalty_points、million_miler、member_since 等;支持环境变量或命令行参数传入账号密码;支持 --profile 保存浏览器 Cookie,首次 2FA 成功后同配置可跳过验证;支持 Docker 运行。
使用方式:安装依赖 pip install patchright && patchright install chromium,或使用 Docker 镜像 ghcr.io/borski/aa-miles-check:latest。运行示例:AA_USERNAME=your_aa_number AA_PASSWORD=your_password python3 scripts/check_balance.py --json,也可用 --username/--password 参数。2FA 验证码可通过 AA_2FA_COMMAND 命令钩子、默认文件 /tmp/aa-2fa-code.txt(每 2 秒轮询)、--code 参数或 --code-file 指定路径提供。
限制:首次登录新设备需邮箱 2FA,脚本等待最多 120 秒,需向账户持有人索取 6 位验证码;持久化会话仅维持数小时而非数天;必须使用有头模式(headless=False),本地会弹出 Chrome 窗口,Docker 使用 xvfb 虚拟显示;仅只读,不修改任何内容,不能用于订票,也不适用于其他航空公司。
适用场景:查询 AA 里程余额(AwardWallet 不支持 AA)、核对精英等级与到期时间、跟踪忠诚积分进度、结合其他工具比较奖励机票可用性。