出去玩旅游攻略 Agent 开发任务清单

项目 内容
版本 1.0
日期与时区 2026 年 10 月 12 日,Asia/Shanghai
依据 旅游攻略 Agent 技术方案
状态 待实施;本轮仅创建任务文档
任务数量 34 项,按依赖和建议执行顺序编号
实施主线 后端现有 007 的 T002、T003、T004
首条业务验收 西安到成都,两天一晚,两人合计 2000 元,轻松游

本清单把技术方案落实为可以逐项开发、审查和验收的工作。编号 GT-001 至 GT-034 是本清单的跨项目引用编号,不覆盖现有 007 任务编号,不代表已经批准实施或完成。正式开工先完成 GT-001,将对应工作纳入现有 spec、plan、tasks;本轮不修改这些文件或勾选任何既有任务。

1 执行规则

  1. 默认按编号顺序实施,每次只执行当前明确的一项任务;前置项验收通过后进入下一项。
  2. 前端负责规划、评分、费用和时间规则;后端负责模型、资源查询、证据、执行控制和存档接口,不搬迁规划引擎。
  3. 每项先准备有意义的验收场景,再实现和验证。只涉及文档的任务检查文档,不为其运行全部代码构建。
  4. 离线规则、供应商真实查询、真实模型、真实云存档和手机分别记录结果,不能相互替代。
  5. 真实、付费调用和部署属于后续独立执行步骤。本清单不增加历史测试额度,不触发真实服务或发布。
  6. 技术方案中的 200 秒总截止、2 次模型调用、32 次资源请求、12 条路线边等是待验证策略;落地时明确统计单位,不能把每个子接口的限额分别重复发放。
  7. Demo、参考、核验通过三种结果保持可识别;不得通过放松约束或补假数据提高成功率。
  8. 失败、取消、过期和迟到结果不得留下条件、偏好或攻略的部分修改;不自动重试付费执行。

本文的“新增”文件均为计划,不是已存在的文件;“修改”路径指现有源码。测试脚本名称标记为拟新增时,实施该项时再建立入口,不假装当前已有可执行命令。

2 顺序总览

顺序 任务 主要负责侧 必须前置 交付
01 GT-001 落实规格与验收口径 两端文档 无 生效的实施范围及细分任务
02 GT-002 建立共享契约与能力协商 两端 GT-001 资源、候选、报告和新协议
03 GT-003 建立固定夹具与基线 两端测试 GT-002 可回放输入和预期
04 GT-004 需求口径与日期规范化 前端为主、后端边界 GT-002、GT-003 正确的本次旅行条件
05 GT-005 后端存档版本保护 后端 GT-002、GT-003 V1/V2 接受规则和防降级覆盖
06 GT-006 资源运行仓储与迁移 后端 GT-002、GT-003 持久去重、快照和阶段记录
07 GT-007 操作期限与阶段控制 后端 GT-006 有界执行元数据
08 GT-008 抽取 FlyAI 执行器 后端 GT-002、GT-003 可复用固定命令执行
09 GT-009 地点查询与证据规范化 后端 GT-008 全国即时地点候选
10 GT-010 往返火车查询 后端 GT-008 日期匹配的交通选项
11 GT-011 酒店查询与报价口径 后端 GT-008 有条件的住宿选项
12 GT-012 地区与地图实体匹配 后端 GT-009 唯一实体和同源坐标
13 GT-013 地图路线查询 后端 GT-012 关键交通边
14 GT-014 天气覆盖查询 后端 GT-012 覆盖范围明确的预报
15 GT-015 营业预约依据 后端为主、内容配置 GT-009、GT-012 有来源的场所规则或缺项
16 GT-016 资源服务和 HTTP 接线 后端 GT-007、GT-009 至 GT-015 实际查询 API
17 GT-017 前端资源客户端 前端 GT-004、GT-016 能力、启动、轮询和取消
18 GT-018 模型两阶段与证据接线 后端、两端协议 GT-004、GT-007、GT-016 真实使用资源的候选输出
19 GT-019 完整费用账本 前端 GT-002、GT-003、GT-004 预算及差额计算
20 GT-020 路线编排与接驳节点 前端 GT-012、GT-013、GT-019 可计算的活动与交通安排
21 GT-021 统一校验与结果状态 前端、共享纯规则 GT-015、GT-019、GT-020 校验报告和状态派生
22 GT-022 有界修复与方案比较 前端 GT-021 推荐与真实差异
23 GT-023 全流程协调器 前端 GT-017、GT-018、GT-022 暂存至校验的完整流程
24 GT-024 原子提交与失效保护 前端 GT-023 单事件提交及取消保护
25 GT-025 V2 存档与恢复重验 前端、后端联调 GT-005、GT-024 新旧存档正确恢复
26 GT-026 攻略与证据展示 前端 GT-021、GT-025 完整攻略卡片
27 GT-027 修改后的局部重算 前端、后端查询 GT-024、GT-025、GT-026 继续修改而不重填
28 GT-028 运行记录与评测扩展 两端 GT-016、GT-018、GT-027 可解释的质量与成本报告
29 GT-029 离线完整链验收 两端测试 GT-025 至 GT-028 开启真实调用前的候选
30 GT-030 供应商实际接入验证 后端、环境 GT-029、对应供应商条件 当前账号的真实响应证据
31 GT-031 真实模型与规则联合验收 两端测试 GT-030 当前模型效果和约束结果
32 GT-032 云端受控发布准备与验证 两端、环境 GT-005、GT-031 新能力受控可用的环境
33 GT-033 手机与云保存端到端验收 两端测试 GT-032 真实完整用户流程
34 GT-034 发布判定与兼容回滚 两端、环境 GT-033 发布证据、开关及回滚候选

