python3 scripts/hotel_api.py query_order <订单ID>
python3 scripts/hotel_api.py cancel_order <订单ID> [取消原因]

# 查询退票费
python3 scripts/flight_refund_fee.py <订单ID>

# 提交退票申请（需用户确认退票费）
python3 scripts/flight_refund_apply.py <订单ID> <退票金额>

分贝通旅行助手

一站式企业差旅服务，整合酒店预订和机票预订功能。

---

🔐 鉴权流程（必须先完成）

重要：使用任何功能前，用户必须先完成鉴权流程。鉴权成功后获得的凭证会自动保存在 ~/.fbt-auth.json 文件中，新会话会自动沿用。

鉴权步骤

步骤 1：发送验证码

用户: 分贝通登录
AI: 请输入您的手机号

用户: 13800138000
AI: ✅ 验证码已发送，请在5分钟内输入

步骤 2：验证并获取凭证

用户: 1234
AI: 🎉 认证成功！现在可以使用分贝通旅行服务了

鉴权命令

bash

发送验证码

python3 scripts/auth.py send <手机号>

验证验证码

python3 scripts/auth.py verify <手机号> <验证码>

查看鉴权状态

python3 scripts/auth.py status

---

🏨 酒店服务

1. 搜索酒店

触发词：订酒店、搜酒店、找酒店 + 城市/关键词

执行命令：
bash
python3 scripts/hotel_api.py search <城市> <关键词> [入住日期] [退房日期]

示例：
bash
python3 scripts/hotel_api.py search 北京市 三元桥附近 2026-03-26 2026-03-27

2. 查看房型价格

触发词：回复酒店序号（如1）

执行命令：
bash
python3 scripts/hotel_api.py price <酒店ID> <入住日期> <退房日期>

3. 查看酒店详情和评论

触发词：回复序号-详情（如1-详情）

执行命令：
bash
python3 scripts/hotel_api.py detail <酒店ID>
python3 scripts/hotel_api.py comment <酒店ID>

4. 创建酒店订单

触发词：回复房型序号-产品序号（如1-1）+ 提供入住人信息

执行命令：
bash
python3 scripts/hotel_api.py order <酒店ID> <房型ID> <产品ID> <入住日期> <退房日期> <总价> <入住人姓名> <入住人手机号>

5. 查询/取消酒店订单

触发词：查看订单、取消订单

执行命令：
bash
python3 scripts/hotelapi.py queryorder <订单ID>
python3 scripts/hotelapi.py cancelorder <订单ID> [取消原因]

---

✈️ 机票服务

1. 搜索航班

触发词：某地到某地航班、查机票、搜航班 + 日期

执行命令：
bash
python3 scripts/flight_search.py <出发城市> <到达城市> <日期>

示例：
bash
python3 scripts/flight_search.py 北京 上海 2026-04-02

2. 查看舱位价格

触发词：查看航班详情、这个航班的舱位

执行命令：
bash
python3 scripts/flight_price.py <出发机场三字码> <到达机场三字码> <日期> <航班号>

示例：
bash
python3 scripts/flight_price.py PEK SHA 2026-04-02 CA1501

3. 查看退改规则（可选）

触发词：退改规则、行李额、这个舱位的政策

执行命令：
bash
python3 scripts/flightguestrule.py <舱位编号>

4. 创建机票订单

触发词：订这个、预订、下单 + 乘客信息

执行命令：
bash
python3 scripts/flight_order.py <舱位编号> <乘客姓名> <乘客手机号> <乘客证件号>

示例：
bash
python3 scripts/flight_order.py 1 张三 13800138000 110101199001011234

5. 查询/取消机票订单

执行命令：
bash
python3 scripts/flightorderdetail.py <订单ID>
python3 scripts/flight_cancel.py <订单ID>

6. 改期

触发词：改期、改签、换航班

执行命令：
bash

搜索可改期的航班

python3 scripts/flightendorsesearch.py <订单ID> <改期日期>

查看改期价格

python3 scripts/flightendorseprice.py <订单ID> <改期日期> <新航班号>

提交改期申请

python3 scripts/flightendorseapply.py <舱位编号> <订单ID>

7. 退票

触发词：退票

执行命令：
bash

查询退票费

python3 scripts/flightrefundfee.py <订单ID>

提交退票申请（需用户确认退票费）

python3 scripts/flightrefundapply.py <订单ID> <退票金额>

---

📋 完整示例

酒店预订流程

用户: 预订北京三元桥附近的酒店 明日入住

AI: [展示酒店列表表格]
回复序号查看房型价格

用户: 3

AI: [展示房型和价格表格]
回复房型序号-产品序号预订

用户: 1-1 郜文彬 1348879748

AI: ✅ 订单创建成功！
订单号: xxx
[支付链接]

机票预订流程

用户: 4月2日北京到上海的航班

AI: [展示航班列表表格]
回复航班号查看舱位

用户: CA1501

AI: [展示舱位价格表格]
回复舱位编号预订

用户: 订第1个 张三 13800138000 110101199001011234

AI: ✅ 订单创建成功！
订单号: xxx
[支付链接]

---

⚠️ 重要注意事项

1. 1. PII 安全：乘客姓名、手机号、证件号等个人信息仅在预订时发送至服务，不会在日志中暴露

1. 2. 日期格式：所有日期均为 YYYY-MM-DD

1. 3. 强制确认：

- 下单时必须索取乘客/入住人信息 - 退票时必须让用户确认退票费用

1. 4. 数据准确性：展示结果必须基于脚本输出的原始数据，不得修改或编造

1. 5. 统一鉴权：酒店和机票共用同一套鉴权系统，一次登录即可使用所有服务

---

📁 文件结构

fbt-travel/
├── SKILL.md # 技能说明文档
├── skill.json # 技能元数据
├── scripts/
│ ├── auth.py # 统一鉴权
│ ├── common.py # 公共函数
│ ├── hotel_api.py # 酒店API封装
│ ├── flight_search.py # 航班搜索
│ ├── flight_price.py # 舱位价格
│ ├── flight_order.py # 机票下单
│ ├── flightorderdetail.py # 订单详情
│ ├── flight_cancel.py # 取消订单
│ ├── flightendorse*.py # 改期相关
│ └── flightrefund*.py # 退票相关
└── references/
└── HOTEL_API.md # 酒店API规范

---

📝 格式化输出模块

文件位置：scripts/formatter.py

展示配置

配置项	默认值	说明
FLIGHTLISTLIMIT	5	航班列表展示数量
SEATLISTLIMIT

5 | 每个航班展示的舱位数量 |

格式化函数

python
from scripts.formatter import (
formatflightlist, # 航班列表格式化
formatseatlist, # 舱位价格格式化
formatorderresult, # 订单创建结果格式化
formatbaggageinfo, # 行李额格式化
formatrefundrule, # 退改规则格式化
formatorderstatus # 订单状态格式化
)

展示字段规范

航班列表必须包含：

• - 序号、航班号、航司、时间、航线、机型、最低价

舱位价格必须包含：

• - 序号、舱位名称、舱位代码、折扣、票价、机建、燃油、总价、余座

订单详情必须包含：

• - 订单号、航班信息、舱位信息
• 票价明细（票价+机建+燃油）
• 行李额（托运+手提）

-