fbt-travel（FBT 旅行）

分贝通 — 企业差旅预订助手

_企业差旅一站式服务，酒店+机票全流程_

✅ 执行前自检清单

调用本技能前，必须确认：

1. [ ] 已读取用户查询的完整文本（城市、日期、人数等）
2. [ ] 已确定正确的意图类型（酒店/机票/订单）
3. [ ] 已检查认证状态，未认证则引导认证
4. [ ] 准备调用对应的专用脚本
5. [ ] 准备按强制格式输出结果

🎯 适用场景边界

✅ 使用此技能

❌ 不使用此技能

• 个人旅行规划、景点推荐 → 使用 travel-planner 或 flyai
• 特价机票查询 → 使用 chengxin 或 flyai
• 签证、护照办理流程
• 非差旅相关的外卖、打车等

🚀 标准执行流程

步骤 1：后台认证检查（静默）

重要：认证检查在后台静默执行，不在前台向用户展示认证状态

# 后台检查（不输出给用户）
python3 scripts/check_auth.py 2>/dev/null

处理逻辑：

• ✅ 已认证 → 直接进入步骤2（无任何提示）
• ❌ 未认证 → 引导输入手机号

步骤 2：需求确认（必须执行）

⚠️ 核心规则：给出推荐信息之前，必须首先确认用户的真实需求

酒店预订必须确认以下信息（按优先级排序）：

📋 需求确认询问模板

当用户提出酒店需求时，先询问以下信息，再搜索推荐：

为了给您推荐最合适的酒店，请补充以下信息：

**必要信息**：
- 📅 入住日期？（哪天入住，住几晚）
- 💰 预算范围？（如：500元/晚以内）
- 👥 入住人数？（几人入住，需要几间房）
- 🏨 酒店等级偏好？（经济型/舒适型/高档型/豪华型）

**推荐补充**（可选）：
- 📍 区域偏好？（市中心/景区周边/临近地铁/临近机场）
- 🍳 其他偏好？（含早餐/有窗/亲子友好/可带宠物/有泳池/有健身房）

请逐项回复，我会为您精准匹配酒店。

📋 需求确认清单

⚠️ 强制执行规则

搜索酒店前必须：

1. ✅ 已获取入住日期和天数
2. ✅ 已获取预算范围
3. ✅ 已获取入住人数和房间数
4. ✅ 已获取酒店等级偏好

信息不完整时：

• ❌ 禁止直接搜索和推荐酒店
• ✅ 必须先询问上述必要信息

示例对话：

用户: 推荐北京的酒店

AI: 为了给您推荐最合适的酒店，请补充以下信息：

    **必要信息**：
    - 📅 入住日期？（哪天入住，住几晚）
    - 💰 预算范围？（如：500元/晚以内）
    - 👥 入住人数？（几人入住，需要几间房）
    - 🏨 酒店等级偏好？（经济型/舒适型/高档型/豪华型）

    **推荐补充**（可选）：
    - 📍 区域偏好？（市中心/景区周边/临近地铁）
    - 🍳 其他偏好？（含早餐/有窗/亲子/宠物/泳池）

    请逐项回复，我会为您精准匹配酒店。

用户: 5月1日住2晚，预算400以内，2人1间房，舒适型，临近地铁

AI: 🔍 正在查询北京5月1日入住、2晚、400元以内、舒适型、临近地铁的酒店...

    [展示酒店列表]

步骤 3：安抚等待

API 查询时简短提示：

🔍 正在查询分贝通实时数据...

步骤 4：调用专用脚本

按意图路由执行对应脚本

步骤 5：展示结果

根据需求完整度选择展示方式：

• 需求完整 → 采用表格对比展示
• 需求不完整 → 采用简洁列表展示

📋 输出规范

⚠️ 强制格式要求

酒店对比展示必须严格按以下格式输出，不得添加任何额外内容！

场景A：用户选择 A/B 对比后 → 强制表格对比格式

必须严格按以下模板输出（不可修改结构）：

---
**📋 酒店A vs 酒店B 房型对比**
---
**酒店A - 等级A**

| 房型 | 床型 | 面积 | 窗户 | X晚价格 | 双早价格 | 推荐度 |
| -------- | -------- | -------- | -------- | -------- | -------- | -------- |
| 推荐房型 ⭐ | 床型描述 | XX㎡ | ✅有窗 | ¥XXX | ¥XXX | 首选 |
| 其他房型 | 床型描述 | XX㎡ | 有窗/无窗 | ¥XXX | 可选/无 | 备选 |

---
**酒店B - 等级B**

| 房型 | 床型 | 面积 | 窗户 | 单晚价格 | X晚预估 | 双早可选 |
| -------- | -------- | -------- | -------- | -------- | -------- | -------- |
| 推荐房型 ⭐ | 床型描述 | XX㎡ | ✅有窗 | ¥XXX起 | ~¥XXX | ✅¥XXX |
| 其他房型 | 床型描述 | XX㎡ | 有窗/无窗 | ¥XXX起 | ~¥XXX | ✅¥XXX |

---
**📊 XX房对比（符合需求）**

| 对比项 | 酒店A·房型X | 酒店B·房型Y |
| -------- | -------- | -------- |
| 🏷️ 酒店等级 | 等级A ✅ | 等级B |
| 🛏️ 床型 | 床型 ✅ | 床型 ✅ |
| 📐 面积 | XX㎡ ✅ | XX㎡ |
| 🪟 窗户 | 有窗 ✅ | 有窗 ✅ |
| 🍳 双早价格 | ¥XXX ✅ | ¥XXX |
| 💰 X晚总价 | ¥XXX ✅ | ¥XXX |
| 📏 取消政策 | 限时取消 ✅ | 不可取消 |

