logan
cdaba44373
先做全量功能盘点（编辑器/测试/Mock/AI/导入导出/服务端/桌面授权），再对齐内容： - 落地页：hero 副标与药丸补 AI 用例/Cron 定时/智能 Mock；「为什么选」4→8 卡 （新增 自动化测试闭环/AI 生成用例/智能 Mock 双引擎/内网文档分享）；功能区 6→12 卡 （新增 测试/AI/智能 Mock/历史重放/系统代理/文档快照）；对比表 +3 行（断言/AI/Cron）； 定价卡对齐 3/5 台与真实权益；新增 bot/list-checks/flask/clock 图标 - 文档：03-界面导览 重写为活动栏时代（含授权徽章/空间切换）；16-测试 补 5 段 Cron 章节（示例/15s 巡检/30 条日志/防重入）与 JSON 报告格式；14-Mock 补 61 条规则数、 独立端口 8798/OPSXAPI_MOCK_ADDR、Mock 管理页、Bearer 与来源控制、一键建 Mock - 新增 21-授权与激活 文档（试用条款/LIC- vs LICOFF-/解绑/离线容忍/防伪）并注册目录 - 21 页文档全量重建；7 页零断链验证 + DOM 结构核验（卡片/图标/药丸计数）通过
44 lines
2.8 KiB
Markdown
44 lines
2.8 KiB
Markdown
# 自动化测试
|
||
|
||
把日常联调的接口串成**场景用例**，一条龙验证业务流程。三种触发方式共用同一套用例模型：
|
||
|
||
| 方式 | 说明 | 适合 |
|
||
| --- | --- | --- |
|
||
| 手动运行 | 用例编排好后点「运行」 | 日常自测、回归 |
|
||
| AI 生成 | 模型按接口清单自动编排步骤与断言 | 快速起盘、补断言思路 |
|
||
| 定时任务 | 应用运行期间按间隔自动执行 | 持续监控、冒烟 |
|
||
|
||
## 场景用例
|
||
|
||
从活动栏「测试」进入。用例 = 有序步骤列表，每个步骤：
|
||
|
||
- **引用一个 HTTP 接口**（从集合中选择，可跨集合、跨目录）；
|
||
- **断言**：状态码 / 耗时 / Header / Body 四类目标，支持 等于、不等于、大于、小于、包含、存在 与 **JSONPath** 取值比较；
|
||
- **变量提取**：`$.data.id` → 环境变量 `petId`，后续步骤 URL / Body 用 `{{petId}}` 引用，实现「创建 → 查询 → 删除」链式传值；
|
||
- 可单独禁用、上下移动、删除。
|
||
|
||
用例级选项「**失败后继续**」：默认失败即停（快速定位首个问题）；打开后跑完全部步骤再看整体报告。
|
||
|
||
## 运行报告
|
||
|
||
- 统计卡：通过 / 失败步骤数、总耗时、断言数、通过率；
|
||
- 步骤明细：方法 + URL + 状态码 + 耗时，逐条断言的期望 / 实际对照（可按 通过 / 失败 过滤）；
|
||
- 「再次运行」一键回归；「导出报告」生成 Markdown（含断言对照表，适合贴缺陷单）或 JSON（`opsxapi.test-run.v1` 结构，供 CI / 脚本二次处理）；
|
||
- 每个用例保留最近 50 次运行记录，可下拉切换历史报告。
|
||
|
||
## 定时任务
|
||
|
||
用例头部的 ⏱ 按钮或左侧「定时任务」入口，两种节奏：
|
||
|
||
- **固定间隔**：5 / 15 / 30 / 60 分钟 · 6 小时 · 每天；
|
||
- **Cron 表达式**：标准 5 段（分 时 日 月 周，本地时区），例如每 15 分钟 `*/15 * * * *`、每个工作日 9 点半 `30 9 * * 1-5`；
|
||
- 独立 启用 / 暂停 开关，显示下次运行时间与上次结果；
|
||
- 调度器每 15 秒巡检一次，同一用例运行中不会重复触发；每个任务环形保留最近 30 条运行日志；
|
||
- **应用保持运行时生效**：OpsxAPI 窗口（或 Web 页面）开着才会按时触发并记录报告，关闭后自动暂停 —— 适合工作时段的持续监控，不能替代服务器侧的 CI。
|
||
|
||
> 提示：定时触发的请求同样走当前环境与 Mock 设置；跨环境回归前先在顶栏切换环境。
|
||
|
||
## AI 生成用例
|
||
|
||
见 [AI 助手](/docs/ai)。配置模型供应商后，「AI 生成」会读取集合的 HTTP 接口清单（方法、URL、Body 示例），按业务依赖编排步骤、断言与变量提取，生成前可附加一句要求（如「重点覆盖登录态与分页」），预览确认后保存。
|