在開發 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。
