AgentX TestHub

文档概览

ATH 是一套做产测的工程工具：一边操作真实设备，一边把输入整理成可复现的测试流程，再交给产线工位逐台执行。

这套软件做什么

产线要判断的是真实硬件，不是一段演示。软件把这件事拆成两半：工程人员用 ATH 把一台设备「说清楚」，产线用 ART 按这份说明逐台判断，给出 PASS、FAIL 或 PENDING。

两半共用同一个项目目录。项目是唯一来源：设备怎么读、页面长什么样、什么算通过，都写在项目里；换台电脑、交给同事、归档复盘，用的都是同一份内容。

入口	面向谁	做什么
ATH 桌面应用	工程人员	观察设备、录制测试序列、搭页面、写判定规则、验证并交付项目。
ART 桌面应用	产线操作员	按提示操作待测设备，读判定结果，换上下一台；不提供编辑入口。
`ath` 命令行	工程人员、自动化与外部智能体	把界面里的能力同样开放给脚本：设备、发现、DD、判定、版本、打包与诊断。
`art` 命令行	自动化与产线部署	无窗口地校验项目、跑一次测试、导出操作员反馈包。

只需要一次测试的完整过程和操作员排障。工位怎么配置由工程人员负责，写在同一组的工位配置与启动里。

先看命令行参考，再看外部智能体与自动化：设备说明（DD）与判定规则都可以由外部智能体生成，软件负责校验、写入与回滚。

词	含义
项目	一个普通目录，装下一个产品的产测流程，可整体复制与交接。
页面 / 区域 / 组件	页面上放区域和组件；组件绑定一个输入，可以带自己的提示语。
输入	设备实际能给的按钮、开关、摇杆、扳机等，由实机操作或协议资料确定。
设备说明（DD）	一份可版本化的设备契约：怎么识别这台产品、怎么解析它发来的数据。
测试序列	操作员应当按顺序做的一组动作，录制时按一次记一步。
判定规则	什么算通过。规则的唯一定义在项目的判定图里，由 Rust 判定。
活动状态	某个输入此刻是否被按下或越过阈值；指示线与组件共用这份状态。
PASS / FAIL / PENDING	一次测试的结论：通过、未通过、尚未确定。
发布包（.art）	把 ART 运行所需的项目文件打成一个包，便于部署到工位。

当前发布 macOS（Apple Silicon）与 Windows x64 两个平台的安装包；Windows 产物由 macOS 交叉构建，尚未在真机上验证，Linux 尚未构建。代码本身同时覆盖三个平台，未实测不等于不支持。

文档描述的是当前版本的行为。界面文案与命令行输出都以简体中文为准，遇到问题时先用日志与诊断里的办法取证据。