怎么读这本册子
页面重载不是重新查票
两种“刷新”
重新加载页面,或按「重新读取已保存观测」,只是再读一次 SQLite 里的记录。它不会打开航司网站,也不会把昨天的价格涂改成今天。
新的一天要有新价格,必须在服务器上导入一条新观测。来源可以是官网、在线旅行社或聚合平台,但三者永远分属不同产品,不会混成一条曲线。在接入你自己的每日导入之前,本站不承诺自动更新。
什么时候可以比价格
只有产品键完全相同,才计算较上一观测日、已记录最低和七日趋势。产品键包括:1 位成人经济舱含税、去程和回程的旅行日期、含中转在内的机场序列、来源类别和来源编号、市场方航司、票价品牌、手提和托运行李。观测日期是横轴,不是产品身份。
托运「未知」和「无托运」不是同一种行李。开口程和往返不是同一产品。往返马德里 6078 元和马德里进、巴塞罗那出 5880 元相差 198 元,是跨航线对照,不是涨跌。实际承运航司在核实前不进入产品键。
至少两个观测日,并且都落在最近观测日起回推的 7 个北京日期里,才给出七日趋势。只有一个点就只画一个点。中间缺的日期留空,不插值,也不把缺记录写成 0 或“没变”。同一天出现两个不同金额时,日涨跌和七日趋势都暂停,两个数字都列出来。
时间标签
观测日是北京日期。查询钟点未知就写「未记录」,不补一个看起来精确的时钟。入库时间是服务器把记录写进数据库的北京时间。航段上的出发和到达是机场当地时间。新鲜度用北京日期比较:同一天但没有钟点,不能显示成刚刚查到;观测日早于对照日,旧价停在原来的日期。
要核对过期提示,可以在地址后加 ?freshness_as_of=2026-11-25。这只改变新鲜度文案,不改价格。
现在库里有什么
已保存 5 条:报价 4 条,非报价 1 条。种子来自 2026-11-18(北京日期)的核实记录。构建时磁盘上没有原始 jsonl,因此按核实事实逐项录入:两条阿提哈德官网购物车实价,以及土耳其官网同日开口程在选择深圳时失败、搜索未提交。没有补时钟,没有把回程未知托运写成无托运,也没有为 EY112 填写承运航司。
HTTP 导入已配置令牌。令牌只放在服务器环境变量 IMPORT_TOKEN,不会出现在页面里。
导入契约
权威校验在 src/lib/validate.ts。每条记录是 JSON 对象,文件可以是 JSON 数组或 JSONL。相同规范化内容再次导入会被主键忽略,原记录的入库时间保持不变。任何校验失败都会让整批不写入。
schema_version必须为 1。observation_date是北京日期。observation_time必须显式给出,未知用 null,不能省略后再由系统填钟点。query_status:quoted、input_failed、no_result、error。只有 quoted 可以有正数价格和行程。- 失败、无结果、出错都不能带 price。0 元会被拒绝。
- 原币不是 CNY 时,必须带已核实汇率、出处和时点,并且人民币金额与原币乘汇率一致(允许 1 分误差)。本站不自行查汇率。
- assumptions 固定为 1 位成人、economy、tax_inclusive true。其他舱等需要新的 schema,避免混进同一曲线。
- 行程总时长必须等于航段加等待。中转机场必须衔接前后航段。
- 开口程必须写明不含的衔接,例如 MAD 到 BCN。
- 通用购物车地址的
reproducible_booking_link必须为 false。
命令行在服务器上直接写数据库,不需要把令牌放进命令行:
npm run import -- ./data/seed/observations.json
HTTP 只接受带令牌的 POST,页面上没有导入表单:
curl -sS -H "Authorization: Bearer $IMPORT_TOKEN" \ -H "Content-Type: application/json" \ --data-binary @observations.json \ http://127.0.0.1:8790/api/import
这次生产包的页面挂在 /。它只占用这个路径,不接管域名根目录。