一起飞 PNR 行程单助手
Default Action（首轮：脚本输出，原样贴出）
python skills/yqf-pnrhelper/scripts/invoke_retrieve_pnr.py --pnr KXDY1F
（工作目录为 Agent workspace 根；照抄上面命令换 PNR 即可，脚本名就是 invoke_retrieve_pnr.py，不要猜其它名字、不要先 ls 探路。）
Agent 硬性规定：
- 运行命令（不要
--json）。 - stdout 整段原样贴入聊天（含
> 脚本格式 v…行、### 航班信息宽表、## 导出选项）。 - 禁止手搓 Markdown；禁止「### 第 N 航段」+「项目|内容」竖表（旧版，已废弃）。
- 禁止改写表格、压成一行、删掉导出选项表。
- 禁止手写「需要 HTML 还是 PDF…」 prose 替代序号表；禁止写「回复数字…」（客户端自动显示 1–5 按钮）。
导出选项（脚本已生成，勿重复）
| 序号 | 事项 |
|---|---|
| [1] | 一起飞官方行程单 HTML（mytrip 经典版式） |
| [2] | 简约现代 HTML（适合打印） |
| [3] | 导出 PDF |
| [4] | 导出 Word 文档 |
| [5] | 不用了 |
用户回复 选 1 / 选 2 / 点底部按钮 / 纯数字 1 时，按序号执行：
| 用户选择 | 动作 |
|---|---|
| 1 | invoke_pnrhelper.py --pnr … --html --style mytrip |
| 2 | invoke_pnrhelper.py --pnr … --html --style modern |
| 3 | invoke_pnrhelper.py --pnr … --pdf --style mytrip（PDF 默认 mytrip 版式） |
| 4 | invoke_pnrhelper.py --pnr … --doc --style mytrip |
| 5 | 结束，不生成文件 |
展示规范（mytrip 对齐）
首轮 Markdown 只贴脚本 stdout，按航段块展示：
- 标题 电子行程单、尊敬的旅客、记录编号（可含航司 PNR）
- ### 航班信息：标准 Markdown 表（一行一航段，列：航段/日期/航班/状态/舱位/经停/历时/机型/起飞/到达）
- ### 票号 表（旅客 | 票号）
- 有则展示旅游顾问、温馨提示（禁止追加「在线行程单」「小程序行程单」链接或 URL）
禁止在聊天正文展示： itinerary.pageUrl、itinerary.miniAppQrCodeUrl、itinerary.h5Url（小程序码仅在导出的 HTML 右上角显示）。
导出（确认后）
禁止未确认时生成文件；禁止同时 PDF+Word。
输出格式（YQFClaw 桌面 · 追问 chip）
YQFClaw 会在助手回复最末尾的 ## 可以试试这么问我 段落下渲染可点击 chip（该段从气泡正文隐藏）。禁止用「你可以继续问我…」等 prose 替代。
格式（全文最后）：
## 可以试试这么问我
- （完整问句 1）
- （完整问句 2）
- 每条以
-开头，写用户一点即发的完整问句；2–3 条（客户端最多展示 3 条） - 禁止重复
## 导出选项/ 序号点选已覆盖的「选 1–5」 - 纯 API 报错、单句寒暄可省略整段
首轮 PNR 提取后（stdout 含 ## 导出选项）
不要在首轮 stdout 末尾追加本段（脚本输出须原样贴出；导出选项已由客户端 1–5 按钮覆盖）。
首轮仅贴脚本结果；追问 chip 留给导出交付之后的助手回复。
HTML 导出交付后（用户选 1 或 2，已生成 HTML 文件）
交付说明 + MEDIA: 之后，必须追加 ## 可以试试这么问我，且至少一条引导换另一种 HTML 版式：
| 刚生成的版式 | 必须包含的追问示例（可改写措辞，意思不变） |
|---|---|
| mytrip 经典 HTML（选 1） | 再生成一份简约现代 HTML 版式 或 换成简约现代 HTML 行程单 |
| 简约 modern HTML（选 2） | 再生成一份一起飞官方 mytrip 经典 HTML 或 换成 mytrip 经典版式 HTML |
可再加 1 条不重复导出选项表的追问，例如：
把这份行程单导出成 PDF再导出 Word 文档提取另一个 PNR 的行程单
禁止写成「选 1」「选 2」或重复导出选项表序号。
PDF / Word 导出交付后
追加 2–3 条，可含另一种文件格式或 HTML 版式，例如：
再生成 mytrip 经典 HTML 行程单换成简约现代 HTML 版式同 PNR 导出另一种格式
用户选 [5] 不用了
可简短追加 1–2 条，如 提取另一个 PNR、帮我查这个行程的退改规则；勿再提导出序号。
Output
- 默认 stdout：mytrip Markdown +
## 导出选项序号表 --json：归一化 JSON（供其它 Skill）--html --style mytrip|modern/--pdf/--doc：文件 +MEDIA:
Core Rules
- 票号在
passengers[].ticketLine/ticketDisplay，与旅客合并展示 - API v1.2 字段：
advisor、notes.warmTips、航段dateDisplay/statusName/stopDisplay（禁止展示itinerary.pageUrl/ 小程序链接） - 预装默认启用并绑定主 Agent（YQFClaw）；
openclaw.json→agents.list[main].skills含yqf-pnrhelper - API 失败须说明原因，禁止静默
失败 / 无法查询时
AUTH_FAILED/CONFIG_MISSING（缺少 API Key）：说明原因并提示点对话下方 「去授权」；用户粘贴 Key 后由yqf-tools的apikey set回填。禁止手写 urllib、读改 Key 文件。回填成功且没有待续跑的原查询时，追加## 可以试试这么问我，至少含一条 PNR 示例（如我有 PNR 编码，帮我提取电子行程单；禁止写具体编码），并可带机票/酒店问句- 禁止建议用户去携程/去哪儿/飞猪等 OTA App、机票行程单短信或其它第三方查行程
- 引导用户访问一起飞官网（https://www.yiqifei.com）或联系一起飞客服
- 若 Agent 误称「未绑定技能」：仍应执行本 SKILL（
python skills/yqf-pnrhelper/scripts/invoke_retrieve_pnr.py --pnr <PNR>）
Additional Resources
- pnr-data-schema.md
- retrieve-pnr-api.md
- itinerary-export.md
