AgentX
目录 · 第一个产测项目

开始使用

第一个产测项目

下面这条路径不需要协议文档,全部靠真实设备完成。每一步都给出界面动作,以及等价的命令行写法。

走一遍

  1. 01新建项目ATH 里点「新建项目」,选一个空目录(也可以在原生目录选择器里新建文件夹)。项目会直接写进这个目录, 不额外建子目录,也没有单独的项目名字段:项目和目录一一对应。
    命令行等价:ath project init ./my-product
  2. 02连上设备插上待测设备,在设备栏里选中它。ATH 会记住这台设备(按 VID、PID 与序列号), 下次打开还在。选中不等于自动连接,连接状态单独显示。
    没看到设备时先看 ath device list,它会列出系统里全部 HID 接口,不做任何筛选。
  3. 03观察一次真实操作直接按键、推摇杆、拉扳机。ATH 用被动输入运行时读取并解码,只读取、不写入, 也不建立协议会话,因此不会打断你正在用的设备。
    命令行等价:ath device trace(打印的就是页面收到的同一份输入)。
  4. 04把动作录成一步在编辑器里开始定义测试序列,按一次就记一步。按键、摇杆方向、扳机行程、整顶方向帽都能作为一步; 编辑器只记录「操作员做完了什么」,怎么判定由 Rust 翻译成清单项。
  5. 05在页面上看到它把设备图片拖进页面,放入对应输入组件,再用状态指示线把组件连到图片上的位置。 按下按钮时组件与指示线同一帧高亮,你就能确认「页面显示的」和「设备实际发生的」一致。
  6. 06写清什么算通过在「判定规则」里加一条规则:先写需求(必须满足的条件),需要按顺序收集证据时用清单规则。 规则最终写在项目的判定图里,界面只显示判定引擎给出的同一份结果。
    命令行等价:ath app rule-add --rule ./rule.yaml
  7. 07在 ATH 里验证用验证会话按序列走一遍,看每条规则的状态与证据是否符合预期。规则也可以离线试跑, 不必每次接真机。详见 在 ATH 里验证。
  8. 08交付给产线把项目打包成 ART 运行所需的文件,复制到工位机,或直接生成部署目录。
    ath package build 生成自包含部署目录;ath publish 生成 .art 发布包。 详细做法见 部署到产线。
  9. 09在 ART 里跑一台第一次打开 ART 时配置一次项目目录,之后每次启动直接进入工位:插入设备、按提示操作、 得到 PASS、拔出设备、换上下一台。

中途怎么知道自己做对了

任何时候都可以校验项目
ath validate
ath project status
ath app inspect

validate 校验项目本身并可以导出规范化的测试 IR;project status 检查完整性与候选版本;app inspect 给出页面、组件与规则数量的摘要。三条都是只读的。