AgentX
目录 · 测试序列

工程端 · ATH

测试序列

测试序列是「操作员应当按顺序做的一组动作」。它由录制产生,由 Rust 翻译成判定清单。

录制:按一次记一步

编辑器只记录操作员做了什么,不要求你先写规则。开始定义测试序列后,按一次设备,页面就记下一步: 记下的是哪个输入、什么形态、以及当时读到的值。

  1. 01开始定义在编辑器里对当前页面开始定义测试序列,界面会提示正在采集。
  2. 02按顺序操作按一次记一步;按错可以撤销,也可以中途停下重来。
  3. 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 里验证。