Tester Army e2e 端到端测试框架

它是什么

e2e 是 TesterArmy 做的端到端测试框架，用于网页和移动应用。一个测试里可以写精确的定位器检查，也可以写交给智能体去完成的自然语言目标，或者两者都写。这个条目讲的是它和你的编程智能体打交道的那部分。一个技能教 Claude Code、Codex 或 Cursor 怎么用 e2e。一个 MCP 服务器让智能体在你的应用上开一个实时会话，跟踪页则告诉它一次失败的测试里发生了什么。智能体在运行中的应用里走一遍流程，边走边把每一步写进测试。

1. 你用平常的话描述一个目标
2. 智能体操作应用去达成它
3. 随后由屏幕上的一项检查确认结果
4. 这次运行记下智能体做了什么
5. 下次运行直接回放，不调用模型，直到应用有变化

适合谁

做网页或移动应用的开发者，想让编程智能体来写、来修 UI 测试，并在运行中的应用里检查它自己改过的界面。手上有 Playwright、Cypress、Selenium、Detox 或 Maestro 测试套件的 QA 工程师，可以一次迁一小块过来。1.0 版还没发布，README 说 API 和配置在小版本之间仍可能变。

如果你需要稳定的 1.0 API，或者你在 Windows 上又不打算用 WSL，可以不用它：快速入门说要在 WSL 里运行 e2e。

用在哪里

TesterArmy 的文档给三个编程智能体写了完整步骤，另外指定了一个技能文件夹，还有好几个智能体会读它。

• Claude Code：技能、制作方插件市场里的插件，以及 MCP 服务器
• Codex：技能、同一个插件，以及写在 .codex/config.toml 里的 MCP 服务器
• Cursor：技能、放在本地插件文件夹里的插件，以及写在 .cursor/mcp.json 里的 MCP 服务器
• Copilot、Gemini CLI、OpenCode 和 Zed：放在 .agents/skills/ 里的技能，CLI 参考文档说它们会读这个文件夹
• Grok Build：文档说它会读取 Claude Code 的插件文件

测试可以在浏览器里跑（通过 Playwright 驱动 Chromium、Firefox 和 WebKit），也可以在 iOS 模拟器、Android 模拟器和连到你电脑上的手机上跑。

如何设置

点“获取”会把一个装有 Mindket 安装说明的 zip 压缩包存进你的下载文件夹，里面按 TesterArmy 的文档列出了每个智能体的步骤。主要途径是在你的应用目录里运行设置向导。

1. 运行安装命令。向导会问你用哪个引擎、哪个模型提供方，以及技能和 MCP 配置放在哪里，并在写入任何文件之前列出全部改动。
2. 启动应用的开发服务器，或者在 e2e.config.ts 里设置它的地址和启动命令。
3. 运行示例测试。它不调用模型，所以不需要密钥。
4. 注册 MCP 服务器。向导会询问是否为 Claude Code 写入 .mcp.json、为 Cursor 写入 .cursor/mcp.json。Codex 要手动添加。
5. 如果你给智能体步骤选的是订阅，就登录一下，比如用 npx e2e login openai。

npx e2e init
npx e2e run

MCP 服务器从项目自己安装的 e2e 运行，所以要先跑向导并完成它的安装。手动添加的话，Claude Code 用下面这行，Codex 则把服务器写进 .codex/config.toml。

claude mcp add --scope project e2e -- npx e2e mcp

[mcp_servers.e2e]
command = "npx"
args = ["e2e", "mcp"]

如何使用

用平常的话跟智能体说。MCP 服务器页面给了下面这些提示词，还说加上“headed”就会显示本地浏览器或模拟器。

Add a Remember me checkbox to the login form. Check it in the app with e2e.
Write a test for checkout while you walk it in the app.
Reproduce issue #123 in the app and record a video.

