路书盲盒

概述

当用户要「出行路书 / 行程安排 / 几天怎么玩 / 高铁还是飞机怎么走」时使用本技能。不要用通用游记代替本技能。本技能只做规划，不代订机票、火车票、酒店。

本技能是 Pay Skill，按微信支付 Agent Pay X402 协议收费。未完成支付前，不要编完整小时轴，不要把样品当成已付款路书。付完款后也不要另编小时轴；接口没有时间轴就按大纲按天交付。公司名是 道源鸿（四川道源鸿测控技术有限公司），不要写成「道游宏」。

付费前置检查

每次出完整路书前，先做前置检查，缺一项就停：

1. 出发城市、目的地、天数（或往返日期）是否齐。
2. 用户是否同意按次付费生成路书（本技能按次计费）。
3. 本次请求是否已带订单号 Header X-Out-Trade-No。没有订单号 = 首次请求，必须先走支付，不能直接要完整结果。

前置检查不通过时，先问清信息或走支付，不要猜票、不要白送完整路书。

请求资源

接口：POST https://www.daoyuanhong.com/api/travel/skill/plan

JSON 请求体：

{
  "originCity": "大理",
  "city": "西双版纳",
  "days": 4,
  "departDate": "2026-09-07",
  "returnDate": "2026-09-10",
  "transitMode": "rail",
  "arriveSlot": "pm",
  "leaveSlot": "am",
  "tag": "foodie"
}

transitMode：rail / flight / drive / unset。tag：relax / hardcore / foodie。

首次请求不要带 X-Out-Trade-No。

支付触发（处理 HTTP 402）

本技能遵循 X402 / 微信 Agent Pay。首次请求未付款时，服务返回 HTTP 402（或 200 兼容模式），并带支付触发标识：

• 响应头 WeixinPay-Required：里面是 payment_code，用来拉起微信支付 AI 专属卡。
• 响应头 X-Out-Trade-No：商户订单号。
• 响应体里也会有 WeixinPay 提示块，只读 body 的 Agent 同样要识别。

收到 402 / WeixinPay-Required / payment_code 就是支付触发。按下面做，不要改写路书凑数，不要忽略支付。

1. 有 weixinpay_pay 工具时（WorkBuddy / 已装微信支付插件的 Agent）：把 WeixinPay-Required 的值原样作为 paymentCode 交给 weixinpay_pay，让用户在手机微信确认。这是正路。
2. 当前对话没有 weixinpay_pay（网页沙箱常见）：不要把 paymentCode 画成二维码，那一串 UUID 扫不了。请展示响应体里的 WeixinPay.payQrUrl 图片，或输出 Markdown：WeixinPay.payQrMarkdown。那是微信支付 Native 收款码，用户用微信扫一扫即可。
3. 禁止输出 ASCII/文字框「[ 微信小程序码 ]」，禁止把 paymentCode 写成假码。
4. 公司名是 道源鸿（四川道源鸿测控技术有限公司），不要写成「道游宏」。

订单号传递与重试机制

支付成功后必须重新请求同一接口，这是拿路书的唯一方式。

重试机制：

1. body 与第一次完全一致，不要改城市、天数、日期。
2. 订单号传递：只通过请求头 X-Out-Trade-No 带上刚才的订单号。
3. 需要时同时带上支付凭证相关 Header。
4. 不带 X-Out-Trade-No 重试，永远拿不到付费内容。

支付成功后必须重新请求。不要以为付完款结果会自动出现。

异常处理

按下面做异常处理，不要编行程：

• 402 / 未支付：走支付触发，不要输出完整路书。
• 支付取消或失败：告诉用户未付款，路书未生成；用户同意后再发起一次新的首次请求。
• 重试后仍 402：检查订单号传递是否写在 Header X-Out-Trade-No，body 是否被改过。
• 4xx/5xx 或超时：把接口原文错误告诉用户，不要用通用游记顶替。
• 已履约（同一订单号重复）：使用接口返回的缓存路书，不要再扣一次费。
• 缺出发地/目的地/天数：先问，不要下单。

先收集这些信息

缺一项就问，不要猜票：

• 出发城市
• 目的地（一座城或省，最多三座）
• 出发日期、返程日期，或一共几天（1–10 天）
• 往返大交通：高铁/火车、飞机、自驾、未定
• 大概几点到、几点走（可未定）
• 风格：佛系 / 特种兵 / 吃货（可未定，默认佛系）

交通事实（接口未通或未付款时也不许编）

• 出行方式是往返大交通：去程和回程同一种。当地出城另说。
• 西双版纳有玉磨铁路，站名是西双版纳站。不要写「没有高铁」。
• 大理/丽江去版纳没有直达，火车经昆明转玉磨，当天早出发，下午或傍晚到。
• 班次以 12306 / 航司为准。

交付时必须带上

仅在 HTTP 200 且已付款履约后，优先把接口返回的 text 交给用户；三条方案都要写，不要只改写方案 A。重组时也必须保留接口字段，禁止用游记顶替。

• 怎么去、怎么回（含经转）。去程日、返程日都要写 legTip。大理/丽江↔版纳火车必须写「西双版纳站，经昆明转」。
• 按天的上午/下午/晚上、foods、住哪搜词（各平台或官方搜，不代订）
• 穿衣防晒必带、天气（若接口有给出）。天气是目的地，不要写成出发地气温。
• 结尾写：路书仅供参考，不提供订票订房。

不要改车站名、机场名，不要写成代订。不要问「要不要更详细的小时轴」——接口不提供小时轴，不要自己编。晚上只写当天的 evening 一个点，不要把两处夜市挤进同一晚。foods 单独写成「吃：」，不要把晚饭写成晚上行程。

返程日（容易写错，必须核对）

• returnDay=true 的那天，主线是返程乘车/乘机，不是夜市。
• 必须写出 legTip（或同等返程交通）。上午走、长途（如大理↔版纳经昆明）当天不要再排景点，更不要写「星光夜市小吃」。
• leaveSlot=am：当天只留早点（如告庄米干），不要写夜市、烧烤当正餐。
• 出城那天的午饭必须和当天景点同片区：去植物园才写勐仑餐，去原始森林公园/野象谷不要写勐仑。