表中顺序是默认串行执行路径。独立开发者可以在已通过的同一契约上协调独立模块,但不改变前置和验收要求,不由本文自动启动并行 Agent。

3 阶段验收门槛

门槛 覆盖任务 必须成立 不代表
G0 契约与兼容 GT-001 至 GT-007 需求口径明确、两端契约一致、版本和运行控制可测 已接真实供应商
G1 离线资源 GT-008 至 GT-018 生产接线可用,所有资源类型支持成功、缺项、失败 当前账号和模型效果通过
G2 规划规则 GT-019 至 GT-022 金额、时间、选择和强度规则有准确结果 页面链路或实时价格可用
G3 完整离线产品 GT-023 至 GT-029 生成、修改、取消、保存恢复一致 真实模型、云端或手机通过
G4 当前真实数据与模型 GT-030 至 GT-031 当前账号查询和模型输出分别有证据 已部署或手机通过
G5 发布验收 GT-032 至 GT-034 当前两端候选、云保存和手机实际流程通过 全国所有旅行均可核验

高德或 FlyAI 暂缺有效配置时,相关离线实现可完成;对应真实能力必须标为未配置或未验证。可交付参考攻略,但不能勾选“路线已核验”或“报价可预订”。

4 任务详情

GT-001 落实规格与验收口径

  • 状态:待实施。

前置: 无。对应主线: 007 T002/T003/T004 前置。

前端 后端
后续新增 docs/GROUNDED-TRAVEL-IMPLEMENTATION.md,记录实现范围与技术方案映射 后续修改 specs/007-grounded-travel/spec.md、plan.md、tasks.md;新增或完善 contracts 和 verification 文档

具体工作: 冻结首版不超过三天、单目的地、单住宿区域的核验范围;明确参考攻略和核验通过条件;确定日期、预算和房型澄清;列出新协议、V2 存档和开关。将本文编号映射到 007 的细分任务,保留历史完成记录。

验收: 逐项对照现有宪章、产品范围和技术方案,确认规划引擎留前端、普通查询不修改管理采用资料、不增加每日聊天封顶、不自动付费重试。确认旧客户端防覆盖、报价缺项降级和第三方内容使用条件都有明确任务。交付一份可逐项勾选的实施映射,不写业务代码。

GT-002 建立共享契约与能力协商

  • 状态:待实施。

前置: GT-001。对应主线: T002/T003。

前端 后端
新增 src/contracts/groundedTravel.ts、src/types/groundedTravel.ts;修改 src/contracts/tripConversation.ts 与相关公开文本边界 新增 src/domain/travelResources.ts、src/application/ports/travelResources.ts;同步纯协议至 src/domain/groundedTravel.ts,修改对话与校验协议

具体工作: 定义规范化需求、资源选项、证据、实体、PlanCandidate、账本、路线、报告及状态;定义 planningSupport、planningPhase、operationId 和 bundle 引用;补完整 JSON Schema 和运行时验证。新地点和计划 ID 使用独立类型,不直接扩塞旧 CityId/TravelPlanId 枚举;明确投票和旧方案字段兼容。

验收: 合法夹具通过;额外字段、非法日期、浮点金额、未知 ID、混币、超量数组拒绝;quoted 必须有资源和证据引用,unknown 金额保持 null。旧协议不返回新分支。拟新增 scripts/test-grounded-travel-contract.cjs 和 tests/groundedTravelContract.test.ts;纯协议一致性检查通过。

GT-003 建立固定夹具与基线

  • 状态:待实施。

前置: GT-002。对应主线: T002/T003 测试基础。

前端 后端
新增 fixtures/grounded-travel/,含需求、候选、路线、费用、期望状态和恢复样本 新增 tests/fixtures/travelResources.ts,保留历史供应商响应并明确日期和来源等级

具体工作: 冻结本例时钟为 2026-10-12、时区 Asia/Shanghai;建立 10 月 17—18 日预算夹具、假设报价完整夹具和真实数据缺项夹具。所有数据标为人工或历史样本,分别准备 provisional、verified 计算条件和 infeasible 场景。

验收: 基线占用 200000 分;票价变化 206000 分;酒店变化 211000 分;同时变化 217000 分。夹具不使用真实用户身份或密钥;未来真实测试使用当时有效日期,不把冻结日期当当天行情。固定样本回放稳定,测试不访问外部服务。

GT-004 需求口径与日期规范化

  • 状态:待实施。

前置: GT-002、GT-003。对应主线: T003。

前端 后端
修改 src/types/tripRequirement.ts、src/services/requirementParser.ts、requirementFlow.ts;新增 src/services/planningRequest.ts;接 useTripSession.tsx 的暂存需求 修改对话输入边界,提供受控时钟和时区上下文;不把客户端日期当服务端执行截止

具体工作: 明确总预算与人均预算、包含范围、房间和房型、住宿日期、出返程偏好、假设及确认状态;人均预算随人数重算。解析相对日期时形成候选并必要确认,探索不强迫补齐查价字段。

