train

分贝通火车预订助手，实时查询火车票、展示车次列表、预订火车票、查看订单、取消订单。Invoke when user wants to search trains, book train tickets, check train orders, or cancel train bookings.

Security Scan

The skill's code, instructions, and network usage match its stated purpose (booking and managing train tickets via fenbeitong OpenAPI); nothing in the bundle indicates hidden or unrelated behavior.

Purpose & Capability

Name/description (train ticket search, booking, order management) align with the included Python modules and required python3 binary. The files implement calls to fenbeitong OpenAPI endpoints and formatting functions that are appropriate for the declared capabilities.

Instruction Scope

SKILL.md insists the agent call functions in scripts/fb_train_api.py and not fabricate results; instructions are specific about which API functions to call and what to display. There are no instructions to read unrelated local files, other environment variables, or to transmit data to endpoints other than the documented fenbeitong domains.

Install Mechanism

This is an instruction-only skill with bundled Python scripts and no install script or archive downloads. No third-party install URLs or extract operations are present; risk from install mechanism is low. It requires python3 to run, which is reasonable.

Credentials

The skill requests no environment variables or platform credentials, but the code contains a hard-coded X-App-Id and EMP_ID and will send user-provided PII (names, ID numbers, phone numbers) to https://openapiv2.fenbeitong.com and https://app-gate.fenbeitong.com. This data transmission is expected for booking but is a privacy consideration—ensure you trust the remote service and its data handling.

Persistence & Privilege

always:false and no code to modify other skills or system-wide agent settings. The skill does network I/O on demand but does not request elevated or persistent platform privileges.

Assessment

This skill appears to do what it claims: it will call fenbeitong OpenAPI endpoints to search trains, create/cancel orders, and return payment/view links. Before installing, be aware that you (or your users) will need to provide personal passenger information (name, national ID, phone) which the skill sends to external fenbeitong endpoints. The code includes a hard-coded X-App-Id and EMP_ID (no secret API key), so verify you trust fenbeitong's privacy and security practices. Also ensure python3 is available in the runtime. If you need tighter privacy or auditability, ask the author how passenger data is stored, logged, or transmitted, and whether requests can be routed through a service you control or audited.

分贝通火车预订助手 (fb-train-skill)

技能描述

分贝通火车预订助手，实时查询火车票、展示车次列表、预订火车票、查看订单、取消订单。

---

⚠️ 【重要约束】

• 必须调用 scripts/fb_train_api.py 中的函数获取数据
• 禁止自行编造车次信息、价格或余票
• 接口返回什么数据就展示什么，不要修改

---

技能概述

基于分贝通火车OpenAPI开发的自动化对接技能，支持火车票搜索、预订、取消、查询等全流程操作，适配国内火车票预订场景。

技能能力

核心能力

1. 火车票搜索：按出发站、到达站、日期查询车次列表
2. 车次详情查询：获取指定车次座位类型、价格、余票等信息
3. 预订火车票：创建火车票订单
4. 订单管理：查询订单详情、取消订单
5. 收银台支付：获取支付链接，引导用户完成支付

触发条件

1. 火车票搜索：当用户输入「火车票/订火车票/查火车票/高铁/动车」+ 出发地/目的地/日期信息时，必须调用 scripts/fb_train_api.py 中的 search_train_list() 函数

   • 返回车次列表，使用表格形式展示
   • 默认展示5个车次，用户可选择继续查看更多
   • 展示格式示例：

     🚄 北京南 → 上海虹桥（3月15日）
     
     | 序号 | 车次 | 出发时间 | 到达时间 | 历时 | 二等座 | 一等座 | 商务座 |
     |:---:|:---|:---:|:---:|:---:|:---:|:---:|:---:|
     | 1 | G1 | 09:00 | 13:28 | 4时28分 | ¥553 | ¥933 | ¥1748 |
     | 2 | G3 | 14:00 | 18:28 | 4时28分 | ¥553 | ¥933 | ¥1748 |
     
     💡 回复"序号"查看车次详情，如"1"查看第1个车次
     

2. 查看车次详情（序号）：用户回复"序号"查看车次座位详情

   • 必须调用 scripts/fb_train_api.py 中的 get_train_detail() 函数
   • 展示各座位类型的价格和余票
   • 展示格式示例：

     🚄 G1 北京南 → 上海虹桥
     📅 出发：3月15日 09:00 | 到达：3月15日 13:28
     ⏱️ 历时：4时28分
     
     | 座位类型 | 价格 | 余票 |
     |:---:|---:|:---:|
     | 二等座 | ¥553 | 有票 |
     | 一等座 | ¥933 | 5张 |
     | 商务座 | ¥1748 | 无票 |
     
     💡 回复"座位类型"预订，如"二等座"
     

3. 订单创建：用户选择座位类型后创建订单

   • 收集乘车人信息：姓名、身份证号、手机号
   • 调用创建订单接口，返回订单ID
   • 订单创建成功的展示内容：

     ✅ 订单创建成功！
     
     🚄 G1 北京南 → 上海虹桥
     📅 出发：3月15日 09:00
     🎫 座位：二等座
     💰 价格：¥553
     👤 乘车人：张三
     
     🔗 [立即支付](https://app-gate.fenbeitong.com/business/train/open/push/redirect?orderId={order_id}&isSkill=true&type=0)
     🔗 [查看订单详情](https://app-gate.fenbeitong.com/business/train/open/push/redirect?orderId={order_id}&isSkill=true&type=1)
     

4. 订单操作：用户发起取消/查询（需提供订单ID）

   • 取消订单：支持填写取消原因
   • 查询订单详情：展示订单完整信息

对接信息

基础配置

• 环境：线上环境
• 核心域名：https://openapiv2.fenbeitong.com
• X-App-Id：688c927d2cf90c6f0595571d（所有接口统一使用此App-Id）
• Content-Type：application/json

通用请求规则

1. 所有POST请求，参数为JSON格式
2. 日期格式：yyyy-MM-dd
3. 时间格式：HH:mm

核心接口列表

一、查询类接口

接口名称	接口地址	核心用途	必选参数
火车票搜索	/openapi/travel/train/search_list/v1	按出发站/到达站/日期查车次	from_station, to_station, travel_date
车次详情	/openapi/travel/train/detail/v1	查车次座位类型/价格/余票	train_no, travel_date
订单详情查询	/openapi/travel/train/order/detail/v1	查订单状态/信息	order_id

二、订单类接口

接口名称	接口地址	核心用途	必选参数
火车票下单	/openapi/travel/train/order/create/v1	创建火车票订单	train_no, travel_date, seat_type, passenger_info, contact_info
取消订单	/openapi/travel/train/order/cancel/v1	取消已创建的订单	order_id

三、收银台支付

接口名称	接口地址	核心用途
收银台支付	https://app-gate.fenbeitong.com/business/train/open/push/redirect?orderId={order_id}&isSkill=true&type=0	引导用户完成支付
查看订单详情	https://app-gate.fenbeitong.com/business/train/open/push/redirect?orderId={order_id}&isSkill=true&type=1	查看订单详情

枚举值说明

座位类型 (seat_type)

• 9：商务座
• 1：一等座
• 2：二等座
• 3：软卧
• 4：硬卧
• 5：软座
• 6：硬座
• 7：无座

订单状态 (order_status)

• 1：待支付
• 2：已支付
• 3：出票中
• 4：已出票
• 5：已取消
• 6：退票中
• 7：已退票

响应规则

成功响应

{
  "code": 0,
  "msg": "success",
  "data": {}
}

失败响应

{
  "code": 500,
  "msg": "错误信息",
  "data": {}
}