business-travel

One-stop hotel & flight booking service.

Security Scan

The code, runtime instructions, and requested resources are consistent with a travel booking helper: it requires python3, performs network calls to a travel gateway, and stores an auth token in ~/.fbt-auth.json for reuse.

Purpose & Capability

The skill name/description (hotel & flight booking) matches the included scripts (search, price, order, refund, endorse, auth, formatter). Required binary (python3) is appropriate and no unrelated credentials or system access are requested.

Instruction Scope

SKILL.md instructs running the provided Python scripts and the scripts implement those operations. The auth flow, saving a token to ~/.fbt-auth.json, and use of temp files for seat lists are documented and implemented. The instructions do not ask the agent to read unrelated system files or exfiltrate data to unexpected endpoints.

Install Mechanism

There is no install spec (runs as-in using python3). A requirements.txt (requests) is present but not automatically installed—user/host must ensure dependencies are available. Code files are included and will be executed by the agent (no external arbitrary downloads or obscure installers).

Credentials

The skill declares no required env vars or credentials. It stores an auth token locally (~/.fbt-auth.json) which is consistent with the described unified auth flow. No unrelated secrets or config paths are requested.

Persistence & Privilege

always is false and the skill does not modify other skills or global agent settings. It does persist a token to the user's home (~/.fbt-auth.json) and writes temporary JSON files for seat lists—this is expected but grants the skill a local on-disk footprint that users should be aware of.

Assessment

This package appears internally consistent for a booking helper, but consider: 1) It will write an auth token to ~/.fbt-auth.json — treat that file as sensitive (it likely contains a bearer/api key). 2) Ensure Python3 and the 'requests' library are installed in the runtime; the package includes code but no installer. 3) The scripts call https://app-gate.fenbeitong.com (FENBEITONG); verify you trust that endpoint and the package source before providing real phone numbers or PII. 4) Run in an isolated environment if you want to limit risk (or inspect common.py to confirm API call behavior). If you need higher assurance, ask the author for a published homepage or official release/source repository and for a signed/verifiable package.

分贝通旅行助手

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

---

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

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

鉴权步骤

步骤 1：发送验证码

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

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

步骤 2：验证并获取凭证

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

鉴权命令

# 发送验证码
python3 scripts/auth.py send <手机号>

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

# 查看鉴权状态
python3 scripts/auth.py status

---

🏨 酒店服务

1. 搜索酒店

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

执行命令：

python3 scripts/hotel_api.py search <城市> <关键词> [入住日期] [退房日期]

示例：

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

2. 查看房型价格

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

执行命令：

python3 scripts/hotel_api.py price <酒店ID> <入住日期> <退房日期>

3. 查看酒店详情和评论

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

执行命令：

python3 scripts/hotel_api.py detail <酒店ID>
python3 scripts/hotel_api.py comment <酒店ID>

4. 创建酒店订单

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

执行命令：

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

5. 查询/取消酒店订单

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

执行命令：

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

---

✈️ 机票服务

1. 搜索航班

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

执行命令：

python3 scripts/flight_search.py <出发城市> <到达城市> <日期>

示例：

python3 scripts/flight_search.py 北京 上海 2026-04-02

2. 查看舱位价格

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

执行命令：

python3 scripts/flight_price.py <出发机场三字码> <到达机场三字码> <日期> <航班号>

示例：

python3 scripts/flight_price.py PEK SHA 2026-04-02 CA1501

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

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

执行命令：

python3 scripts/flight_guest_rule.py <舱位编号>

4. 创建机票订单

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

执行命令：

python3 scripts/flight_order.py <舱位编号> <乘客姓名> <乘客手机号> <乘客证件号>

示例：

python3 scripts/flight_order.py 1 "张三" "13800138000" "110101199001011234"

5. 查询/取消机票订单

执行命令：

python3 scripts/flight_order_detail.py <订单ID>
python3 scripts/flight_cancel.py <订单ID>

6. 改期

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

执行命令：

# 搜索可改期的航班
python3 scripts/flight_endorse_search.py <订单ID> <改期日期>

# 查看改期价格
python3 scripts/flight_endorse_price.py <订单ID> <改期日期> <新航班号>

# 提交改期申请
python3 scripts/flight_endorse_apply.py <舱位编号> <订单ID>

7. 退票

触发词：退票

执行命令：

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

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

---

📋 完整示例

酒店预订流程

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

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

用户: 3

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

用户: 1-1 郜文彬 1348879748

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

机票预订流程

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

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

用户: CA1501

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

用户: 订第1个 张三 13800138000 110101199001011234

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

---

⚠️ 重要注意事项

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

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

3. 强制确认：

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

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

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         # 机票下单
│   ├── flight_order_detail.py  # 订单详情
│   ├── flight_cancel.py        # 取消订单
│   ├── flight_endorse_*.py     # 改期相关
│   └── flight_refund_*.py      # 退票相关
└── references/
    └── HOTEL_API.md            # 酒店API规范

---

📝 格式化输出模块

文件位置：scripts/formatter.py

展示配置

配置项	默认值	说明
FLIGHT_LIST_LIMIT	5	航班列表展示数量
SEAT_LIST_LIMIT	5	每个航班展示的舱位数量

格式化函数

from scripts.formatter import (
    format_flight_list,     # 航班列表格式化
    format_seat_list,       # 舱位价格格式化
    format_order_result,    # 订单创建结果格式化
    format_baggage_info,    # 行李额格式化
    format_refund_rule,     # 退改规则格式化
    format_order_status     # 订单状态格式化
)

展示字段规范

航班列表必须包含：

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

舱位价格必须包含：

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

订单详情必须包含：

• 订单号、航班信息、舱位信息
• 票价明细（票价+机建+燃油）
• 行李额（托运+手提）
• [立即支付] 按钮

---

版本历史

版本	日期	变更说明
1.1.0	2026-03-25	新增格式化输出模块，固化展示逻辑
1.0.0	2026-03-25	合并酒店和机票技能包，统一鉴权流程