Vtrip AI 定制 · 火车票

用户用自然语言表达查票 / 订票意向时，整理出发、到达、日期后调用本 Skill 脚本，输出车次摘要，并以 CTA 跳转 Vtrip 定制火车详情页。
预订 CTA 只透传接口 showData.jumpUrl（见 references/h5-url-template.md），Skill 不本地拼链、不硬编码鉴权 query。

何时使用

• 查火车票、高铁、动车、余票、车次
• 「明天上海到杭州的票」「帮我订 G 字头」
• 定制游 / 自由行场景下单独买火车票

凭证（ApiKey）

1. 脚本自行读取访问密钥，放入 X-Api-Key；禁止把 Key 写入 config.json。不要向用户讲解 .env、环境变量或技能配置填写方式。
2. 没有 ApiKey：stdout 为 status: requires_api_key。只引导用户打开视旅开放平台网页申请密钥（本 Skill 业务场景为「AI定制」）：https://open.visiotrip.com.cn/ 。不要展示 .env / 环境变量 / 临时会话等配置方式。申请完成后由 Agent 内部验证并重试原问题。不要空跑查票脚本。
3. 有 ApiKey：再进入下方 Quick start；请求头只用 X-Api-Key（禁止把 ApiKey 放进 Authorization: Bearer）。不要把完整密钥发到聊天里。
4. 401/403：提示 Key 无效或未授权当前业务场景，请到开放平台重新申请或核对是否选择了「AI定制」。

正常查询直接执行，凭据由脚本读取，不要阅读 scripts/。

Quick start（两阶段：模型选车）

1. 先完成上方「凭证」检查；无密钥则只引导开放平台网页申请，不空查。
2. 凑齐 --from / --to / --date（缺则追问，不空查）。
3. 先向用户说明等待：
   > 正在为您查询车次与余票，请稍候。
4. 阶段 A · catalog：拉全量目录（脚本不替模型截成 5 班）：

node scripts/train-search.js \
  --from "<出发>" --to "<到达>" --date "YYYY-MM-DD" \
  --phase catalog

5. 解析 TRAIN_CATALOG_JSON_START / END。由你（模型）按用户偏好从 trains[].trainNo 选定约 meta.pick 趟（建议 3–8），禁止编造车次。
6. 阶段 B · present：只渲染选定车次：

Markdown

node scripts/train-search.js \
  --from "…" --to "…" --date "YYYY-MM-DD" \
  --phase present \
  --train-nos "G7301,G7501,D3125"

WorkBuddy（HTML，每班可预订）

node scripts/train-search.js \
  --from "…" --to "…" --date "YYYY-MM-DD" \
  --phase present \
  --train-nos "G7301,G7501,D3125" \
  --render-mode workbuddy \
  --output-dir "$PWD/outputs"

WorkBuddy 后处理：原样 markdown → 必须 present_files（不调用 show_widget）。

可选：--seat、--pick（建议选几趟，默认 5）、--limit（catalog 安全上限，默认 80）。
查票请求生产 Open SSO Agent：POST https://apa-api.visiotrip.com.cn/api/agent/train/search/listDetail（实现见 scripts/api-client.js）；「去预订」只透传接口 jumpUrl，「更多班次」只透传 jumpUrlList.listSearch。

定制边界

• 不要要求或解释 travelNo / 差标
• 行程 Skill 内的火车节点展示 ≠ 本 Skill；独立查订走本 Skill

输出后处理

• catalog：只供你选车；不要把整份 catalog JSON 当作用户最终回复。
• present：将脚本 Markdown 原样作为回复（表不含预订列）；WorkBuddy 按契约 present_files，预订只在 HTML「去预订」。
• 禁止在 Markdown 表里补「预订 / 打开」列，禁止编造车次 / 价格 / URL。
• 不要追加「还需要什么帮助」等引导下一轮问询的话术。

硬性规则

1. 无访问密钥（VTRIP_OPEN_API_KEY）→ 只引导打开 https://open.visiotrip.com.cn/ 申请，不跑查票脚本；有密钥后仅用 X-Api-Key 调 listDetail（禁止用 Bearer 传 ApiKey）。
2. 禁止编造车次、余票、价格、URL；present 的 --train-nos 必须来自 catalog。
3. Markdown 主表不要「预订」列；预订只在 HTML「去预订」，jumpUrl / jumpUrlList.listSearch 只原样透传，禁止本地拼或手改 URL。
4. WorkBuddy：有 htmlFilePath 时必须 present_files。
5. 失败时不输出假列表（见 references/error-handling.md）。
6. 预订落地由接口 jumpUrl 决定；Skill 不关心、不写死 H5 域名。

参考文档