核心优势

六项优势，对应团队在测试工作中最痛的六个环节。

① 用例不用写——业务如旅，零门槛编排

测试用例不再需要用代码表达。每条旅途由「一段自然语言说明 + 一份结构化 YAML」组成：业务同学口述流程，导游 AI 生成初稿，测试同学确认断言细节。业务知识第一次成为可流转的资产，而不是某个人的经验。

② 回归不用点——双模式执行，一份用例两用

同一条旅途，出发时自由选择跑法：

• 测试造数（推荐）：按旅途规格优先调业务接口快速落库，几分钟造出一批符合业务规则的完整数据，证据 = 接口记录 + SQL 断言。
• 回归穿越：像真人一样逐步点击、填写、提交，Playwright 驱动浏览器走完整个业务流程，每个景点留截图与接口记录。

③ 报告不用写——证据链完整，凭号同看

行程单号是产品的最小可信单元。详情页包含：景点打卡进度、每个景点的 UI/DB 断言表、数据参数捕获（captures）、证据截图、HTTP 访问记录、OpenCode 会话与 Token 成本。把单号链接发给产品、研发、客户，无需再写测试报告。

④ 失败不用重来——断点续跑，一键再出发

第 7 个景点失败了？修复后「继续执行」从断点接着走；想换个路书参数复测？「再出发一次」一键复制行程全部配置。高频的验证与回归场景被压缩到两次点击。

⑤ 环境不用管——全变量化，一分支一目录

载具把被测系统的页面地址、数据库、账号、代码仓库与分支全部收敛为 ENV 变量，Agent 出发前自动同步代码、感知上下文。多环境并行互不干扰，环境配置从「口口相传」变成「一份载具档案」。

⑥ 成本可核算——按趟透明，Token 账单内置

每张行程单记录 in / out / reason / cache Token 与美元成本。团队可以精确核算每次回归、每批造数的 AI 开销，为后续按量计费提供天然依据。

适用场景

五类高频场景，覆盖测试团队 80% 的日常产出。

① 发布前全链路回归

版本上线前，把核心业务闭环编排成「多段联程」，一键出发做整体回归。AI 沿途逐景点断言库表状态与界面结果，通过即发版，失败即定位到具体景点。告别上线夜全员点点点。

② 联调与演示前的数据准备

「帮我造 2 条不同类型的船舶数据，参数尽量仿照真实数据」——在出发页的附加需求里直接写自然语言，造数模式自动调接口落库并校验。原本手工半天的数据准备，一趟出行几分钟完成。

③ 验收与交付取证

项目验收、客户演示需要证明业务流程真实跑通？发一张行程单号链接：10 个景点全绿、45 张截图、15 条接口记录、库表断言齐备。证据即报告，无需事后整理。

④ 业务流程的知识沉淀

每个业务闭环在系统里都对应一段可运行的旅途——它同时是测试用例、操作手册和流程文档。新人入职看旅途 YAML 就能理解业务规则；导游 AI 还能对照代码解读「这个流程里哪些字段必填」。

⑤ 缺陷复现与排查

线上问题报给测试？用「再出发一次」复现原行程，失败景点直接给出断言差异与现场截图；导游 AI 可以直查被测库表状态，配合研发快速定位。

不同角色的用法

角色	典型用法	得到什么
测试工程师	编排旅途、维护断言、发布前跑联程回归	回归自动化 + 可追溯证据
业务 / 产品	口述流程让导游 AI 建旅途、验收时凭号看证据	不用学工具就能定义和验收用例
研发	提测前自跑业务闭环、缺陷复现排查	提测质量提升 + 快速定位
项目经理 / 客户	查看行程单链接	透明的质量状态，无需参加会议听汇报

概念定义

产品使用统一的「旅途」语言描述测试世界。理解这 8 个词，就理解了整个产品。

一次出行的完整旅程

1. 坐上载具（选定测试环境）
2. 带上路书（选定本趟参数）
3. 沿旅途逐个景点打卡（AI 自动执行 + 断言 + 取证）
4. 走完得到一张行程单号（可分享、可续跑、可复制的完整证据）

快速开始

从注册到拿到第一张行程单，通常不超过 30 分钟。

下一步

• 功能简介——逐模块了解界面与操作细节
• DSL 参考——需要精细控制断言时查阅字段表
• 常见问题——接入与安全相关疑问

功能简介

平台由「计划书（配置面）+ 执行台（操作面）+ 出行记录（证据面）+ 导游 AI（助手）」四部分组成，以下逐模块说明并配真实界面截图。

首页 · 控制面

载具、旅途、联程、出行次数四项统计一屏总览；全局通过率与最近出行表帮助快速掌握平台健康度。首次使用可按页面上的 5 步「怎么用」流程图引导完成配置。

计划书 · 载具（环境管理）

每套载具三个页签：基本信息（编码/状态/排序）、执行引擎（OpenCode Server 地址、工作目录、产物目录）、被测系统（五类 ENV：页面地址、数据库、账号、代码分支、扩展变量）。支持短信验证码自动读取。

