# 自动化测试

把日常联调的接口串成**场景用例**，一条龙验证业务流程。三种触发方式共用同一套用例模型：

| 方式 | 说明 | 适合 |
| --- | --- | --- |
| 手动运行 | 用例编排好后点「运行」 | 日常自测、回归 |
| AI 生成 | 模型按接口清单自动编排步骤与断言 | 快速起盘、补断言思路 |
| 定时任务 | 应用运行期间按间隔自动执行 | 持续监控、冒烟 |

## 场景用例

从侧栏底部「自动化测试」进入。用例 = 有序步骤列表，每个步骤：

- **引用一个 HTTP 接口**（从集合中选择，可跨集合、跨目录）；
- **断言**：状态码 / 耗时 / Header / Body 四类目标，支持 等于、不等于、大于、小于、包含、存在 与 **JSONPath** 取值比较；
- **变量提取**：`$.data.id` → 环境变量 `petId`，后续步骤 URL / Body 用 `{{petId}}` 引用，实现「创建 → 查询 → 删除」链式传值；
- 可单独禁用、上下移动、删除。

用例级选项「**失败后继续**」：默认失败即停（快速定位首个问题）；打开后跑完全部步骤再看整体报告。

## 运行报告

- 统计卡：通过 / 失败步骤数、总耗时、断言数、通过率；
- 步骤明细：方法 + URL + 状态码 + 耗时，逐条断言的期望 / 实际对照（可按 通过 / 失败 过滤）；
- 「再次运行」一键回归；「导出报告」生成 Markdown 存档或归档到缺陷单；
- 每个用例保留最近 50 次运行记录，可下拉切换历史报告。

## 定时任务

用例头部的 ⏱ 按钮或左侧「定时任务」入口：

- 间隔可选 5 / 15 / 30 / 60 分钟、6 小时、每天；
- 独立 启用 / 暂停 开关，显示下次运行时间与上次结果；
- **应用保持运行时生效**：OpsxAPI 窗口（或 Web 页面）开着才会按时触发并记录报告，关闭后自动暂停 —— 适合工作时段的持续监控，不能替代服务器侧的 CI。

> 提示：定时触发的请求同样走当前环境与 Mock 设置；跨环境回归前先在顶栏切换环境。

## AI 生成用例

见 [AI 助手](/docs/ai)。配置模型供应商后，「AI 生成」会读取集合的 HTTP 接口清单（方法、URL、Body 示例），按业务依赖编排步骤、断言与变量提取，生成前可附加一句要求（如「重点覆盖登录态与分页」），预览确认后保存。