旅行预订助手（生成即用·机酒预订）
> 触发词：飞猪、机票、酒店、旅行规划、订票、出游、flyai、行程规划、门票
> 适用场景：规划本周末杭州两日游 等（详见下文）
> 连接与鉴权：飞猪 AI 开放平台：https://flyai.open.fliggy.com/ （基于飞猪 MCP 标准化的 flyai 技能插件，直连官方商品库与动态库存，适配 OpenClaw 协议）。
一、核心用途
把旅行需求变成完整方案：给出发地/目的地/日期，即拉出航班、酒店、门票与用车选项并标出首选/备选；需预订时生成官方购买链接。通过飞猪 flyai MCP/Skill 执行。
二、适用场景
- 规划本周末杭州两日游
- 搜周五出发的往返航班并比价
- 查目的地附近评分高的酒店
- 生成含机票+酒店的可预订行程
- 查景点门票并给购买链接
三、连接与鉴权（R-去个人化：凭证一律走环境变量，绝不写死 Key/appid/token）
- 接入路径：飞猪 AI 开放平台：https://flyai.open.fliggy.com/ （基于飞猪 MCP 标准化的 flyai 技能插件，直连官方商品库与动态库存，适配 OpenClaw 协议）。
- 所需凭证（环境变量占位）：
FLYGX_API_KEY：飞猪 AI 开放平台 API Key；体验版无需 Key 即可试用，完整能力申请后填入- 免 Key 说明：体验版无需 API Key 即可自然语言试用；完整能力（实时库存/预订）需申请 Key，每位用户有限时调用包。
- 国内可达性：服务区域为中国大陆及飞猪覆盖的出行目的地；个人开发者额度有限，企业需走商务。
四、执行流程
- 接收意图与必要参数（如账号、地址、偏好、查询条件）。
- 校验参数完整性，缺失则询问或以默认偏好补全（不自行臆造未知信息）。
- 调用官方 MCP/API（通过 mcporter 或对应客户端工具）执行对应动作。
- 解析返回，格式化输出（订单号/链接/状态/费用/来源等）。
- 涉及支付、下单、删除、改写等敏感动作 → 展示预览并二次确认后执行；异常时 fail-open 不崩溃。
五、输入 / 输出
- 输入：自然语言指令 + 必要参数（账号、地址、偏好、时间等）。
- 输出：结构化结果（订单号、支付链接、状态、费用、来源 URL 等）+ 下一步建议。
六、异常处理（三级）
- 一级（可恢复）：参数缺失 → 询问补全后重试。
- 二级（需确认）：支付/下单/删除/改写 → 展示预览，用户确认后执行。
- 三级（终止）：Key 无效 / 无权限 / 服务不可达 → 报错并给出申请与排查指引，fail-open 不崩。
七、反模式（禁止）
- 禁止写死任何个人 Key / Token / appid / corpid / mch_id（R-去个人化）。
- 禁止未确认就自动支付、下单、删除或改写远端资源。
- 禁止编造平台不支持的能力、精确的 URL 或数值（R-TEST T3）。
- 禁止越权读取他人账号数据。
八、FAQ
Q：能直接下单付款吗？
A：本 skill 生成官方购买链接，点击跳转飞猪完成支付；不代执行支付，资金安全由平台保障。
Q：体验版和完整版差在哪？
A：体验版数据可能缺一些实时库存，完整版直连官方价库、可交易闭环。
九、领域参考
- 详见
references/connect.md：官方端点、申请步骤、MCP 客户端配置样例与最小权限提示。
