首页 > 教程资讯 > 教程详情

Reticle 开源:让编码 agent 打开真实应用,核实「已完成」

AI 与前沿 极客小林 2026-10-21
文章分享

开源项目 Reticle 针对的是这样一种情况:编码 agent 写完代码就默认改动有效,却从不打开应用看一眼。据其 GitHub README,Reticle 会驱动正在运行的真实应用并读取实际发生的事,再返回「通过、失败、无法判断」三种结论之一,同时给出需要修改的 file:line。

它怎么做

Reticle 在应用中嵌入一个仅限开发环境的小型 SDK,编码 agent 通过它获得「看、操作、观察、断言」(look, act, observe, assert)四类工具。README 称,Reticle 从应用内部读取信息,因此能看到画面上看不出来的内容:点击发出了哪个请求、返回了什么,应用的状态,控制台输出,以及元素对应的源码行。

每次检查返回的 verified 字段取值为 yes、no 或 unknown(无法判断),并附上决定结论的请求、状态变化、控制台记录,以及需要修改的 file:line。只有 yes 才算通过;无法判断时返回 unknown 并给出原因。

状态读取方面,README 称 zustand 和 Redux 无需适配器,TanStack Query、Jotai、XState、Valtio、MobX、Recoil、Svelte stores、Pinia 等已提供适配。

流程重放与 CI 把关

验证过的用户流程可以保存,之后无需 AI 模型即可确定性地重放。reticle gate 命令用于 CI:如果一次改动涉及已保存流程的代码,却没有新的通过记录,这次改动就会被拒绝。

与 Playwright 的对比

README 认为,Playwright、DevTools 和浏览器 agent 都是从浏览器外部观察,适合不属于自己的网站;而对自己开发的应用,很多重要的 bug 不会体现在画面上,例如按钮静默返回 500、表单重复发出请求。README 建议两者配合使用。

项目自带的基准测试在受控应用中注入了 88 个 bug 的注册表,其中 86 个是真实回归,2 个是误报陷阱。按 README 的数据,Reticle 与 Playwright 脚本的总体结果为 85/88 对 59/88。这是项目方自测,可用仓库中的 node bench/pw-vs-reticle/run.mjs 复现。

安装与许可

安装需要 Node 20.11 以上、本地运行并带开发服务器的 Web 或桌面应用,以及支持 MCP 的编码 agent。Claude Code 用户可先用插件方式安装:

  • 添加插件源:/plugin marketplace add reticlehq/reticle
  • 安装插件:/plugin install reticle@reticlehq

许可方面,SDK、适配器、core 和 engine 采用 Apache-2.0;server 和 CLI 采用 FSL-1.1-ALv2,每个版本发布两年后转为 Apache-2.0。

数据与隐私

README 称,SDK 不进入生产构建,桥接服务只监听 127.0.0.1(默认端口 4400)。除非用户用 reticle connect 关联项目,或在 CI 中设置 RETICLE_API_KEY,否则应用数据不会离开本机;README 另称,Harness 驱动应用时,平台会看到其步骤,但秘密字段值不会离开本机。Reticle 默认会发送匿名使用计数,可用 reticle telemetry disable、RETICLE_TELEMETRY=0 或 DO_NOT_TRACK=1 关闭。

来源