核心用法
irail-cli 是一款专为比利时国家铁路（NMBS/SNCB）设计的命令行工具，通过 iRail API 提供实时铁路数据查询。核心功能涵盖六大模块：
1. Liveboard（实时看板）：查询指定车站的出发/到达列车时刻，支持特定时间、日期筛选
2. Connections（路线规划）：计算两站之间的最优换乘方案，支持"最晚到达"模式
3. Vehicle（列车详情）：获取指定车次的全线路径与实时状态
4. Composition（车厢配置）：查看列车编组、座位类型及设施信息
5. Disturbances（运营异常）：获取计划/非计划性的线路中断与施工信息
6. Stations（车站检索）：支持模糊搜索与完整车站列表导出
工具支持 --json 机器解析输出、四语言切换（nl/fr/en/de）、环境变量默认配置，并集成 jq 友好的脚本化查询范例。
显著优点
- 零认证门槛：iRail API 完全开放，无需注册或密钥管理
- station 智能匹配：支持大小写不敏感、部分名称匹配，多词站名自动处理
- 开发者友好：结构化 JSON 输出、完整的
jq查询示例、Shell 补全支持 - 多语言本地化：符合比利时联邦的官方语言政策
- 实时性：直连铁路运营数据源，延迟信息以秒级精度呈现
潜在局限
- 地理限制：仅限比利时境内 NMBS/SNCB 网络，不覆盖国际跨境列车全程
- API 稳定性：依赖第三方 iRail 项目维护，非官方 SNCB 直接运营
- 速率限制：高频循环查询需手动添加延迟，文档未明确服务配额
- 数据粒度：车厢配置信息可能因车型而异，部分列车详细编组缺失
- 移动端缺失：纯 CLI 工具，无原生 App 或图形界面
适合人群
- 通勤者快速查询站台变更与晚点
- 开发者构建比利时交通相关的自动化脚本或数据管道
- 需要集成铁路数据到终端工作流的技术用户
- 多语言环境下的国际旅客
常规风险
- 依赖可用性：iRail 为社区维护项目，存在服务中断或数据延迟风险
- 隐私注意：CLI 工具本地运行无用户追踪，但 API 请求暴露 IP 至第三方服务
- 误操作风险：
--arrive-by与--time组合逻辑需仔细核对，避免行程误判 - 输出解析：彩色表格输出依赖终端支持，自动化场景必须显式指定
--json