51 lines
2.0 KiB
Markdown
51 lines
2.0 KiB
Markdown
# tester
|
|
|
|
维护并执行项目里的黑盒测试目录。用例按分类放在 `.pouch/tester/`，可以列出、增改，也可以按分类或编号去跑。
|
|
|
|
## 什么时候使用
|
|
|
|
- 「列出测试」「一共有哪些用例」
|
|
- 「加一条相机开盖的测试」「完善 TC-CAM-003 的验证」
|
|
- 「跑 smoke」「测 CAM」「跑 TC-INF-001 和 TC-CAM-001」
|
|
- 「现场复测」
|
|
|
|
不管 ACK。这是项目自己的测试目录。
|
|
|
|
## 使用前准备
|
|
|
|
- 目录在项目根的 `.pouch/tester/`。没有就说「初始化 tester」。
|
|
- 跑真实环境前，复制 `.pouch/tester/local.yaml.example` 为 `local.yaml`，填 `HOST`。也可以用环境变量 `HX_TEST_HOST`。
|
|
- 会动硬件、会改数据的用例带风险级别。默认只跑最低档（只读）。要跑更高风险，需要你明确说，例如「风险到 hardware」。
|
|
|
|
## 使用示例
|
|
|
|
```text
|
|
列出测试用例
|
|
```
|
|
|
|
```text
|
|
加一条测试：分类 CAM，风险 hardware，开盖再关盖，用脚本打 /api/camera_3d
|
|
```
|
|
|
|
```text
|
|
跑 INF 分类的 smoke
|
|
```
|
|
|
|
```text
|
|
跑 TC-CAM-001,TC-CAM-005，风险保持默认
|
|
```
|
|
|
|
## Agent 会做什么
|
|
|
|
1. 用脚本读 `.pouch/tester/`，按分类统计或筛出你点名的用例，不会把整库塞进对话。
|
|
2. 改用例前先给你看将要写入的内容，你确认再保存。
|
|
3. 执行时：脚本类直接跑命令；浏览器和移动模拟器先初始化一次，同一轮里复用。
|
|
4. 超出你允许的风险级别会跳过，不会偷偷执行。
|
|
5. 跑完给出按分类计数的结果，以及 `pass / fail / environment-fail / skipped`。
|
|
|
|
## 如何判断完成
|
|
|
|
- **列出**：能看到分类表和总条数；`.pouch/tester/cases.csv` 已由 skill 里的 `generate_cases_csv.py` 从 `cases/` 重新生成。最近一次运行的结果在同一张表的 `last_result` / `last_executed` 列。
|
|
- **维护**：目标 id 能 `查看` 到，且检查通过。
|
|
- **运行**：有本次 `runs/*.yaml` 快照和同名 `.csv` 成绩单（`executed` 列区分已跑 / 未跑）；没填 HOST 时会停，而不是编造失败。
|