Irail

核心用法

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

核心用法

irail-cli 是一个面向比利时国家铁路系统（NMBS/SNCB）的 CLI 工具文档型 Skill，通过调用 iRail 公开 API（api.irail.be）实现列车信息查询。用户可通过自然语言触发查询需求，涵盖六大核心功能：

1. Liveboard（实时站牌）：查询指定车站的出发/到达列车，支持时间筛选与多语言输出
2. Connections（路线规划）：查找两站之间的联程方案，支持指定出发或到达时间
3. Stations（车站检索）：列出全部车站或按关键词搜索
4. Vehicle（列车详情）：获取指定车次信息及沿途停靠站
5. Composition（车厢配置）：查看列车座位布局、设施配置等细节
6. Disturbances（运行中断）：获取当前线路延误、施工计划等异常信息

关键使用规则包括：程序化解析时强制使用 --json 参数；车站名支持部分匹配与引号包裹的多词名称；时间格式为 24 小时制的 HH:MM，日期格式为 YYYY-MM-DD；输出语言可选荷兰语（默认）、法语、英语或德语。

显著优点

零门槛接入：无需 API 密钥或任何认证，即开即用，大幅降低使用成本。文档详尽完整，覆盖从基础查询到 jq 脚本处理的高级用法，并内置 Shell 补全支持。

结构化数据友好：原生支持 JSON 输出，配合示例中的 jq 过滤表达式，可快速提取下一班车时间、延误状态、换乘次数等关键字段，适合自动化工作流集成。

实时性与完整性：数据直接源自比利时国铁官方 API，覆盖实时延误、站台变更（黄色标记）、车厢设施等细粒度信息，满足通勤者与旅客的全场景需求。

潜在缺点与局限性

地域单一性：仅覆盖比利时境内的 NMBS/SNCB 网络，无法查询跨境列车的国际段（如 Eurostar、Thalys 在比利时段以外的行程）。

无持久化能力：作为纯文档型 Skill，本身不存储查询历史或偏好设置，用户需依赖环境变量（如 IRAIL_LANG）或自行封装配置管理。

API 速率限制：文档提示"在循环中添加延迟"，暗示 iRail API 存在隐式限流；高频自动化调用可能触发限制，需自行实现退避策略。

语言支持边界：虽支持四种语言输出，但车站名称搜索仍以荷兰语/法语原名为准，英语模糊匹配效果可能不稳定。

适合的目标群体

• 比利时本地通勤者：需每日查询固定线路的实时延误与站台变更
• 商务差旅人士：快速规划布鲁塞尔、布鲁日、鲁汶等城市间的当日行程
• 开发者与自动化爱好者：通过 JSON 输出与 jq 处理构建列车监控脚本、延误提醒机器人
• 游客与临时访客：以英语界面查询跨国列车在比利时境内的接驳方案

使用风险

可用性依赖：iRail API 为社区维护的第三方服务，非 NMBS/SNCB 官方直接运营，存在服务稳定性与长期维护的不确定性。

数据实时性延迟：公开 API 数据更新频率未明确承诺，极端天气或大规模延误时可能出现分钟级延迟，关键行程建议与官方渠道交叉验证。

网络与隐私：虽通过 HTTPS 加密传输，但查询行为暴露于公共网络；频繁查询特定车站可能泄露用户出行模式，敏感场景建议配合代理使用。

无代码执行风险：该 Skill 本身无可执行代码，不存在命令注入或本地权限提升风险，但用户若直接复制文档中的 Bash 示例执行，需自行验证管道安全性（如 jq 处理不可信输入时的边界情况）。