验收: 技术方案 Q01—Q04 全部通过;周末候选正确,周六或周日输入需消歧;非法日期拒绝。两人不被无条件当情侣或两名成人;未知预算口径不得标预算已满足。旧字段与新规范化总额一致,未提到的条件保持。拟新增 scripts/test-planning-request.cjs。

GT-005 后端存档版本保护

  • 状态:待实施。

前置: GT-002、GT-003。对应主线: T003 兼容前置。

前端 后端
准备 V1/V2 请求样本及旧客户端覆盖样本,本项不接新保存入口 修改 src/domain/trip.ts、src/modules/trips/service.ts、src/application/ports/tripRepository.ts、src/infra/db/tripRepository.ts;涉及接口行为时更新 trips 契约

具体工作: 定义支持的存档版本和信封大小;防止已保存 V2 被 V1 提交降级覆盖。当前后端接受正整数 schemaVersion 并主要做信封校验,不能仅放宽类型就宣称安全兼容。格式保护在读取当前记录与写入的同一事务边界中完成,避免并发绕过。

验收: V1 正常读写;V2 合法信封可读写;不支持版本拒绝;V2 已存在时 V1 保存不删除新字段;并发 V1/V2 写入同样受格式保护。同版本仍保持最后成功写入覆盖,不把 serverVersion 变为乐观锁前提。身份、归属、软删除及投票规则回归通过。新增存档版本专项测试与真实隔离 MySQL 用例。

GT-006 资源运行仓储与迁移

  • 状态:待实施。

前置: GT-002、GT-003。对应主线: T002。

前端 后端
无运行代码改动 新增 src/infra/db/travelPlanningRunRepository.ts、travelResourceRepository.ts 和迁移;落实运行及资源仓储端口

具体工作: 建立 travel_planning_runs、travel_resource_requests、travel_resource_snapshots;保存 owner、哈希、固定截止、阶段、领取状态、快照有效期与枚举错误。迁移编号按实际仓库分配,不预占已经存在的编号。存储最小白名单数据,不拆 Trip 业务正文关系表。

验收: 隔离 MySQL 5.7 新库与重复迁移通过;同 owner 同请求同内容重放,异内容冲突;跨 owner 不可读;双实例只能领取一次;未知和过期不复活。快照正文到期不可读取,清理保留必要去重元数据。拟新增 tests/integration/travelResources.mysql.test.ts,只接受隔离测试库入口,不读取业务库配置。

GT-007 操作期限与阶段控制

  • 状态:待实施。

前置: GT-006。对应主线: T002/T003。

前端 后端
无页面接入,提供阶段顺序夹具 新增 src/modules/travelPlanningRuns/service.ts、httpRouter.ts 与 src/config/travelResources.ts;修改 env、composition 和 HTTP 组装

具体工作: 实现操作创建、阶段凭据、固定截止与剩余预算;共享模型调用次数、资源请求次数和路线边计数,包含跨阶段及跨实例。能力接口明确配置与验证状态;开关缺省关闭。复用当前单用户在途保护,避免 AI 请求和资源操作各自允许一份并发而叠加执行。

明确操作与子阶段的领取关系:同一 operation 的合法 AI 和资源阶段可以顺序执行,不能因为操作已占在途状态就互相拒绝;另一个 operation 或不属于本操作的旧 AI 请求仍被保护。所有阶段用同一持久归属和截止,不重复领取一份独立用户租约。

验收: 虚拟时钟测试证明轮询不续期;模型最多两次、外部请求最多32次、路线最多12条按整操作计数;越阶段、错误 inputHash、跨 owner 和过期拒绝。同操作子阶段不死锁,跨实例另操作不能并发绕过,旧 AI 与新工作流同时启动只取得允许的一份执行权。重复启动不新增调用。崩溃后不自动重新执行;关闭新开关保持旧 AI 与目录行为。拟新增 tests/travelPlanningRuns.test.ts。

GT-008 抽取 FlyAI 执行器

  • 状态:待实施。

前置: GT-002、GT-003。对应主线: T002。

前端 后端
无 新增 src/infra/flyai/commandRunner.ts,重用或调整 placeDetailsProvider.ts 的通用执行部分

具体工作: 保留固定 Node/包入口、参数数组、最小环境、取消、超时、输出大小和错误归类。只允许 POI、火车、酒店固定命令,具体参数由类型化解析器构造。

验收: 假进程验证成功、退出失败、超时、取消、超大输出、乱码与污染;无 shell,无任意命令或额外选项。原单点管理查询与开关语义回归不变;缺 Key 零进程启动。保留 tests/flyaiProvider.test.ts 并新增 runner 专项测试,不执行真实 CLI。

GT-009 地点查询与证据规范化

  • 状态:待实施。

前置: GT-008。对应主线: T002。

前端 后端
无页面改动,按共享契约消费夹具 新增 src/infra/flyai/travelResourceProvider.ts 的 POI 分支;复用公开资料读取端口;新增资源规范化纯规则

具体工作: 支持城市加关键词或主题的有界探索,保留实体 ID、地址、来源、采集时间和缺项。catalog_adopted 与 provider_query 分开;即时结果不自动发布到管理目录。

验收: 无关键词城市探索按支持契约执行;空结果、错城、同名歧义、缺地址、缺票价和污染文本正确处理。资料读取仍过滤禁用、删除、待审和过期。未知城市不能带旧城市依据。拟新增 tests/travelPlaceProvider.test.ts。

GT-010 往返火车查询

  • 状态:待实施。

