分贝通旅行

一站式企业差旅服务，提供酒店搜索预订、机票查询预订、改期退票等全流程服务。智能需求确认、后台静默认证、表格对比展示。基于分贝通官方数据，实时准确可靠。

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

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

---

✅ 执行前自检清单

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

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

---

🎯 适用场景边界

✅ 使用此技能

场景	示例
酒店搜索预订	"北京三元桥附近酒店"、"明天入住上海酒店"
机票搜索预订	"北京到上海航班"、"明天飞广州"
改期改签	"帮我改期到下周"、"这个航班改签"
退票取消	"退掉这个机票"、"取消酒店订单"
订单查询	"查看我的订单"、"订单详情"

❌ 不使用此技能

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

---

🚀 标准执行流程

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

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

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

处理逻辑：

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

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

⚠️ 核心规则：必须先询问需求，再搜索酒店

酒店预订必须确认以下信息：

信息项	重要性	询问话术
入住日期	必须	"入住日期是哪天？"
入住天数	必须	"住几晚？"
预算范围	必须	"预算大概多少？"
入住人数	必须	"几位入住？几间房？"
酒店等级	必须	"酒店等级？经济型/舒适型/豪华型"
区域偏好	推荐	"区域需求？市中心/景区周边/临近地铁"
其他偏好	推荐	"其他偏好？含早餐/有窗/亲子/宠物/泳池"

步骤 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链接
• ❌ 不得使用纯文本形式展示链接

示例对比：

格式	说明
❌ 错误	https://app-gate.fenbeitong.com/business/hotel/...
✅ 正确	点击支付

---

🔐 统一认证流程

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

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

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

python3 scripts/check_auth.py

返回状态：

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

双系统认证说明

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

系统	认证文件	有效期	功能范围
机票	~/.fbt_auth.json	90天	航班搜索、预订、改期、退票
酒店	~/.fbt-auth.json	90天	酒店搜索、预订、取消

认证状态独立判断：

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

---

📝 完整对话示例

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

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

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

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

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

用户: 北京酒店

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

---

⚠️ 重要注意事项

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

2. 强制确认：

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

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

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

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

---

📁 文件结构

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            # 格式化模块
└── references/
    ├── INTERACTION_FLOW.md     # 交互流程规范
    ├── interaction-flow.jpg    # 流程图
    └── HOTEL_API.md            # API规范

---

⚡ 性能优化（v2.4.0）

价格缓存机制

优化项	说明
缓存文件	~/.fbt_price_cache.json
缓存时机	价格查询时自动保存
缓存内容	hotel_id, room_id, plan_id, total_price
预订提速	从缓存读取，无需重复查询API

快速预订命令

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

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

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

预订速度对比

方式	API调用次数	预订耗时
传统预订	2-3次	5-10秒
快速预订	1次	1-2秒 ⚡

---

📚 参考文档

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

---

版本历史

版本	日期	变更说明
2.4.0	2026-04-21	预订速度优化：添加价格缓存机制，预订时从缓存读取room_id/plan_id，无需重复查询API
2.3.0	2026-04-21	支付链接按钮形式：预订成功后支付链接采用按钮形式，不得平铺URL
2.2.0	2026-04-21	强制表格对比格式：禁止添加图片/详情，必须按固定结构输出
2.1.0	2026-04-21	表格对比展示格式：酒店房型对比表+双床房对比表+综合推荐表
2.0.0	2026-04-21	详细对比展示模式：需求完整时采用预算分析+推荐方案对比表+酒店详情表+房型对比表+预订指引的结构化展示
1.9.0	2026-04-21	智能推荐理由：自动生成预算内、评分优、连锁品牌、临近地铁、性价比等推荐标签

---

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