12306 列车查询

从中国铁路 12306 查询列车时刻表及余票信息。

查询车票

node {baseDir}/scripts/query.mjs <出发地> <目的地> [选项]

• HTML 模式（默认）：生成 HTML 文件，并将文件路径输出至标准输出
• Markdown 模式（-f md）：以 Markdown 表格格式直接输出至标准输出（适合在聊天场景中使用）

示例

# 查询北京至上海所有列车（默认为今日）
node {baseDir}/scripts/query.mjs 北京 上海

# Markdown 表格输出（输出至标准输出，适合聊天场景）
node {baseDir}/scripts/query.mjs 北京 上海 -t G -f md

# 仅查询上午发车、总时长不超过 2 小时、且二等座有余票的列车
node {baseDir}/scripts/query.mjs 上海 杭州 -t G --depart 06:00-12:00 --max-duration 1h --seat ze

# 仅显示可预订、且到达时间早于 18:00 的列车
node {baseDir}/scripts/query.mjs 深圳 长沙 --available --arrive -18:00

# 自定义输出路径
node {baseDir}/scripts/query.mjs 广州 武汉 -o /tmp/tickets.html

# JSON 格式输出（输出至标准输出）
node {baseDir}/scripts/query.mjs 广州 武汉 --json

选项

• -d, --date ：乘车日期（默认为当天）
• -t, --type ：按列车类型筛选（可组合使用，例如 GD）
• --depart ：发车时间范围（例如 08:00-12:00、18:00-）
• --arrive ：到达时间范围（例如 -18:00、14:00-20:00）
• --max-duration ：最大行程时长（例如 2h、90m、1h30m）
• --available：仅显示可预订的列车
• --seat ：仅显示指定席别有余票的列车（逗号分隔，支持：swz,zy,ze,rw,dw,yw,yz,wz）
• -f, --format ：输出格式 — html（默认，生成文件）或 md（Markdown 表格输出至标准输出）
• -o, --output ：输出文件路径（仅 HTML 模式有效；默认为 {baseDir}/data/<出发地>-<目的地>-.html）
• --json：以原始 JSON 格式输出至标准输出

输出列说明

字段值说明：数字 = 剩余座位数，有 = 有票（具体数量未知），— = 不适用

车站查询

node {baseDir}/scripts/stations.mjs 杭州
node {baseDir}/scripts/stations.mjs 香港西九龙

注意事项

• 数据直接来源于 12306 官方 API（无需 API Key）
• 车站数据缓存在 {baseDir}/data/stations.json 中，有效期为 7 天
• 支持城市名称（自动解析为该城市主要车站）或精确车站名称
• 支持全部列车类型：G（高铁）、D（动车）、Z（直达）、T（特快）、K（快速）