前置: GT-008。对应主线: T002。

前端 后端
无页面改动 扩展 travelResourceProvider.ts 的 train 分支与资源报价解析

具体工作: 去回程分别查询;解析正确车站、日期时间、席别、价字段及计费口径;时长单位严格处理。quantity 为空保持 unknown,不外推儿童价。

验收: 对价格字段 price/adultPrice 的支持格式分别测试;人民币符号、纯数字、无单位时长、空价格、错日期、跨午夜和少于人数的库存有明确结果。不能把西安北与西安东混用。GT-003 历史样本只验证解析,不代表当前可售。拟新增 tests/travelTrainProvider.test.ts。

GT-011 酒店查询与报价口径

  • 状态:待实施。

前置: GT-008。对应主线: T002。

前端 后端
无页面改动 扩展 travelResourceProvider.ts 的 hotel 分支、价格范围与房型条件投影

具体工作: 保留入离日期、晚数、房间数、入住人数、房型、税费及总价范围;展示起价只能作为 reference。供应商没有完整房型或库存字段时保留限制说明。

验收: 一房一晚不乘两人;两房和多晚正确;退房不晚于入住时拒绝;无窗大床起价不能证明有窗双床满足。税费或多晚口径未知不升级 quoted;库存未知不声称可预订。拟新增 tests/travelHotelProvider.test.ts。

GT-012 地区与地图实体匹配

  • 状态:待实施。

前置: GT-009。对应主线: T002。

前端 后端
无实际地图展示 新增 src/infra/amap/travelResourceProvider.ts 的行政区和 POI 分支、实体匹配纯规则

具体工作: 按城市、行政编码、名称和地址匹配;保留 adcode/citycode 字符串、目录/供应商/地图 ID 与坐标系。限定查询主机和参数,不接受用户任意 URL。

验收: 技术方案 R02、R03 通过;同名多候选返回 ambiguous;地区中心点不是景点入口;坐标顺序、范围及不同坐标系检查正确。只有唯一匹配实体才进入真实路线查询。缺 Key 或接口权限未知不冒充已匹配。拟新增 tests/amapEntityProvider.test.ts。

GT-013 地图路线查询

  • 状态:待实施。

前置: GT-012。对应主线: T002。

前端 后端
提供活动与交通边夹具,暂不排最终路线 扩展高德 provider 的步行、公交和必要驾车分支;交通结果规范化

具体工作: 查询已匹配实体之间的路线,保留米、秒、步行、换乘和费用状态;按本操作去重同一条件的边;未来时段不能保证的字段保留范围。

验收: 缺 cost/耗时字段不转零;字符串数值和单位正确;公交城市码使用正确;路线无结果、超时、取消与错误主机被处理。路线边计数受 GT-007 控制,重复边不重复请求。拟新增 tests/amapRouteProvider.test.ts。

GT-014 天气覆盖查询

  • 状态:待实施。

前置: GT-012。对应主线: T002。

前端 后端
准备覆盖与未覆盖旅行日期夹具 扩展高德 provider 的天气分支

具体工作: 保存 reporttime、城市和逐项预报日期,仅对覆盖日期提供天气依据;不承诺任意远期天气。

验收: 正确使用行政编码;跨日、远期未覆盖、缺温度和错误字段不推断;只有命中旅行日期的预报才影响天气建议。未覆盖时可显示通用雨天替代,不自动改变路线。拟新增 tests/amapWeatherProvider.test.ts。

GT-015 营业预约依据

  • 状态:待实施。

前置: GT-009、GT-012。对应主线: T002/T003。

前端 后端
复用成都场景和替代配置作为体验增强,不冒充实时营业 新增 src/application/ports/venueRules.ts 和 src/modules/travelResources/venueRules.ts;绑定官方或授权证据

具体工作: 为首条路线所需场所建立适用日、开闭时间、最晚入场、预约规则和内部步行依据;以有限场所和来源落实,不虚构全国营业接口。动态字段缺失时输出 unknown。

验收: 官方临时关闭优先于旧攻略;源日期与适用日期分开;缺内部步行、票价或预约时间不补零或“无需预约”。“免费公共街区”与其中付费体验分开。完整、过期和缺项夹具均通过;真实内容使用条件留记录。

GT-016 资源服务和 HTTP 接线

  • 状态:待实施。

前置: GT-007、GT-009 至 GT-015。对应主线: T002。

前端 后端
本项尚不切换页面入口 新增 src/modules/travelResources/service.ts、httpRouter.ts;修改 composition.ts、interfaces/http/createHttpApp.ts 和配置

具体工作: 接通 capabilities、resources/start 和 requests GET;生产组装实际使用供应商端口和数据库仓储。批次有限并发、独立错误、缓存有效期和公共字段投影;只读 GET 不刷新、不续租、不调用供应商。

验收: HTTP 到 production composition 到供应商替身的全路径成立;A/B/C 批次依赖正确。缓存命中不改 fetchedAt,过期不强行 current。开关关闭和无配置零外部请求;鉴权、跨 owner、同请求重放、超限和部分失败通过。拟新增 tests/travelResources.test.ts 与接口测试。

GT-017 前端资源客户端

  • 状态:待实施。

前置: GT-004、GT-016。对应主线: T003。

前端 后端
新增 src/services/backends/travelResources.ts;复用 cloudContainer.ts、身份与有界轮询;新增能力读取与缓存 核对 GT-016 接口,若需修正只修改资源契约及对应处理,不加第二套接口

