SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI编程工具reticle

reticle

Reticle 是一款面向 AI 编程智能体的运行时验证工具。它能驱动真实运行中的 Web 或桌面应用，从内部读取点击、网络请求、应用状态、控制台等屏幕上看不到的信息，为智能体生成的代码给出 pass（通过）、fail（失败）或 cannot tell（无法判断）的明确结论，并附带 file:line 定位。它通过 MCP 与 Claude Code、Cursor、Codex、Windsurf、VS Code、Gemini CLI 等智能体协作，产物不会进入生产构建，适合需要验证 AI 修改真实性的开发场景。

访问官网

工具介绍

用途

Reticle 针对一个常见问题：AI 编程智能体可以生成代码，却常常默认改动已经生效，并不会打开应用亲自确认。结果是损坏的弹窗、静默的 500 错误、部署失败却提示成功等问题被交付出去，开发者只能事后手动点击排查。Reticle 的目标是让智能体在提交改动前真正验证运行中的应用。

主要能力

  • 给出结论而非截图：每次检查返回 verified: "yes"、"no" 或 "unknown"（无法判断），并附带决定该结论的请求、状态变化、控制台输出以及需要打开的 file:line。
  • 读取屏幕之外的信息：能获取与点击关联的网络响应、真实状态存储（zustand、Redux、TanStack Query、Pinia 等）、控制台错误、请求计数和 React 渲染情况。
  • 明确无法判断：只有 yes 才算通过；无法判断时返回 unknown 及原因，不会给出含糊的绿色通过。
  • 可重放流程：用户说“save that as a flow”后，一次调用即可确定性地重新验证该旅程，无需 AI 模型参与；旧功能不会因新修复而被悄悄破坏。
  • CI 门禁：reticle gate 会在改动触及已保存流程的代码但没有新的通过运行时使变更失败。
  • Harness（可选，在平台上）：描述一个人物与一段旅程，Reticle 会驱动它、逐步验证并保存通过的部分。
  • 页面内 HUD：可观察智能体的每个动作、每个结论、保存的流程以及用户固定给它的备注。
  • 智能体兼容：支持 Claude Code、Cursor、Codex、Windsurf、VS Code、Gemini CLI 及任何支持 MCP 的智能体；支持 Web（React、Next.js、Vue、Svelte、Angular 等）与桌面（Electron、Tauri）。

使用方式

安装：需要 Node 20.11+、一个本地带开发服务器运行的应用，以及支持 MCP 的编程智能体。运行安装器（macOS/Linux 或 Windows PowerShell 命令由官方提供），它会检查 Node 版本、全局安装 @reticlehq/server，并通过 reticle setup install 把 Reticle 的 MCP 服务器注册到本机找到的所有编程智能体。安装后需重启智能体一次以加载工具。

初始化：在应用所在文件夹运行 reticle init，它会检测框架、安装两个开发依赖（与 CLI 同版本）、写入 .reticle.json、将插件加入构建配置（仅开发环境注入连接调用）、写入 reticle-dev 开发模块、写入智能体指令（CLAUDE.md、AGENTS.md、RETICLE.md、.claude/commands/reticle.md），并在需要时启动开发服务器、打开应用等待连接。

验证：对智能体说“Verify the sign-up flow with Reticle.”，智能体通过 reticle_session 定位应用，用 reticle_act_and_wait 执行点击输入，返回带证据的结论。也可在终端对当前页面验证单个事实，退出码 0 仅代表 yes。会话结束时，包含检查的驱动会被保存为流程，之后无需模型即可重放。

连接与同步：reticle connect 会打开浏览器登录或创建免费账户，将该文件夹链接到 app.reticle.sh 上的项目并上传本机已有的运行记录；之后运行会自动同步，reticle status 可查看链接状态。

手动安装：官方提供完整手动步骤，包括安装 CLI、为各智能体（Claude Code、Cursor、Windsurf、VS Code、Codex CLI、OpenCode 等）注册 MCP 服务器。

适用场景

  • 让 AI 智能体在声称“完成”前实际验证 Web 或桌面应用中的改动。
  • 在 CI 中通过 reticle gate 防止已保存流程被悄悄破坏。
  • 需要确定性回归验证、不希望每次都调用 AI 模型的团队。
  • 需要观察应用内部状态与网络行为来定位问题的开发者。

限制与安全说明

  • 安全设计：生产构建不包含 SDK；桥接仅监听 127.0.0.1；除非链接项目，否则应用数据不会离开本机。默认发送匿名使用计数，可通过 reticle telemetry disable、RETICLE_TELEMETRY=0 或 DO_NOT_TRACK=1 关闭。Reticle 不会在页面中运行任意 JavaScript（没有 evaluate 工具），不会包含在生产构建中，也不会绕过客户端权限提示；捕获数据中的密码、令牌、卡号会替换为 [REDACTED]。
  • 来源与许可：开源，SDK、适配器、核心与引擎采用 Apache-2.0；服务器与 CLI 采用 FSL-1.1-ALv2（源码可见，两年后转为 Apache-2.0）。构建由 CI 签名，带 npm SLSA 溯源；无安装脚本；由 OpenSSF Scorecard 评分。
  • 预演与撤销：npx @reticlehq/server init --dry-run 不写入任何内容；--no-mcp 跳过智能体注册；--files-only 只写文件后停止。撤销时还原 init 列出的改动、移除两个开发依赖、删除 .reticle.json、.reticle/ 与 reticle-dev 文件即可。
  • 提交范围：上方编辑与 .reticle/flows/ 中保存的流程可提交，以便队友或 CI 重放；其余 .reticle/ 保持本地，因为会话日志包含请求体和页面文本。
  • 已知注意事项：安装后需重启智能体才能看到新工具；若开发服务器已在运行，需重启并刷新标签页；跳过 ⚠ 或 ℹ 提示可能导致“绿色”安装实际找不到任何内容。
  • 文档：快速上手见 docs.reticle.sh/quickstart，完整参考见 Manual install 与 Agent install。

同类工具

查看分类