在开发 DSH 智能体时，集成外部数据源是常见需求。如果需要集成 Caltrain 火车时刻表，直接调用第三方 API 并维护接口逻辑会增加开发成本。xby-caltrain 插件基于 GTFS 数据，提供了现成的查询接口，可以快速为智能体添加交通信息查询能力。
功能说明¶
这是一个 DeepSeek Harness (DSH) 的联网工具插件，由用户 xby_skill 维护。它主要解决在智能体对话中查询 Caltrain 火车班次和站点信息的问题。
核心功能包括：
- set_xby_apikey：在聊天中设置 API 密钥。该设置会自动持久化，重启 DSH 进程后依然有效。
- next_trains：查询下一次 Caltrain 的出发时间。支持常见站点缩写（如 ‘SF’、’SJ’）。如果不提供具体时间，默认查询当前时间后的班次。
- list_stations：列出所有可用的 Caltrain 站点。当
next_trains报错 “Station not found” 时，使用此工具确认站点名称拼写。
安装与配置¶
使用本插件前，需要先获取 API 密钥。请前往小笨羊官网注册并获取密钥。
安装命令如下：
dsh plugin --profile web add github:xby_skill/xby-caltrain
典型用法¶
安装完成后，可以在 DSH 聊天中直接调用上述工具。
# 查询从旧金山到圣何塞的下一班列车
next_trains(origin='SF', destination='SJ')
# 查询特定时间点的班次
next_trains(origin='San Jose Diridon', destination='San Francisco')
# 查看所有可用站点
list_stations()
注意事项¶
- API 密钥：必须先调用
set_xby_apikey设置密钥，否则查询功能将不可用。 - 站点名称：如果遇到 “Station not found” 错误，请先运行
list_stations()查看系统支持的站点名称列表。输入的名称必须与列表中的名称匹配（系统不区分大小写，但可能对空格敏感）。
该插件遵循 MIT 许可证。源码位于 GitHub。