具体工作: 能力查询、操作创建、一次 POST 启动和串行 GET 读取;校验 owner 不由客户端自报,编号、阶段、输入哈希和响应结构正确。控制整工作流截止与单次传输,不把超时变成再次 POST。

验收: 虚拟运输证明同阶段一次启动、GET 零供应商调用;超时、离页、取消、改条件和跨请求结果都不能应用。缺能力保留原对话。请求 UTF-8 字节和公开字段边界通过。拟新增 scripts/test-travel-resources-client.cjs。

GT-018 模型两阶段与证据接线

  • 状态:待实施。

前置: GT-004、GT-007、GT-016。对应主线: T003。

前端 后端
同步 planning_intent/plan_candidate 协商与回复预检查;修改 src/services/tripConversation.ts 和纯契约 修改 src/domain/tripConversation.ts、conversationValidation.ts、src/infra/ai/bailianConversation.ts、src/modules/tripConversation/service.ts 与内部 control 端口

具体工作: intent 只提稀疏补丁;compose 按 owner、operation 和 inputHash 加载资源,并将白名单事实送入模型。模型只能引用可用 ID、选择候选和提出体验,不赋予 quoted 或 verified。旧协议保留原分支,非空 tool_calls 仍拒绝。

验收: fetch 替身捕获实际模型请求,确认有本轮服务端资源且没有密钥、后台审计或污染指令。伪造客户端证据、跨 owner bundle、错日期与过期拒绝或明确降级。旧协议无扩展字段;未知 ID 和超上限拒绝,内部失败原因细分。没有实体时进入参考草案路径,不造 ID。运输、流式与旧资料接线回归通过。

GT-019 完整费用账本

  • 状态:待实施。

前置: GT-002、GT-003、GT-004。对应主线: T003。

前端 后端
新增 src/services/travelBudget.ts;扩展费用展示适配,不把新账本直接塞进旧三项 Demo 计算 不加入费用规划算法;资源报价接口提供必要条件

具体工作: 交通、住宿、餐饮、当地交通、门票、体验和其他费用,机动资金独立;计费单位、包含关系、整数分、报价状态和区间上限。程序计算合计和差异,模型 total 仅作不可信输入。

验收: B01—B06 与金额越界、重复费用、未知币种通过;基准和三种涨价结果准确。target 加总通过不等于报价预算核验通过;未知必要费用导致 unknown。餐饮含锅底油碟等估算口径明确。拟新增 scripts/test-travel-budget.cjs。

GT-020 路线编排与接驳节点

  • 状态:待实施。

前置: GT-012、GT-013、GT-019。对应主线: T003。

前端 后端
新增 src/services/groundedRoutePlanner.ts;复用详细行程活动结构及城市体验标签 只提供交通事实,不决定路线顺序

具体工作: 活动、交通边、固定窗口、保守耗时与休息;包含车站接驳、入住寄存、退房和取行李。精确日期时间带时区,软活动保留时间范围。

验收: R01—R06 通过;取行李不能被省略,跨午夜正确,到站提前量有效。目的地内交通与跨城列车分开统计;内部步行未知不标强度达标。小组合枚举稳定,大组合按限额停止。拟新增 scripts/test-grounded-route-planner.cjs。

GT-021 统一校验与结果状态

  • 状态:待实施。

前置: GT-015、GT-019、GT-020。对应主线: T003。

前端 后端
新增 src/services/travelConstraints.ts;定义 pass/fail/unknown/not_applicable 报告 同步仅需使用的纯结构、引用和证据边界,不运行前端规划引擎

具体工作: 校验资源、日期、费用、时间、选择和强度;派生 provisional/verified/infeasible。区分用户硬约束、默认策略和偏好;明确每个 not_applicable 原因。

验收: 关键未知不产生 verified;事实失败与缺资料区别正确;有限搜索失败不声称全市场无解。must/liked 包含、excluded/backup 不安排、wanted 遗漏理由完整;两个地点上限不误当两个片区。拟新增 scripts/test-travel-constraints.cjs;所有状态组合有断言。

GT-022 有界修复与方案比较

  • 状态:待实施。

前置: GT-021。对应主线: T003。

前端 后端
扩展 groundedRoutePlanner.ts,新增或调整新模式比较服务;复用 routePreference.ts、planComparison.ts 的可用结构 无规划算法新增

具体工作: 最多两轮确定性修复,最多24个组合;调整弹性顺序和可选活动,保留 must 与固定节点。基于实际账本和交通差异选推荐、省钱、省事;不足三份时不硬凑。

验收: 不重复调用模型;不静默改固定日期或去掉必去;相同输入排序一致。只有一份可行候选正确展示;差异不是固定加减金额。输出已评估范围,不宣称全局最优。拟新增 scripts/test-grounded-plan-comparison.cjs。

GT-023 全流程协调器

  • 状态:待实施。

前置: GT-017、GT-018、GT-022。对应主线: T003。

前端 后端
新增 src/services/groundedPlanningCoordinator.ts;通过既有 useTripConversation.ts 和 useTripSession.tsx 接入 核对各阶段凭据、剩余期限和一次执行,不在后端替代前端编排

具体工作: intent → 暂存条件 → 资源 → compose → 路线 → 校验;明确条件时跳过 intent。没有实体时回到同条件参考草案,保留可用报价与缺项,不假称精细核验。

