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