Vtrip AI 定制 · 行程生成
Vtrip AI 定制 搭载 VtripGPT 旅游垂类行业大模型，把海量官方与实时动态数据变成专属行程智囊：不只推荐路线，更给出靠谱出行方案；行程规划与详情页无缝衔接——通过「查看行程详情」进入完整日程与后续预订。
本 Skill 由湖南视旅科技有限公司提供。用户用自然语言描述出行需求，脚本调用视旅 vtrip_generate 接口生成行程（鉴权打包）。
- Markdown 模式：完整日程正文。
- WorkBuddy 模式：精简 markdown + HTML 路线总览（
show_widget）+ HTML 行程页（必须present_files）。
何时使用
- 行程定制、行程规划、自由行 / 定制游安排
- 「帮我规划…」「…三日游 / 五日游」「从 A 到 B 玩几天」
- 需要行程方案并顺带查看详情 / 打包清单
凭证
- 从
VTRIP_OPEN_API_KEY/config.json的apiKey读取。 - 没有 ApiKey：引导用户打开 https://open.visiotrip.com.cn/ 获取后配置
VTRIP_OPEN_API_KEY。 - 有 ApiKey：请求头只用
X-Api-Key。
Quick start
- 将用户需求整理为一句自然语言
query。 - 有
present_files（或show_widget）→ WorkBuddy 模式；否则 → Markdown 模式。 - 调用脚本前先向用户说明等待（生成约需 1–3 分钟）。固定话术（勿改写成「接口 / 请求 / 轮询」等技术表述）：
> 正在为您匹配景点、交通与住宿，行程方案大约 1–3 分钟后呈现，请稍候。 - 在 Skill 目录执行脚本，按「输出后处理」处理 stdout。
Markdown 模式
node scripts/itinerary-generate.js --query "<一句自然语言行程需求，尽量包含完整用户需求信息，关键参数（不是必须）：出发地、目的地、行程时间、游玩时间>"
WorkBuddy 模式
node scripts/itinerary-generate.js \
--query "<一句自然语言行程需求>" \
--render-mode workbuddy \
--output-dir "$PWD/outputs"
> 业务入参以 --query 为主。
输出后处理
Markdown 模式
- 将脚本行程正文 原样 作为回复（到 CTA 表格与客服支持为止，禁止截断/总结）。
- 保留 CTA markdown 表格中的链接，勿改 URL。
- 不要追加「还需要什么帮助」「可以继续问我」等引导下一轮问询的话术。
WorkBuddy 模式（硬性三步）
解析 WORKBUDDY_VISUAL_JSON_START / END 之间的 JSON 后，同一轮必须全部做完：
| 步 | 动作 | 是否必须 |
|---|---|---|
| 1 | 有 showWidget.widgetCodeFile：先 完整读取 该 HTML 文件，再 show_widget({ title, widget_code: 文件全文 })（禁止截断） |
推荐 |
| 2 | 将 markdown 原样作为文字回复 |
必须 |
| 3 | present_files({ files: presentFiles.files })（即 [htmlFilePath]） |
必须 |
HTML 行程文档依赖第 3 步。 脚本已写入本地 HTML；若不调用 present_files，用户看不到附件。
关键约束：
present_files绝不能省略，即使show_widget已成功或 widget 曾报错。show_widget≠ 交付完成；它只显示路线总览卡（HTML 片段）。- 本轮最后一个工具调用必须是
present_files。 - 优先使用 JSON 里的
presentFiles.files/presentFilesInstruction（绝对路径，勿改写）。 widget_code必须来自showWidget.widgetCodeFile文件全文（HTML）；stdout JSON 不再内嵌 widget，避免截断。- 禁止：只调
show_widget；禁止手写/改写 widget 与 markdown。
详见 references/workbuddy-contract.md。
硬性规则
- 无 ApiKey → 引导打开 https://open.visiotrip.com.cn/ 获取后配置
VTRIP_OPEN_API_KEY。 - 请求头只用
X-Api-Key；禁止自行传 Bearer / Host 前缀或编造 token。 - 禁止编造 URL——链只来自行程条目级
jump_url（内部字段jumpUrl，即「查看行程详情」）。 - CTA：markdown 表格仅
查看行程详情（与 HTML 一致）；勿输出「一键购买」行；勿追加引导下一轮问询的话术。 - WorkBuddy：有
htmlFilePath时必须present_files。 - 品牌：湖南视旅科技有限公司 · Vtrip AI 定制。
- 失败时不编造行程（见 references/error-handling.md）。
参考文档
| 文档 | 内容 |
|---|---|
| references/api-adapter.md | 端点、鉴权头、响应包络、请求 body |
| references/output-format.md | Markdown 完整/精简格式 |
| references/workbuddy-contract.md | show_widget + present_files |
| references/error-handling.md | 错误处理 |
设计 spec：docs/superpowers/specs/2026-08-12-vtrip-ai-itinerary-design.md