验收: 实际服务替身重放完整成功和部分失败;任意阶段超时不延长总截止。进度不改变内容版本;总模型最多两次且无自动重试。错误、空候选与取消都有终态;界面不直接调用供应商。拟新增 scripts/test-grounded-planning-coordinator.cjs。

GT-024 原子提交与失效保护

  • 状态:待实施。

前置: GT-023。对应主线: T003。

前端 后端
修改 src/pages/trip/tripSessionState.ts、useTripSession.tsx、useTripConversation.ts;新增单事件提交及影响摘要 保留既有请求编号、阶段、归属和到期保护

具体工作: 一次提交条件、偏好、选择、groundedPlan、账本和报告;确认前后重查内容版本。暂存状态不触发自动存档,不把资源进度当实际修改。确认取消完全保留旧方案。

验收: “人数改三人、预算改3000并生成”要么整体成功、要么全部不变;取消、非法候选、旧回复、离页、改变地点和目录加载竞态覆盖。测试使用实际 hook/reducer,而非仅测试单独函数。拟新增 scripts/test-grounded-atomic-commit.cjs 并保留原 trip-session 回归。

GT-025 V2 存档与恢复重验

  • 状态:待实施。

前置: GT-005、GT-024。对应主线: T003/T004。

前端 后端
修改 src/types/tripAggregate.ts、src/services/tripAggregate.ts、src/services/backends/cloudTrip.ts、personalTrip.ts、src/pages/trip/useTripPersistenceCoordinator.ts 使用 GT-005 双版本接口,补实际新存档信封联调

具体工作: V1 原样解读,V2 保存规范化需求、实体选择、攻略和最小证据摘要;groundedPlan 作为唯一事实,旧草案为投影。恢复后重算状态,过期证据降级,打开不自动查价。旧 Demo 不变成 grounded。

验收: V1、V2、旧字段缺省、跨城、断网及证据过期都能正确恢复;新增 ID 不污染旧枚举字段。旧客户端不能覆盖新数据;同版本最后成功写入行为不变。保存失败提示与本地已生成内容分开,不把网络失败当生成失败或已保存。拟新增 scripts/test-grounded-archive.cjs,保留历史恢复回归。

GT-026 攻略与证据展示

  • 状态:待实施。

前置: GT-021、GT-025。对应主线: T003。

前端 后端
新增 src/pages/trip/GroundedTravelPlanCard.tsx 及样式;修改 TripSessionView.tsx、阶段栏和已有草案卡适配;新增预算与来源展示组件 无自由文本界面逻辑;返回白名单来源和缺项

具体工作: 展示完整攻略、交通住宿、每日安排、用餐额度、费用分项、机动余额、来源和状态;金额及时间取自结构化结果。等待显示真实阶段,不显示协议、隐藏推理或伪查询动作。

验收: 两人2000示例完整可读,quoted/reference/estimated/target 可区分;unknown 不显示0;provisional 不显示全部核验完成。手机宽度无横向溢出,长标题、缺链接、超预算与失败状态清晰。T01 文案一致性通过,保存和继续修改入口可操作。UI 验收不能代替供应商事实验证。

GT-027 修改后的局部重算

  • 状态:待实施。

前置: GT-024、GT-025、GT-026。对应主线: T003。

前端 后端
扩展 groundedPlanningCoordinator.ts、影响与失效服务,复用 itineraryEdit.ts、useTripItinerary.ts 的保护原则 资源服务按新的输入指纹和必要查询处理,不越权替换用户计划

具体工作: 日期、人数、预算、住宿、地点和节奏分别定义失效范围;复用仍有效资源。局部修改重算相关交通和返程余量;已经购买或固定预约节点受保护。

验收: 改预算不丢必去,改人数更新人均总额,改酒店插入新的接驳和行李节点,改日期清除不适用报价。取舍需确认时取消保持原状;对已购节点不自动取消订单。只有资源仍有效且条件匹配时才复用,GET 不触发刷新。

GT-028 运行记录与评测扩展

  • 状态:待实施。

前置: GT-016、GT-018、GT-027。对应主线: T003/T004。

前端 后端
扩展 scripts/lib/grounded-travel-eval-runner.cjs、host、fixtures 与评测报告;记录应用前后和校验结果 扩展运行元数据、诊断枚举、耗时、工具统计及用量,复用现有 logger 与请求仓储

具体工作: 分开统计理解、运输、资源、规划、状态和保存失败;记录 inputHash、候选版本、来源和策略版本。评测从当前后端适配器加载,不测试旧镜像。开发与独立验收样本分离。

验收: dry-run 不调用真实模型;真实、离线与替身在报告中明确标记;失败费用未知不伪造账单。日志不包含密钥、身份原文、旅行正文、含 Key URL 或隐藏推理。固定快照的结构化回放一致,文本逐字重现使用记录响应。既有评测 runner 回归通过。

GT-029 离线完整链验收

  • 状态:待实施。

前置: GT-025 至 GT-028。对应主线: T003 完成门槛。

前端 后端
新增完整旅行人工夹具及实际 hook/reducer/codec 回放,补开发者工具离线流程 真实 production composition、HTTP、隔离 MySQL,外部供应商与模型使用离线替身

具体工作: 覆盖初次输入、澄清、生成、修改、取消、保存、恢复;执行技术方案 Q/B/R/P/E/S/O/T 用例,并完成旧协议、资料管理、群投票与原规划回归。

