jrojas537-flight-pricer

基于 Duffel API 的专业 CLI 航班价格搜索工具，支持往返、舱位与经停筛选。

## 概述（中文）

基于 Duffel API 的专业 CLI 航班价格搜索工具，支持往返、舱位与经停筛选。

## 技能正文

# flight-pricer 技能

使用 Duffel API 搜索航班价格的命令行界面（CLI）。

本技能按专业级 CLI 工具结构组织，灵感来自 `gog` 技能的质量标准。

## 前置条件

- Python 3.7+ 与 `pip`
- Duffel API 密钥

## 安装

技能设计为在独立虚拟环境中安装为正式命令行工具，隔离依赖并使智能体可全局调用。

从工作区根目录：

```bash
# 1. 激活虚拟环境
source flight-pricer/.venv/bin/activate

# 2. 可编辑安装
pip install -e flight-pricer/

# 3. 退出（可选，命令已链接）
deactivate
```

仅需执行一次。

## 设置

搜索航班前，必须用 Duffel API 密钥配置技能。

### `config set`

安全保存 API 密钥到 `~/.config/flight-pricer/config.yaml`。

**用法：**
```bash
flight-pricer config set --api-key <YOUR_DUFFEL_API_KEY>
```

## 命令

### `search`

按指定条件搜索航班报价。命令自动使用配置中的 API 密钥。

**用法：**
```bash
flight-pricer search [OPTIONS]
```

**必填选项：**

- `--from <IATA>`：出发机场 IATA 代码（如 `DTW`）。
- `--to <IATA>`：到达机场 IATA 代码（如 `MIA`）。
- `--depart <YYYY-MM-DD>`：出发日期。

**可选选项：**

- `--return <YYYY-MM-DD>`：返程日期（往返）。
- `--passengers <number>`：乘客数（默认：1）。
- `--max-stops <number>`：最大中转次数。
- `--non-stop`：`--max-stops 0` 的便捷别名。
- `--cabin <class>`：舱位。选项：`economy`、`business`、`first`、`premium_economy`。

**示例：**

搜索一人从底特律到迈阿密、2026-04-06 出发、2026-04-10 返程的直飞头等舱航班。

```bash
flight-pricer search --from DTW --to MIA --depart 2026-04-06 --return 2026-04-10 --non-stop --cabin first
```