机票比价 123wansui-989/dsh-flight-compare

dsh-flight-compare

DSH 插件：注册 flight_compare 工具，从多个数据源获取单条航线的机票价格，按「航班号 + 出发日期」聚合，标出每个航班跨数据源的最低价及其来源，并按最低价升序输出 Markdown 表格。

数据源（见 src/sources/）：

| 数据源 | 接口 | 说明 |
| Travelpayouts | GET /v2/prices/month-matrix | 缓存价格，支持整月查询，按城市 IATA 码查询 |
| Amadeus | GET /v2/shopping/flight-offers | 官方 Self-Service API 实时报价，按机场 IATA 码查询，需要 YYYY-MM-DD 具体日期 |

两个源都实现 src/sources/types.ts 里的 FlightSource 接口，统一返回 Flight 对象（航班号、航司、出发/到达、时间、价格、币种、来源）。某个源查询失败不会让整次调用失败，失败原因会在结果里列出。

安装

cd dsh-flight-compare
pnpm install
pnpm build

配置

凭据只从环境变量读取，不写进代码。Travelpayouts 必填；Amadeus 两项都留空时该源自动跳过，插件退化为单源比价：

export TRAVELPAYOUTS_TOKEN="<your-travelpayouts-token>"

可选：启用 Amadeus 第二个数据源
export AMADEUS_CLIENT_ID="<your-amadeus-api-key>"
export AMADEUS_CLIENT_SECRET="<your-amadeus-api-secret>"
export AMADEUS_PRODUCTION="false" # true 时查询 api.amadeus.com

Amadeus Self-Service key 在 https://developers.amadeus.com 注册后自助创建，测试环境自带免费额度；测试环境是生产数据的子集，小城市可能查不到结果，建议先用大城市航线验证。

| 配置项 | 默认值 | 说明 |
| travelpayoutsToken | process.env.TRAVELPAYOUTS_TOKEN | Travelpayouts token，必填，作为 X-Access-Token 发送。 |
| token | 无 | 0.1.0 的旧字段名，作为 travelpayoutsToken 的兼容别名保留，两者同时存在时以 travelpayoutsToken 为准。 |
| amadeusClientId | process.env.AMADEUS_CLIENT_ID | Amadeus API key；与 secret 同时为空则该源不启用。 |
| amadeusClientSecret | process.env.AMADEUS_CLIENT_SECRET | Amadeus API secret，用于 OAuth2 client_credentials 取 token。 |
| amadeusProduction | false | false 用 test.api.amadeus.com，true 用 api.amadeus.com。 |
| amadeusMaxResults | 20 | 每次搜索向 Amadeus 请求的报价条数上限。 |
| currency | RUB | 价格币种，例如 RUB、USD；会作为 Amadeus 的 currencyCode。 |
| maxRows | 30 | 输出表格的最大行数。 |
| timeoutMs | 20000 | 每个数据源单次请求的超时时间（毫秒）。 |

覆盖默认值（cordis.patch.yml）：

- insert:
- id: dsh-flight-compare
name: dsh-flight-compare
config:
travelpayoutsToken: !!js process.env.TRAVELPAYOUTS_TOKEN
amadeusClientId: !!js process.env.AMADEUS_CLIENT_ID
amadeusClientSecret: !!js process.env.AMADEUS_CLIENT_SECRET
amadeusProduction: !!js process.env.AMADEUS_PRODUCTION === 'true'
currency: USD
maxRows: 30

departDate 传 YYYY-MM-DD 时两个源都会查；传 YYYY-MM 或不传时只有 Travelpayouts 参与比对（Amadeus 的搜索接口只接受单日），结果里会有一条说明。

本地调试

--patch 是 launcher 的 flag，必须跟在 --profile 之后（dsh <name> 是 dsh --profile <name> 的简写），补丁路径相对当前目录解析：

export TRAVELPAYOUTS_TOKEN="<your-travelpayouts-token>"
export AMADEUS_CLIENT_ID="<your-amadeus-api-key>"
export AMADEUS_CLIENT_SECRET="<your-amadeus-api-secret>"

在插件目录里启动当前 profile，并叠加这个补丁层
cd dsh-flight-compare
dsh --profile web --patch ./cordis.patch.yml

--profile web 换成实际要启动的 profile 名字即可（例如 dsh tui --patch ./cordis.patch.yml）。补丁里的 name: dsh-flight-compare 由 profile 的 node_modules 解析，所以先用 dsh plugin --profile <profile> add <本目录绝对路径> 把包装进 profile：

dsh plugin --profile web add "$(pwd)"

先确认组合结果再启动：
dsh --profile web --patch ./cordis.patch.yml --dump-config