验收: 所有核心场景通过;预算算术、状态误改、必去排除错误和假 verified 均为0。真实数据库并发、租约、重放和旧格式覆盖通过;两端必要类型、lint 与构建通过。报告明确外部调用数0,不把通过数写成模型准确率。出具 G3 候选证据清单。

GT-030 供应商实际接入验证

  • 状态:待实施;需独立确认真实测试范围。

前置: GT-029,当前 Key、权益、账号、使用和保存条件。对应主线: T002 实际查询验收。

前端 后端
消费本次响应并核对显示,不使用离线数据混充 使用拟新增 scripts/verify-travel-resources.ts 或等效受控工具,调用当前生产实现的 provider,不执行任意 CLI

具体工作: 在明确数量和费用范围内验证 POI、去回程火车、酒店、实体匹配、关键路线和天气;采用当时有效的未来日期。保存脱敏响应、请求条件、字段缺项、耗时和费用或未知状态。

验收: 每种能力分别填写已验证/部分验证/未配置/失败;核对实际单位和字段,不用文档示例代替。酒店无房型税费库存时保持 reference;火车余量空保持 unknown;天气未覆盖旅行日期正确降级。不能因为 Key 保存过或健康接口200就勾选成功。本步骤不部署、不写用户旅行数据。

GT-031 真实模型与规则联合验收

  • 状态:待实施;需独立确认真实测试批次。

前置: GT-030。对应主线: T003 实际效果验收。

前端 后端
现有 runner 配合实际前端执行宿主,使用新候选、规则与保存替身 当前后端模型适配器、真实服务端资源证据和公开输出边界

具体工作: 分开发测试批与独立验收批;覆盖本例、超预算、资料缺项、地点冲突、修改及未知城市。每批先 dry-run 计算实际调用次数,再按当前授权执行;保留失败,不自动重试。

验收: 对话能正确澄清口径;模型引用真实资源且遵守必去排除;费用与时间由程序计算,错误候选被拒绝。记录模型质量、拒绝原因、延迟和用量,不能只用最终结构合法说明推荐正确。本机真实模型通过不等于云保存或手机通过。报告不复用历史额度或成功率。

GT-032 云端受控发布准备与验证

  • 状态:待实施;属于后续发布步骤。

前置: GT-005、GT-031,当前候选的 CI 及环境准备。对应主线: T004。

前端 后端
新能力缺省关闭的构建、环境检查和受控体验包 当前候选的 Docker/Node20/MySQL5.7 CI,兼容迁移、能力接口和关闭开关部署

具体工作: 先发布支持双版本且新查询关闭的候选,验证旧功能;再在受控环境启用必要资源和新客户端。配置独立开关和服务端 Key,不复活旧访问刷新。实际部署操作单独执行,不由代码构建推断上线。

验收: 同候选 CI 和启动证据一致;能力协商、身份与归属正确;关闭状态零新供应商调用。仅按批准的测试范围开启查询,旧用户路径不被破坏。记录前后端版本、配置状态、迁移和回滚候选;不将 capability configured 当供应商健康证明。

GT-033 手机与云保存端到端验收

  • 状态:待实施;需受控测试行程与调用范围。

前置: GT-032。对应主线: T004。

前端 后端
实际手机及开发者工具进入同一个旅行工作台;核对确认、显示与恢复 真实微信入口、当前模型和资源接线、云保存及读取

具体工作: 使用新建测试行程走“输入 → 澄清 → 完整攻略 → 改预算或地点 → 确认/取消 → 保存 → 返回首页 → 继续行程”;另测网络失败、等待离页和过期后重新打开。

验收: 手机与开发者工具结果分别记录;真实点确认和取消,不用模拟确认计作手机通过。原条件、选择、费用、路线、核验状态和未核实项恢复一致;旧客户端不能覆盖V2;保存失败不能显示已保存。双设备测试使用明确的测试账号,验证最后成功写入行为,不访问无关真实行程。G5 证据包含截图、版本、结果及未通过项。

GT-034 发布判定与兼容回滚

  • 状态:待实施;未获得本清单以外的发布授权。

前置: GT-033。对应主线: T004 收尾。

前端 后端
新入口能力门禁、支持范围、异常与升级提示;兼容关闭新生成的体验包 兼容 V2 读取但关闭新查询的回滚候选、开关和清理说明

具体工作: 根据真实证据决定开放参考生成或核验范围;记录实际供应商字段不足及手机问题。准备关新能力、保持旧对话和V2读取的回滚路径,不通过清库或退回不支持V2的镜像回退。

验收: 发布检查清单全通过且不存在假 verified、状态误改或版本覆盖风险。关开关后旧攻略可读,新查询停止;已发请求的终态与费用边界明确。最终文档列已完成、未完成和外部限制,不把阶段通过描述为全国实时数据完全覆盖。发布本身在用户明确指示的范围内执行。

5 每项任务的统一完成标准

标准 具体要求
范围 只完成当前任务和不可缺少的依赖修正,不提前实施后续能力
可审查 列清新增和修改文件,说明行为变化及兼容影响
核心测试 本任务指定正面、失败和边界用例全部通过
原功能 被触及的旧对话、目录、存档、投票或 Demo 路径回归通过
代码质量 按修改项目执行类型检查、lint、构建;单文档任务仅文档核查
证据 记录候选版本、命令、环境、结果、真实或替身来源
数据 不修改无关用户数据,不清理业务库,不存密钥或原始推理
状态 编号任务更新为真实结论;外部未验证项明确保留

