Vtrip 商旅 · 火车订单服务

本 Skill 由湖南视旅科技有限公司提供。通过 开放 SSO 提供火车票 订单服务（查询 + 状态解读 + 下一步），而非仅丢列表：

• 最近订单：列出最近若干条火车票订单（默认 5 条）
• 按单号：按 orderId 查询单笔火车票订单详情

Skill 只调用智能体平台公布的接口；不调用开放平台 resolve、业务 /token，不持有 secret。响应可含 jumpUrl，须原样展示。

回复方式（服务，非裸查）

1. 跑脚本拿到 stdout Markdown（订单字段以接口为准）。
2. 用一两句话摘要：关键状态、车次与出行日、金额（仅当接口有值）。
3. 给出 可执行下一步（如点击详情、携带单号咨询变更）。
4. jumpUrl 原样保留为链接；禁止编造单号、状态、金额或链接。

何时使用

• 「查火车票订单」「我的火车票订单」「最近订了哪些火车票」「火车订单服务」
• 「火车票订单号 9876543210123」「查一下这个火车单」

凭证（ApiKey）

1. 从上下文 / 环境变量 VTRIP_OPEN_API_KEY / 本目录 config.json 的 apiKey 读取客户 ApiKey。
2. 没有 ApiKey：不要调平台。向用户说明需先到开放平台申请，并给出申请链接（见 references/open-sso.md）。申请成功写入上下文后重试。
3. 有 ApiKey：请求头只用 X-Api-Key（禁止把 ApiKey 放进 Authorization: Bearer）。

Quick start

在 Skill 目录执行（需配置 VTRIP_OPEN_API_KEY 或本目录 config.json）。

最近火车票订单

node scripts/list-orders.js --limit 5

按单号查询

node scripts/get-order.js --order-id 9876543210123

将脚本 stdout 作为唯一事实来源；在其上做服务式摘要与下一步。失败时回传脚本错误信息，禁止编造订单内容或链接。

硬性规则

1. 无 ApiKey → 引导申请；有 Key → 只调 POST /api/vtrip/user-order/query。
2. 请求 body 固定 orderType: 4（火车票）；不得改为酒店/机票等其它品类。
3. channelCode 固定 ai_business_trip（平台 ApiKey 路径强制，勿改成其它渠道）。
4. 禁止编造单号、状态、金额或 jumpUrl。
5. 不接收、不打印、不回传 secret；不调 resolve / token。
6. 有 jumpUrl 时 Markdown 输出 [查看详情](url)；无则省略链接行。

参考

实现计划：docs/superpowers/plans/2026-09-12-business-travel-query-skills.md（仓库根）
渠道标准：docs/architecture/channel-code.md