计划书 · 旅途（用例管理）

每条旅途 = 自然语言说明 + YAML 结构化定义，支持启用/停用、复制、挂载路书参数化。编辑器内置「召唤导游帮我优化」AI 辅助按钮。

计划书 · 路书（参数化）

为旅途定义参数变量（如 PC_LIST 利润中心列表、申请人手机号），换路书即可参数化重跑，是批量造数与多口径回归的基础。

计划书 · 多段联程（业务闭环）

将多段旅途按序串接成完整业务闭环，可为整体配置默认路书，出发时附加需求会预填进 Agent 提示词。适合发布前的全链路回归。

执行台 · 出发

4 步向导 + 右侧实时预览 + 并发状态条（0/10 空闲）。支持单段旅途与多段联程，两种跑法二选一，附加需求最多 4000 字自然语言。

出行记录与行程详情

每次出行一条记录：行程单号、标题、怎么跑、状态、问题摘要、耗时。详情页包含 OpenCode 会话、Token 账单、附加需求原文、景点列表与逐景点断言表、captures 数据参数、截图证据、HTTP 访问记录。顶部提供复制分享链接、继续执行（断点续跑）、再出发一次。

导游 AI

右下角浮动 chat 抽屉，贯穿全站。三类高频用法：帮你创建旅途（自然语言 → YAML）、对照代码解读业务流程（如「哪些字段必填」）、查询被测库表状态。支持对话历史、报告导出、切换载具排查环境。

平台守则

内置「平台守则」页面，向 Agent 与用户说明出行纪律：并发上限、产物目录规范、断言与证据要求等，保证多团队共用时行为一致。

DSL 参考

旅途 YAML 是产品的核心资产格式。每个景点（step）支持以下字段：

字段	作用	示例
step	景点名称 / 业务动作描述	提交实船修改并等待审核
ui	界面操作指令（点击/填写/校验）	ui_list_contains_ship: true
capture	从页面/接口捕获变量供后续景点引用	tonnage_id: "$.data.id"
db	SQL 查询与库表断言（query + params + expect）	query: crm_tonnage_children_by_id
expect	断言规则：equals / gte / 数量比对等	field: approve_status, equals: PASS
evidence	证据截图说明	screenshot: 修改生效后的实船详情
on_fail	失败策略	stop / continue
severity	严重级别	P0 / P1 / P2 / P3

完整示例

# 旅途：船舶（实船）— 新建并审核通过生效
- step: 登录系统并进入实船管理
  ui: { ui_login: "使用路书账号" }
  evidence: { screenshot: 实船管理列表页 }

- step: 新建实船并填写基础信息/全速/船舱
  ui: { ui_fill_ship_form: "按路书参数" }
  capture: { tonnage_id: "$.data.id" }
  evidence: { screenshot: 新建提交成功提示 }

- step: 提交审核并确认通过
  db:
    query: crm_tonnage_children_by_id
    params: { tonnage_id: "{{capture.tonnage_id}}" }
    expect:
      - field: approve_status
        equals: PASS
      - field: full_speed_count
        gte: 1
      - field: tank_top_count
        equals: 4
  evidence: { screenshot: 修改生效后的实船详情（含子表） }
  on_fail: stop
  severity: P0

变量引用

路书参数与前序景点的 capture 变量通过 {{capture.xxx}} / {{route.xxx}} 语法在后续景点中引用，实现跨景点的数据传递。

常见问题

接入类

被测系统需要满足什么条件？

Web 应用（可通过 URL 访问）+ MySQL 数据库 + 可用的测试账号。代码仓库接入（用于导游 AI 读代码与分支同步）为可选增强项。

需要在我方部署额外的执行引擎吗？

SaaS 模式下平台托管 OpenCode 引擎；私有化部署的企业版可将引擎与产物目录落在客户内网。

接入要改被测系统的代码吗？

不需要。所有上下文（URL、数据库、账号、代码目录）都通过载具 ENV 变量注入，Agent 出发时自行感知，被测系统零侵入。

使用类

不会写 YAML 能用吗？

能。旅途编辑页的「召唤导游帮我优化」会根据自然语言说明生成 YAML 初稿，你只需要人工确认断言细节；导游 AI 也能在对话中直接帮你创建旅途。

并发上限是多少？可以提升吗？

默认同时最多 10 趟出行，出发页顶部有实时状态条。更高并发可在团队版/企业版中扩展。

行程失败后会产生脏数据吗？

造数模式按业务接口落库，失败景点可通过断点续跑继续；库表断言会即时发现状态不一致并在行程单中标记。

附加需求能写什么？

最多 4000 字的自然语言，例如「使用 158xxxx 账号，做 2 条不同类型的船舶数据，参数尽量仿照真实数据」。出发时会预填进 Agent 提示词。

安全类

账号与数据库信息存在哪里？

配置在载具 ENV 中，不进入用例正文与分享页面；行程分享链接可随时收回。

每次出行的产物会保留多久？

每趟出行使用独立产物目录（workspace 快照 + reports 报告与截图），保留策略可在团队版/企业版中配置。

更新日志