建议每项形成独立可回退提交,跨项目任务记录相互对应的提交。是否提交、推送、合并或部署按当次用户指示执行,文档创建不自动触发这些动作。

6 验收命令与环境

以下是后续实施时使用的命令,本轮未执行业务测试。新增专项测试文件在各任务中明确,尚不存在时不能宣称脚本已通过。

6.1 前端

在 chuchuwan-mvp 目录执行:

npm run typecheck
./node_modules/.bin/tsc --noEmit -p tsconfig.ai.json
npm run lint
./node_modules/.bin/eslint --ext .ts server/ai
npm run build:weapp:prod

根据改动选择现有回归:

npm run test:trip-session
npm run test:trip-persistence
npm run test:trip-persistence-page
npm run test:trip-persistence-home
npm run test:trip-last-write-wins
npm run test:travel-plan
npm run test:itinerary
npm run test:itinerary-edit
npm run test:public-catalog
node --test scripts/test-ai-conversation-client.cjs
node --test scripts/test-grounded-travel-eval.cjs

若构建受 Taro 远程校验环境影响,可使用现有 scripts/build-weapp-offline-validated.cjs 的经验证路径并记录原因和门禁;不能把替代构建写成原命令已经通过。生产配置缺失应明确处理,不通过移除门禁完成构建。

新专项脚本加入 package.json 或使用现有执行习惯直接调用,并在任务记录中保留确切命令。不引入前端不存在的顶层 npm test 聚合命令作为验收依据。

6.2 后端

在 chuchuwan-server 目录执行:

npm run typecheck
npm run build
npm test

独立测试按现有 tsx 方式运行,示例:

node --import tsx --test tests/conversationValidation.test.ts tests/travelEvidence.test.ts tests/flyaiProvider.test.ts

新增资源数据库测试必须提供专用隔离入口,测试自己创建随机测试库并删除自己的库,禁用业务 MYSQL 配置回退。不能直接执行真实环境迁移或依赖本机已有 socket 路径,CI 与开发环境都应记录真实测试版本。

6.3 真实调用

层 执行前明确 结果必须记录
供应商 能力类型、有效日期、次数、费用或额度边界 真正请求条件、响应缺项、耗时、费用或未知
模型 当前两端版本、开发/验收集、plannedCalls、批次范围 原始结构化响应、规则结果、用量、失败与质量判断
云保存 测试账号与新测试行程、当前部署版本 真实创建保存读取、内容和版本
手机 实际设备、体验包、环境、允许调用范围 页面、确认/取消、恢复、截图与异常

所有真实测试使用当时可查询的日期。2026-10-17/18 和示例金额仅作为固定离线夹具保留,开发完成较晚时不能用过期日期当实测失败或行情结论。

7 首条业务验收脚本

步骤 用户或测试动作 必须断言
1 输入“周末从西安去成都,2人轻松游,预算2000” 不擅自确认预算口径、日期和年龄构成
2 明确周末日期、两人总预算且含交通住宿 规范化金额200000分,需求条件一致
3 按需明确一间一晚及房型或保留假设 假设可见,酒店报价匹配程度准确
4 发起生成 一次操作,最多两次模型,查询范围有界
5 查询交通、住宿、地点、关键路线 来源、日期、报价状态和缺项真实
6 生成完整参考攻略 有每日安排、交通住宿、用餐、账本、预留和依据
7 使用完整人工夹具检查核验通过分支 所有必要硬检查 pass;不将此标为真实行情验收
8 使用真实供应商缺项检查参考分支 未知库存、房型或路线不能变成 verified
9 把票价及酒店改为涨价夹具 2060/2110/2170正确,不能继续声称2000内
10 修改必去、排除或节奏 未改条件保留,冲突清楚,取消不误改
11 保存并从首页恢复 条件、选择、费用、安排与状态一致
12 过期后打开或旧客户端保存 不自动查价、不保留已过期核验、不丢新字段

真实验收中的价格以真实查询为准,不要求刚好等于预算夹具;验收的是口径、数据使用、计算和状态正确。

8 任务验收记录模板

任务编号:GT-xxx
任务状态:未开始 / 实施中 / 离线通过 / 真实验收通过 / 待外部条件
前置任务及证据:
前端候选提交与文件:
后端候选提交与文件:
契约与策略版本:
验收场景和实际断言:
执行命令与环境:
测试来源:离线 / 真实数据库 / 真实供应商 / 真实模型 / 真实云保存 / 手机
外部调用次数、用量与费用状态:
通过结果:
失败、缺项或未验证内容:
存档与旧协议影响:
回退方式:
是否可以进入下一任务及理由:

“离线通过”不是任务真实能力全部完成的同义词。含真实能力验收的任务,外部条件未落实时保留相应未完成项;同时允许不依赖该条件的后续离线工作继续按明确任务推进。

9 现在的第一步

正式开始开发时先执行 GT-001,把本清单中已经确定的首版边界、版本保护和验收条件写入现有 007 实施规格,再执行 GT-002 的共享契约。第一轮应交付清楚的契约与夹具,随后落地需求口径、版本兼容和运行控制;不先接页面、替换模型或同时开放全部供应商。

本轮只生成这份任务清单。34 项全部保持待实施,现有技术方案、项目代码、配置与 007 tasks 的完成状态保持原样。

10 项目依据