常见问题

命令行目录不在 PATH 里。macOS 检查 ~/.local/bin，Windows 检查 %LOCALAPPDATA%\AgentX TestHub\bin；改完需要新开终端。安装脚本会提示它写过哪一个文件。

日常使用不需要：观察设备、编辑项目、跑判定、上产线都在本机完成。只有安装与更新需要访问 agentx.plus；命令行里只有 ath generate 与 ath agent 会调用模型。

不需要。可以先从实机操作开始，边按边把输入和测试序列录下来；协议资料用于把设备识别与解析固定下来， 写成设备说明。

判定由 Rust 按项目里的规则给出，工位上没有任何入口可以改规则或替换项目配置。要调整判定， 回到 ATH 改项目并重新交付。

FAIL 表示某条规则被违反；PENDING 表示还有条件没有满足、也没有被违反，即「还没结论」。 命令行上两者用不同的退出码区分（4 与 2）。

失败的一台在拔出之前不会重新开始，避免把同一台当成两台记进产量。需要重测时先拔下设备， 让工位回到等待状态再插入。

项目带锁文件，同时写入会被阻止。通过命令行的规则提交还带乐观锁：提交时摘要与读取时不一致会被拒绝， 提示你重新读取后再提交。

项目是普通目录，理论上可以，但并发编辑与网络中断都会放大风险。建议每个人本地一份， 用版本快照与 Git 之类的工具同步。

项目内容不用改：整个目录复制过去即可。需要在新的机器上重新指一次项目路径 —— ATH 记的是 「当前打开的项目」，ART 记的是「工位配置的项目」。

按天滚动，保留最近 14 份；写入跟不上时会统计丢弃行数。需要长期保存的证据请另行归档， 例如把报告与发布包一起存起来。

可以安装试用：x64 安装包已提供，但由 macOS 交叉构建，尚未在 Windows 真机上验证。 遇到问题时用 art diagnostic --json 与日志上报。