工程端 · ATH
测试序列
测试序列是「操作员应当按顺序做的一组动作」。它由录制产生,由 Rust 翻译成判定清单。
录制:按一次记一步
编辑器只记录操作员做了什么,不要求你先写规则。开始定义测试序列后,按一次设备,页面就记下一步: 记下的是哪个输入、什么形态、以及当时读到的值。
- 01开始定义在编辑器里对当前页面开始定义测试序列,界面会提示正在采集。
- 02按顺序操作按一次记一步;按错可以撤销,也可以中途停下重来。
- 03结束并生成结束后由 Rust 把步骤翻译成判定引擎的清单项:这一步要收到什么证据、值域是多少。 翻译过程保持一致,同样的操作得到同样的清单。
不同输入的记法
| 输入形态 | 一步代表什么 | 判定要求 |
|---|---|---|
| 按键(button) | 按下这个键。 | 收到按下,阈值就是录制时读到的值。 |
| 开关(switch) | 拨到某一档。 | 读到对应的档位值。 |
| 摇杆(stick) | 把摇杆推到某个方向。 | 方向与到达幅度:以中位为基准,超过幅度才算到达。 |
| 扳机(trigger) | 把扳机拉到底。 | 行程达到满量程附近。 |
| 方向帽(hat) | 整顶方向帽算一步。 | 每个方向都出现过一次,先按哪个都行。 |
页面自带的序列
在页面上录出来的序列属于这一页,规则标识形如 sequence-<页面标识>。 这类标识由系统保留:外部智能体不能直接提交同名规则,只能读。
- 删除页面时,这一页自带的测试序列一起删除(
ath app page-delete的说明里写明)。 - 在
ath dr里,页面测试序列是只读的;需要调整顺序或内容时回到 ATH 里重录或修改。 - 序列生成的清单规则会出现在判定规则列表里,与手工写的规则并存,见 判定规则。
录完之后怎么检查
ath app inspect # 页面、组件与规则数量
ath dr list # 全部规则:标识、归属与引用
ath dr explain <RULE_ID> # 用人话说明这条规则在判什么
ath run ./scenario.yaml # 用虚拟场景跑一次完整判定录制只保证「记录了你的操作」,是否构成合格判定要靠这几条命令确认。真正接设备走一遍的做法见 在 ATH 里验证。