用途:在无人值守或 CI 环境中对 Web 应用进行端到端验证,不等待人工打开浏览器或重启客户端,最终给出 verified、失效原因或明确死路。
安装与埋点:运行 export RETICLE_INSTALL_SOURCE=npx_skill 与 npx -y @reticlehq/server@latest init。init 幂等,需读取报告:若出现关于构建配置的警告,说明接线未生效,应自行完成打印出的修改;若提示版本回退,说明 SDK 与守护进程需保持一致。
运行方式:若已有 reticle_* 工具则用其驱动,证据最好且带源码映射;若没有,改用 CLI,npx @reticlehq/server verify <url> 不依赖 MCP。工具不在且不想重启时,可用 reticle_run 调 reticle_lease 的 acquire 自行打开浏览器。
执行流程:从 package.json 读取 dev 脚本,后台启动并按脚本隐含端口轮询,已有服务则复用;init 后必须重启开发服务器。用 reticle_session 的 list 确认会话,有会话即证明连接成功。判定时先声明后果,再用 reticle_act_and_wait 断言应用行为而非界面显示,可检查网络响应体。
判定读取:verified 为"yes"即证明通过;"no"表示应用或预期有误,二者都是结果;"unknown"不是通过,不可拔高或弱化断言。未使用 act_and_wait 或 assert 的驱动没有结果。CLI 的退出码 0 才是通过,若无已保存流程则未检查任何内容。
适用场景与限制:适合目标模式智能体、CI 与审批受限客户端。遇到工具缺失但存在已保存流程、端口监听但会话列表为空、outcome_unread、lease 加载但不连接等情况,应停下并说明具体原因。反馈可通过 reticle_session 的 feedback 或 CLI feedback 提交。