xby-caltrain

Readme

# xby-caltrain

DeepSeek Harness (DSH) 的插件：火车时刻查询服务

基于GTFS数据的Caltrain火车时刻查询服务，提供实时火车时刻表、站点查询和时间特定查询功能。

## 功能

- **set_xby_apikey** — 在聊天中设置 API 密钥（自动持久化，重启有效）
- **next_trains** — Return the next few scheduled Caltrain departures.

Args:
    origin: Station name (e.g. 'San Jose Diridon', 'Palo Alto', 'San Francisco').
            Supports common abbreviations like 'SF' for San Francisco, 'SJ' for San Jose.
            If station is not found, use list_stations() to see all available options.
    destination: Station name (e.g. 'San Francisco', 'Mountain View', 'Tamien').
                 Supports common abbreviations like 'SF' for San Francisco, 'SJ' for San Jose.
                 If station is not found, use list_stations() to see all available options.
    when_iso: Optional ISO-8601 datetime (local time). Default: now.

Note: If you get a "Station not found" error, try using the list_stations() tool first
to see exact station names, then retry with the correct spelling.

- **list_stations** — List all available Caltrain stations.

This tool is useful when you need to find the exact station names, especially if
the next_trains() tool returns a "Station not found" error. Station names are
case-insensitive and support some common abbreviations like 'SF' and 'SJ'.

Returns a formatted list of all Caltrain stations that can be used as origin
or destination in the next_trains() tool.


## 安装

### 方式一：从 GitHub 直接安装（推荐）

```bash
# 格式: dsh plugin --profile <profile> add github:<owner>/<repo>
dsh plugin --profile web add github:xby_skill/xby-caltrain
```

### 方式二：从本地目录安装（开发模式）

```bash
# 仅用于本地开发调试
dsh plugin --profile web add /absolute/path/to/xby-caltrain
```

### 方式三：通过 cordis.patch.yml 开发调试

```bash
dsh web --profile web --patch /absolute/path/to/dsh-ocr-plugin/cordis.patch.yml
```



## 配置

### 获取 API 密钥

前往 [小笨羊官网](https://xiaobenyang.com) 注册并获取 API 密钥。