反复修改时，智能体只跑它正在处理的那个测试，按 test( 开头所在的行号来跑。一次失败的运行会在 .e2e/results/ 下写一个跟踪页，里面有失败的那一行、每一步、断言读到的值、控制台错误和失败的请求。智能体读这个页面，把它涉及的每一行都修好。

示例

你在做一个有登录表单和结账流程的应用，MCP 服务器已经注册好。你输入：

Write a test for checkout while you walk it in the app.

智能体开一个会话，在实时屏幕上一步步操作。每个动作都会回复一行能重复这个动作的测试代码。MCP 页面给出的回复是这个样子：

Tapped #n31.
Test line: await screen.getByRole("button", "Sign in").tap();

智能体把这些行复制进 tests/checkout.e2e.ts。像“加入最便宜的商品”这样的目标，会写成一个 agent.act 步骤，后面跟一个 expect。你拿到的测试文件里，定位器那几行都在实时屏幕上核对过，而且可以按行号重新运行。

新手与专家

新手：端到端测试像人一样使用你的应用：打开页面、输入、点击，再检查显示了什么。手写的话，这类测试就是一串选择器和等待语句。用 e2e，你用文字写下目标，由智能体去完成。文档说界面改了智能体会跟着调整，所以要修的测试更少。屏幕上的检查一旦通过，这次运行就会记下智能体做了什么，之后不调用模型直接回放。先在一个小应用里跑一遍向导。示例测试不需要密钥。

专家：只有后面的某个验证通过了，才会写入录制：定位器匹配器、像 toHaveURL 这样的引擎断言、locator.waitFor() 或 agent.assert。用 textContent() 或 expect.poll 读取一个值不算数。录下的控件对不上时，回放从不瞎猜。它会把这一步剩下的部分交给智能体，由智能体从当前屏幕接着完成，这次运行还可以保存新的录制。只有 agent.act 会回放。文档说 agent.assert、agent.waitFor 和 agent.extract 每次都实时运行。

给测试改名或改写目标，都会让它的录制对不上。技能要求智能体在修测试时保持缓存开启、关掉重试，因为重试会把每个目标都实时跑一遍。测试通过后，它再用 --no-cache 跑一次，确认实时运行的智能体仍能达成每个目标。

除了测试，e2e explore 给智能体一个目标而不是测试文件，然后报告它发现的问题。bug bash 会同时跑好几个这样的探索，一次四个，每个负责一份测试章程（charter）。只有复现测试失败了，智能体才会保留那条发现。每次会话都会消耗模型调用。@e2e-dev/acp 包可以通过 Agent Client Protocol 在 Claude Code 或 Codex 上运行智能体步骤，用的是这个智能体自己的登录，并把它限制在 e2e 的步骤工具里。

注意事项

e2e 大部分在你的电脑上运行，有几条路径会连到外面。

• 你的权限：测试、配置、引擎和应用命令都以你的操作系统权限运行，没有沙箱。文档说，不可信的拉取请求代码要放到外部沙箱里跑，并且不给任何密钥
• 使用数据：除非你选择退出，CLI 会把匿名使用数据发给 eu.i.posthog.com 上的 PostHog。文档说其中从不包含测试内容、应用内容或凭据。用 npx e2e telemetry disable、E2E_TELEMETRY_DISABLED=1 或 DO_NOT_TRACK=1 可以关掉它。在 CI 里，只有这两个环境变量能关掉它
• 其他请求：npx e2e feedback 只在你运行它时才发送报告，技能会让智能体先给你看 dry run 的结果。在终端里运行的 CLI 命令最多每天向 registry.npmjs.org 查询一次有没有新版本
• 模型提供方：智能体步骤会把你的指令、以无障碍树表示的屏幕和脱敏后的 URL 发给你配置的模型。截图只遮住安全输入框，所以输进普通输入框的密钥会到达提供方。请用测试凭据
• 其他网站：文档说没有来源白名单，所以智能体可以跟着应用跳到别的网站，并在那里用上某个步骤的密钥
• 托管选项：Kernel、TestMu AI、BrowserStack、Limrun 和 EAS Simulators 这几个包在服务商那边运行浏览器或设备，所以每个都要该服务的密钥，流量也会发到那里。smol 包在你的电脑上运行虚拟机，它的文档说这些虚拟机能访问你电脑上的任何回环端口
• 文件：init 会修改 package.json 和 .gitignore，并写入一份配置、一个测试、技能副本和 MCP 配置。缓存的录制会原样保留输入的值（密钥填写除外），所以提交进仓库的录制要像测试代码一样审查
• 真实网站：bug bash 页面说，不要在别人也在用的已部署网站上改数据
• 卸载：文档没有给出卸载步骤。Mindket 的说明列出了 init 写入的内容，你可以手动移除
• 许可证：Apache-2.0。LICENSE 文件没有写版权所有者，NOTICE 文件写的是“Copyright 2026 TesterArmy, Inc.”