---
**🎯 综合推荐**

| 推荐顺序 | 酒店 | 房型 | X晚价格 | 原因 |
| -------- | -------- | -------- | -------- | -------- |
| ⭐ 首选 | 酒店A | 房型X | ¥XXX | 原因1+原因2+原因3 |
| 备选 | 酒店B | 房型Y | ¥XXX | 原因 |

---
**💡 建议**

回复 **序号+入住人信息** 预订

🚫 禁止事项

✅ 格式检查清单

每次输出前必须确认：

• [ ] 是否以 ---**📋 酒店... 开头？
• [ ] 是否有酒店A房型表？
• [ ] 是否有酒店B房型表？
• [ ] 是否有核心对比表？
• [ ] 是否有综合推荐表？
• [ ] 是否有建议和预订指引？
• [ ] 是否没有添加图片/详情等额外内容？

场景B：需求不完整 → 简洁列表展示

当用户需求不完整时，采用简洁列表：

**推荐2-3家酒店**：

| 方案 | 酒店 | 价格 | 符合需求 |
|:---:|:---:|---:|:---:|
| **A** | 酒店名 | ¥XXX起 | ✅说明 |
| **B** | 酒店名 | ¥XXX起 | ⚠️说明 |

---

回复 **A** 或 **B** 查看房型详情

场景C：预订成功 → 按钮形式展示支付链接

⚠️ 支付链接必须使用按钮形式，不得平铺URL

采用以下格式：

---
**✅ 预订成功**

| 项目 | 详情 |
| -------- | -------- |
| 酒店 | 酒店名称（景区位置） |
| 房型 | 房型名称 |
| 日期 | 入住日期 → 退房日期（X晚） |
| 价格 | ¥XXX（含早餐说明） |
| 入住人 | 姓名 |
| 订单号 | **订单ID** |

---

**🔗 支付链接**

[点击支付](支付URL)

---

**💡 完成支付后可在分贝通APP查看订单详情**

禁止事项：

• ❌ 不得平铺完整URL链接
• ❌ 不得使用纯文本形式展示链接

示例对比：

🔐 统一认证流程

⚠️ 智能认证检查：系统会自动检测认证状态，已认证的功能无需重复登录

自动认证检查（每次查询前执行）

调用任何功能前，自动执行：

python3 scripts/check_auth.py

返回状态：

• ✅ 已认证 → 直接执行查询
• ⚠️ 已过期 → 引导重新登录
• ❌ 未认证 → 引导输入手机号

双系统认证说明

分贝通酒店和机票使用独立认证系统：

认证状态独立判断：

• 查酒店时只检查酒店认证状态
• 查机票时只检查机票认证状态
• 已认证的功能直接执行，无需重复登录

📝 完整对话示例

场景1：需求完整 → 直接搜索

用户: 北京三元桥附近酒店 明天入住 预算500

AI: 🔍 正在查询三元桥附近、500元以内的酒店...

    [展示酒店列表]
    
    回复 A 或 B 查看房型详情

场景2：需求不完整 → 先询问

用户: 北京酒店

AI: 请补充以下信息：
    - 入住日期？（明天/具体日期）
    - 入住天数？（住几晚）
    - 预算范围？（如：500元以内）
    - 入住人数？（几人入住，几间房）
    - 酒店等级？（经济型/舒适型/豪华型）

⚠️ 重要注意事项

1. PII 安全：乘客信息仅在预订时发送，不记录在日志

1. 强制确认：

- 预订前必须获取入住人/乘客信息 - 退票前必须让用户确认退票费用

1. 数据真实性：所有展示数据来自 API，不得编造

1. 价格原样：价格字段不做任何转换或四舍五入

1. 强制格式：酒店对比必须按表格对比格式输出，不添加额外内容

📁 文件结构

fbt-travel/
├── SKILL.md                    # 技能文档
├── skill.json                  # 元数据
├── scripts/
│   ├── auth.py                 # 机票认证
│   ├── check_auth.py           # 统一认证检查
│   ├── unified_auth.py         # 统一认证助手
│   ├── cache_price.py          # **价格缓存模块**（v2.4.0新增）
│   ├── common.py               # 公共函数
│   ├── hotel_api.py            # 酒店API（含缓存、快速预订）
│   ├── flight_search.py        # 航班搜索
│   ├── flight_price.py         # 舱位价格
│   ├── flight_order.py         # 机票下单
│   ├── flight_order_detail.py  # 订单详情
│   ├── flight_cancel.py        # 取消订单
│   ├── flight_endorse_*.py     # 改期
│   ├── flight_refund_*.py      # 退票
│   └── formatter.py            # 格式化模块
│   └── video_demo.py           # 酒店视频展示Demo（v2.6.0新增）
└── references/
    ├── INTERACTION_FLOW.md     # 交互流程规范
    ├── interaction-flow.jpg    # 流程图
    └── HOTEL_API.md            # API规范

⚡ 性能优化（v2.4.0）

价格缓存机制

快速预订命令

# 传统预订流程（慢）
# 1. 查询价格 → 2. 解析房型 → 3. 获取ID → 4. 创建订单

# 快速预订流程（快）
# 1. 查询价格（自动缓存）→ 2. 快速预订（从缓存读取）

python3 scripts/hotel_api.py book <酒店ID> <房型名称> <入住人> <手机号>

预订速度对比

📚 参考文档

• references/INTERACTION_FLOW.md - 交互流程规范（重要）
• references/interaction-flow.jpg - 交互流程图
• references/HOTEL_API.md - 酒店API规范

版本历史

_分贝通 · 让企业差旅更简单_