# 东航趣游卡 · 里程票可兑换查询 — 使用说明 ## 如何打开 - **本机**：浏览器打开 `http://127.0.0.1:8001/` - **局域网**：同 WiFi 下用手机/平板/电脑打开 `http://192.168.1.20:8001/` 或 `http://192.168.31.149:8001/` --- ## 一、看懂颜色（5 种状态） 每条航线的每个日期以颜色方块展示放票状态： | 颜色 | 含义 | 解释 | |---|---|---| | 🟢 绿色 | **可兑换** | 当前有里程票可兑换，抓紧下手 | | 🔵 蓝色 | **推算可放** | 历史有放票规律，模型推算近期可能再放 | | ⚪ 灰色 | **已兑完** | 曾放过票但已兑换一空 | | 深灰 | **已过期** | 该日期已过去 | | 浅灰 | **未知** | 无历史数据，无法判断 | > 鼠标移到任意日期色块上，会弹出详细信息：状态、概率、预计放票日、是否曾放过票。 --- ## 二、单程查询（默认页面） **适用场景**：查"某城市 → 某城市"有没有票、什么时候有票。 ### 使用步骤 1. **选始发城市**：输入"上海"，下拉自动补全，点选。 2. **选到达城市**：输入"三亚"，选一个或多个（到达半径扩展）。 3. **（可选）邻近半径**：拖动滑块扩大范围。比如始发半径 50km = 上海周边城市（苏州、嘉兴等）也会纳入查询。 4. **选日期范围**：手机使用两个原生日期框，桌面点日期范围框选起止日，也可用快捷按钮。 5. **点「查询」**。 ### 结果怎么看 - 默认以**日历卡片**展示，每条航线一张卡。 - 绿色/蓝色日期 = 可关注；灰色 = 暂无票。 - 多条航线时，有票的绿卡排前面并自动展开；灰色航线默认折叠隐藏。 - 点击卡片头部「只看此线」可聚焦某条航线。 - 上方**航线轨**可快速切换航线。 - 同一时间只展开一条航线，展开新航线会自动收起上一条。 - 推算中、已兑完或未知日期可直接点击“监控放票”创建一次性提醒。 > **提示**：出发城市输入框下方会显示"已纳入邻近始发"，列出半径内被自动纳入的城市。旁边的✕可以剔除不想要的城市。 --- ## 三、往返查询（第二个选项卡） **适用场景**：规划来回行程（如"周五/六出发、周日/一返程，玩 ≥3 天"）。 ### 使用步骤 1. 选始发城市 + 到达城市（同单程，两边都支持半径扩展）。 2. 选**日期范围**（查哪些出发日有票）和**邻近半径**。 3. 勾选**出发星期**和**返回星期**。两组都支持“全选”“工作日”“周末”和“清空”。 4. 可选设置**最少/最多旅行天数**（默认均不限）。 5. 点「查询往返」。 ### 结果怎么看 - 每条结果是一个往返组合：左边去程信息、右边回程信息、中间显示旅行天数和**理想度**。 - 理想度 = 去程和回程放票状态综合评分，100% 最好。 - 上方**航线轨**可按航线筛选（只看"上海-三亚"的所有往返组合）。 - 区域搜索可返回非原路往返；界面会明确标出到达区域或始发区域内的异地衔接。 - 不是去回程都真实有票的组合可点击“监控这组往返”。 --- ## 四、地图查询（第三个选项卡） **适用场景**：不知道去哪，想在地图上探索哪些城市有航线、哪些有票。 ### 使用步骤 1. **选机场**：在顶部工具栏输入城市名（如"上海"），下拉点选，自动聚焦并画出所有发散线。 2. **选日期**：点日期框选一天（默认当日）。 3. **选模式**：始发（从该机场出发有哪些航线）/ 到达（有哪些航线飞抵该机场）。 4. 也可直接**hover 地图上的机场圆点**快速浏览。 ### 结果怎么看 - 只有绿色实线箭头会显示，代表真实有票；推算状态仍保留在城市点和列表中。 - 右侧栏列出具体航线列表，含状态、城市名。 - 点击地图上的机场圆点可**锁定**该机场，再次点击解锁。 - hover 机场会显示城市名提示。 --- ## 五、搜索历史与提醒 - 单程、往返各在当前浏览器保存最近 10 条成功查询，点击即可恢复条件并立即查询。 - 搜索历史可删除单条或清空，不保存邮箱、密码或账号信息。 - 提醒默认每 30 分钟扫描一次，最大发送延迟约 30 分钟；邮件发送成功后自动失效。 --- ## 六、常见问题 **Q: 为什么大部分都是灰色？** A: 里程票稀缺是常态。绿色 = 当前可兑换（重点关注），蓝色 = 推算有规律。灰色不一定没戏，只是当前快照没票——蓝色日期的前一天前后最值得守着。 **Q: 地图上机场点太小点不到？** A: 可直接在顶部"选择机场"输入框里搜城市名，更精准。 **Q: 往返理想度 85% 算高吗？** A: 算。45% 以上就有实操价值，100% 意味着去程回程都有票。 **Q: 数据多久更新一次？** A: 基于后台抓取的库存快照。`updated_at` 字段标注了每条记录的更新时间。 **Q: 移动端能用吗？** A: 能用。查询条件在手机上会收进底部悬浮按钮抽屉，点「条件」展开；地图在手机上自动缩小高度。