Skill 安装

Flight Scout
Skill

现在推荐使用官方安装器来管理 Flight Scout Skill。第一次运行会自动安装，后续再次运行同一条命令就是更新；本地 .env 和真实接口密钥独立保留，不再跟着压缩包一起分发。

查询能力

航班搜索、机场联想、价格日历、同步甩尾、异步甩尾、用量查询。

安装方式

1 条命令

未安装则安装，已安装则更新；不再区分两套流程。

本地配置

独立保留

真实 API key 放在本地 .env，Skill 更新时默认不会被覆盖。

官方安装器

一条命令完成安装和更新

Flight Scout 现在把 Skill 文件和本地配置拆开管理。推荐直接运行官方安装器：第一次运行会安装 flight-scout，后续再次运行同一条命令就是更新；本地 .env 默认会被保留，不再跟着压缩包一起分发。

同一命令安装或更新

第一次运行会安装 `flight-scout`，以后再次运行同一条命令就是更新，不再区分两套流程。

本地 .env 独立管理

安装器默认保留现有 `skills/flight-scout/.env`，只同步受管理文件，不再把真实密钥打进下载包里。

缺少真实密钥时再询问

只有在本地 `.env` 缺失，或者 `FLIGHT_SCOUT_API_KEY` 仍然是占位值时，才需要补充真实密钥。

手动模式仍然可用

如果你不想运行安装器，也可以下载模板包，按 `.env.example` 手动创建本地 `.env`。

如果当前工作区里已经有 skills/flight-scout，再次运行同一个安装器只会更新受管理文件；它不会再要求你手工对比“安装”和“更新”两套流程。

查看 install.sh同一条命令可重复运行；未安装则安装，已安装则更新。

官方安装 / 更新命令https://www.izlx.de

curl -fsSL 'https://www.izlx.de/skill/install.sh' -o /tmp/flight-scout-install.sh
bash /tmp/flight-scout-install.sh --base-url 'https://www.izlx.de' --timeout '30'

给智能助手的提示词

让 AI 只做一件事：运行官方安装器

如果你在用 Codex、Cursor、Claude Code 这类支持终端和文件编辑的智能助手，不需要再让它手工下载、解压、比对一堆文件。最简洁的做法就是让它运行官方安装器，并在缺少真实密钥时再向你询问。

提示词会自动带上当前页面的基础地址和超时设置。

统一安装 / 更新提示词https://www.izlx.de

请帮我在当前工作区运行 Flight Scout 官方安装器。请直接执行，不要只给我口头步骤，并严格遵守下面要求：

1. 先下载并执行官方安装脚本：
```bash
curl -fsSL 'https://www.izlx.de/skill/install.sh' -o /tmp/flight-scout-install.sh
bash /tmp/flight-scout-install.sh --base-url 'https://www.izlx.de' --timeout '30'
```
2. 这个脚本会自动判断：如果 `skills/flight-scout` 不存在就安装，已存在就更新。
3. 默认保留现有 `skills/flight-scout/.env`；只有在缺少真实 `FLIGHT_SCOUT_API_KEY`，或者仍然是占位值时，才暂停并直接向我询问。
4. 不要在最终回复里明文回显我的接口密钥，也不要把它提交进 git 仓库。
5. 完成后告诉我实际改了哪些文件，并做一个最小验证；如果不能运行真实请求，至少确认 `python3 skills/flight-scout/scripts/call_api.py --help` 可以执行。

密钥与配置

把 API key 和 Skill 更新拆开管理

现在的最佳实践是：Skill 安装器只负责同步代码和文档，本地真实密钥单独放在 skills/flight-scout/.env。如果你需要创建、轮换或撤销接口密钥，请去控制台管理；不再推荐“下载时把真实密钥打进压缩包”。

管理接口密钥登录控制台

高级选项

下载模板包或自定义默认配置

如果你更喜欢手动安装，也可以下载模板包。压缩包里只有受管理文件和 .env.example；真实 .env 仍然由你本地创建和保管。

接口基础地址默认就是当前站点根地址。安装器命令和下载包里的 .env.example 都会使用这里的值。请求超时秒数

查看 manifest.json

预览

.env.example 示例

# Copy to .env and fill a real API key
FLIGHT_SCOUT_API_BASE_URL='https://www.izlx.de'
FLIGHT_SCOUT_API_KEY='fs_live_replace_me'
FLIGHT_SCOUT_API_TIMEOUT_SECONDS=30

包内文件

模板包里现在包含什么

flight-scout/.env.example：本地配置模板，供你复制成真实 .env。
flight-scout/README.md：安装和手动接入说明。
flight-scout/SKILL.md：Skill 行为说明与调用规则。
flight-scout/agents/openai.yaml：给支持 Skill 的智能助手读取的默认提示配置。
flight-scout/scripts/call_api.py：可直接运行的接口调用脚本。
flight-scout/references/api-contract.md：公开接口契约摘要。
flight-scout/.env：不会再出现在模板包里，需要由安装器或你本地手动创建。

Flight ScoutSkill