01
观察真实设备
插上设备直接操作，ATH 实时读到每个按键、摇杆和轴。观察只读取、不写入，也不占用协议会话，不会打断正在使用的设备。
ATH · 智能产测工作台
让真实硬件的每一次输入，都成为可复现的产测流程。
ATH 在你操作真实设备时发现输入功能，把它整理成设备说明、操作页面与判定规则，再交给 ART 在产线上逐台执行。
工程端实机演示：设备连接后，页面上的输入组件与状态指示线随按键、摇杆和传感器数据实时更新。
Authoring · ATH
从真实设备到可交付的产测项目。
不用等协议文档齐备：插上设备、按一按，就能得到可用的输入和测试序列；后面再逐步补齐设备说明和判定规则。
02
录制测试序列
按一次就录一步：编辑器记录操作员按下了什么，Rust 把它翻译成判定清单。按键、摇杆方向、扳机行程和整顶方向帽都能作为一步。
03
搭出操作页面
放入设备图片与输入组件，用状态指示线把组件连到图片上的位置。层级、透明度、文字大小、组合与锁定都随项目保存。
04
写清判定规则
规则只有一份，定义在项目的判定图里：先写需求，再排清单顺序，支持比较、区间与容差。也可以让外部智能体用 ath dr 编写与修订。
Production · ART
一台设备，一次测试。
工位不依赖窗口或前端轮询：设备什么时候插上、当前该做哪一步、判定结果是什么，都由 Rust 运行时给出。
等待设备
插入待测设备后，ART 按项目记录的 VID、PID 和产品名确认是不是这台产品，再决定能否开始。
按提示操作
屏幕给出下一步提示，并高亮对应组件与指示线；进度就是必选规则里已经满足的数量。
得到判定
每条规则由 Rust 判定，结果是 PASS、FAIL 或 PENDING。只有确认过的实机 PASS 才算通过。
换上下一台
通过后界面提示拔出设备，庆祝结束即自动开始下一轮；上一台的证据不会带到下一台。
- 测试未通过的一台，在拔出之前不会重新开始，避免把同一台当成两台记录。
- 设备中途断开或工位不可用时，ART 说明当前状态并提示联系工程人员，不会把设备问题记成产品判定。
- 收到数据、输入发生变化、测试通过是三件不同的事；界面与判定读的是同一份活动状态。
Project
一个项目，装下一条产测流程。
项目是一份普通目录，可以整体复制、交接和归档；同名项目按路径区分，不会互相覆盖，编辑历史与版本目录跟着项目走。
app.yaml：页面与组件
页面、区域和组件写在这里。每个组件绑定一个输入，可以带自己的提示语，也可以组合、锁定、调整层级。
设备说明：怎么读这台设备
有协议资料时整理成一份设备契约，固定 VID、PID、产品名与端点，一个说明对应一个产品；没有资料也可以从实机操作开始。
判定图：什么算通过
规则的唯一定义。引擎按需求、清单与不变式逐条比较设备读数，界面只显示同一份结果。
版本与日志：出问题查得到
项目保留版本目录与编辑历史；用户可见的失败同时写进 JSONL 日志，ath doctor --json 给出日志位置与最近的失败。
ATH · ART
一套项目，两个应用。
工程与产线各用各的界面，读的是同一个项目目录：同一份设备说明、同一套组件样式和判定规则。
ATH · 工程端工作台
ath- 观察输入、录制测试序列，不需要先有协议文档。
- 搭页面、图片、组合与状态指示线。
- 编写并验证判定规则，保存版本与来源。
- 把项目打包交付给产线。
ART · AgentX Test Runtime
art- 工程人员配置一次项目，之后每次启动直接进入工位。
- 一次一台上机：插入设备、按提示操作、拔出换下一台。
- 显示与 ATH 完全一致，但不提供编辑入口。
- 测试过程中不能替换项目配置，避免被判错产品。
Platforms
平台支持。
macOS
已发布：Apple Silicon（arm64）
ATH.app、ART.app 与 ath、art 命令行共用同一个项目版本，安装到「应用程序」和用户命令行目录，可直接运行。
Windows
已提供 x64 安装包：交叉构建，尚未真机验证
安装包由 macOS 交叉构建，包含桌面应用与命令行，可以安装试用，但还没有在 Windows 真机上验证过。
Linux
尚未构建
共用同一套 Rust 运行时与前端实现，快捷键按 Ctrl 绑定，目前没有发布产物。
代码同时覆盖 macOS、Windows 与 Linux。当前发布 macOS（Apple Silicon）与 Windows x64 的安装包；Windows 产物为交叉构建、尚未在真机上验证，Linux 尚未构建。未实测不等于不支持。
Install
一条命令，安装或更新 ATH 与 ART。
首次运行完成安装，以后运行同一条命令更新到最新发布版。桌面应用与命令行一起更新，沿用已有安装位置，保留项目、设置与测试结果。 macOS 只装其中一个可以加 --app ath 或 --app art。
macOS Apple Silicon 安装或更新
curl -fsSL https://agentx.plus/ath/install.sh | bashWindows x64 PowerShell 安装或更新
irm https://agentx.plus/ath/install.ps1 | iex安装脚本先下载并校验全部所选安装包，再替换程序；安装失败时保留或恢复旧版本。macOS 需要 Apple Silicon；Windows 需要 64 位系统，解压使用系统自带能力，缺少 WebView2 运行时会自动安装。安装过程不会改动已有项目文件； 应用正在运行时请先保存并退出，再运行安装命令。
FAQ
开始之前，先了解这些。
ATH 和 ART 分别做什么？+
ATH 是工程端工作台：观察输入、录制测试序列、搭页面、写判定规则并交付项目。ART 是产线工位：插入设备、按提示操作、得到判定、换上下一台。两者共用同一个 Rust 项目与运行时。
判定是自动的吗？+
是。规则写在项目里，设备读数由 Rust 判定引擎逐条比较，工位只显示结果：PASS、FAIL 或 PENDING。工位上没有人可以临时改判定，配置好的项目也不能在测试中途被替换。
需要先有协议文档吗？+
不需要。可以先从实机操作开始：边按边录，ATH 就能得到可用的输入与测试序列。拿到协议资料后，再整理成设备说明，把设备识别和读法固定下来。
ATH 会调用大模型吗？+
不会。ATH 不选择也不调用模型，只提供规范、项目事实、校验、写入与验证入口。外部智能体通过 ath dd、ath dr 生成和修订设备说明与判定规则，ATH 负责让结果可校验、可回滚。
支持哪些设备？+
设备能力来自项目里的设备说明，平台代码不为某个型号写死协议分支。仓库自带三个 HID 样本只用于回归测试，实际项目不限于这些产品。
现在可以在哪些平台使用？+
代码覆盖 macOS、Windows 与 Linux。当前发布 macOS（Apple Silicon）与 Windows x64 的安装包；Windows 产物为交叉构建、尚未在真机上验证，Linux 尚未构建。未实测不等于不支持。
ATH 与 ART 共用同一个 Rust 项目与运行时。
回到首页