UK Trains

核心用法

UK Trains skill 通过调用 National Rail Darwin/Huxley2 官方 API，提供英国全境铁路的实时出发/到达信息查询。支持以 3 字母 CRS 代码（如 PAD、EUS）精确定位车站，可查询特定方向的列车、过滤延误状态，并输出结构化的 JSON 数据或格式化聊天消息。

典型场景

• 通勤者查询早高峰班次及延误情况
• 旅客规划跨城行程，确认站台与换乘时间
• 差旅人士实时追踪接站/送站时间

显著优点

1. 权威数据源：直接对接 National Rail 官方 Darwin API，非第三方聚合，信息实时性与准确性有保障。
2. 全英覆盖：支持 Great Britain 境内所有火车站（英格兰、苏格兰、威尔士），非仅限大伦敦地区。
3. 结构化输出：JSON 包含计划/预计时间、站台、运营商、取消原因等完整字段，便于自动化处理。
4. 场景化模板：内置 WhatsApp/聊天友好格式，自动处理延误、取消状态并附带 emoji 标识。

潜在缺点与局限

• 仅限英国：不支持欧洲之星（Eurostar）及北爱尔兰（NI）铁路系统。
• API Token 门槛：需用户自行注册获取免费 Token，配置流程对非技术用户存在门槛。
• arrival 时间需二次查询：单程到达时间需分别调用 departures + arrivals 接口并手动匹配 service ID，逻辑较繁琐。
• 无票价信息：仅提供运行状态，不含票价、余票或预订功能。

适合人群

• 常驻或频繁往返英国的通勤者、商务旅客
• 需要集成铁路数据至自动化工作流的技术用户
• 旅行规划类助手开发者

常规风险

• Token 泄露风险：NATIONAL_RAIL_TOKEN 若配置于公共仓库或日志，可能导致 API 配额被滥用。
• 服务依赖：Darwin API 偶有维护或限流，极端天气下数据更新可能延迟。
• CRS 代码误用：输入非标准代码或拼写错误将导致查询失败，需依赖用户手册中的对照表。

核心用法

UK Trains 是一款专注于英国铁路出行信息查询的 Agent Skill，通过调用 National Rail 官方 Darwin API 及开源 Huxley2 中间层，为用户提供实时、准确的列车运行数据。该技能支持三大核心功能：出发查询（Departures）、到达查询（Arrivals） 以及 车站代码搜索（Search）。

用户可通过简单的命令行指令获取指定车站的实时离站信息，例如 ./scripts/trains.py departures PAD 查询伦敦帕丁顿站的出发列车。高级用法支持筛选目的地（如 to OXF 指定牛津方向）、限制返回结果数量（--rows 5），以及通过双 API 调用组合获取完整的到达时间信息。技能内置 15 个主要英国车站的三字母 CRS 代码速查，覆盖伦敦五大终点站及曼彻斯特、伯明翰、爱丁堡等核心枢纽。

响应数据以结构化 JSON 返回，包含计划/预计时间、站台号、运营公司、车厢编组、延误原因及取消状态等完整字段，并附带 WhatsApp/聊天场景优化的小巧文本模板，支持 🚂 表情符号、粗体时刻、📍 站台标记等视觉增强元素。

显著优点

官方数据源权威性：直接对接 National Rail Darwin 官方 API，数据实时性高，与车站电子显示屏同步，可信度远超第三方聚合服务。零依赖轻量架构：纯 Python 标准库实现（urllib + xml.etree），无需安装任何第三方包，部署极简，维护成本极低。安全凭证管理：API Token 通过环境变量 NATIONAL_RAIL_TOKEN 注入，无硬编码密钥风险，符合安全最佳实践。响应格式友好：内置聊天场景模板生成器，自动将技术 JSON 转化为带 emoji 的易读文本，适合即时通讯场景快速分享。全英覆盖无盲区：支持任意 GB 车站查询，通过 CRS 代码体系实现对英国铁路网络的完整映射。

潜在缺点与局限性

地域受限：功能完全聚焦于英国（Great Britain）铁路网络，对欧洲之星跨境服务、北爱尔兰铁路或全球其他铁路系统无支持。API Token 申请门槛：需用户自行前往 National Rail 官网注册获取免费 Token，对首次使用者增加了一步配置成本。到达时间查询复杂：由于 Darwin API 的设计特性，获取准确到达时间需两次 API 调用（出发查询获取 serviceID，再匹配到达查询），技能未封装为单命令自动完成。网络依赖性强：无离线缓存机制，API 服务中断或网络波动时将完全失效。无高级规划功能：不支持票价查询、座位预订、多段联程规划或实时拥挤度等进阶出行服务。

适合的目标群体

英国本地居民与通勤者：日常依赖火车通勤的上班族，需快速查询延误与站台变更。赴英旅客与留学生：不熟悉英国铁路系统的国际访客，通过 CRS 代码速查和清晰模板降低使用门槛。差旅协调人员：需为团队或客户实时同步火车动态的行政助理或商务接待。开发者与集成需求方：寻求轻量化、无依赖的英国铁路数据接入方案，可嵌入更大出行系统作为数据层。

使用风险与注意事项

API Token 安全存储：尽管技能本身从环境变量读取凭证，但用户需自行确保 Token 不被泄露到日志、版本控制或共享环境中。服务可用性依赖：Darwin API 为免费服务，存在速率限制或服务变更可能；Huxley2 作为社区托管的中间层，其稳定性无 SLA 保障。数据时效性边界："实时"数据仍存在分钟级延迟，极端突发情况（如轨道故障刚发生）可能未及时同步。建议关注事项：生产环境使用建议添加请求重试与熔断机制；Shell 脚本中的 curl 调用应补充 --max-time 超时参数以匹配 Python 端的 30 秒设置。