e2e 是一款面向 Web 和移动端应用的端到端测试框架，旨在解决传统自动化测试编写门槛高、元素定位易失效的问题。它允许开发者直接使用自然语言描述测试目标，由内置的 AI 代理自动驱动界面完成操作流程，并结合传统断言机制在同一测试中验证结果。

核心特性：
– 自然语言驱动测试：只需输入人类语言的意图描述，AI 代理即可自动解析并在应用中执行对应操作，大幅简化测试用例编写。
– 智能录制与免模型回放：代理步骤在执行后会记录实际动作，下次运行时除非应用界面发生变更，否则可直接回放已录制的操作，全程无需调用 AI 模型以节省资源。
– 高度灵活的模型接入：支持按需提供自有订阅、API Key 或本地部署的模型；对于不包含代理步骤的传统测试用例，则完全不需要依赖任何模型。
– 跨平台双引擎支持：通过 Playwright 底层兼容 Chromium、Firefox 和 WebKit 浏览器引擎；同时提供基于 agent-device 的 iOS 与 Android 移动端仿真引擎。
– 完整生态工具链：内置 GitHub PR 评论报告器、云端容器化浏览器内核、云托管移动端模拟器，以及专用于受限语义动作与断言的决策模型执行器。
– 离线文档支持：官方技术文档会随主 SDK 一起打包至本地 node_modules 目录，便于编程 Agent 在无网络环境中实时查阅。

快速使用示例：
项目提供了极简的交互式初始化流程，开发者只需执行以下命令即可生成基础配置与示例测试文件：

npx e2e init

执行后，终端会引导选择 Web 或 Mobile 引擎类型及模型提供商，并自动输出可用代码。测试逻辑编写同样直观，例如：

import { test, expect } from 'e2e';

test('a member upgrades to Pro', async ({ app, agent, screen }) => {
  await app.open('/settings/billing');
  await agent.act('upgrade the workspace to the Pro plan');
  await agent.assert('the invoice preview shows a prorated amount');
  await expect(screen.getByRole('status')).toContainText('Pro');
});

更多环境变量配置、CI/CD 集成步骤及高级调试技巧，请参考官方文档进行安装与配置。

适用场景与目标用户：
该项目主要面向前端开发工程师、移动端 QA 测试人员以及 DevOps 工程师。特别适合以下场景：UI 迭代频繁导致传统 XPath/CSS 选择器大量失效的 Web 应用或移动 App；希望在不熟悉复杂自动化框架的情况下，快速落地标准化回归测试的研发团队；以及需要在每次 Pull Request 阶段自动拦截视觉与功能回退的持续集成流水线。配合其 GitHub 报告插件，也能无缝嵌入现有的 Git 工作流中。

总结：
e2e 成功将繁琐的脚本化 UI 测试转化为直观的自然语言交互模式，在保证断言精度的同时显著降低了自动化测试的维护成本。目前项目仍处于向 1.0 版本迈进的活跃迭代期，部分核心 API 与配置结构可能在次要版本发布时进行调整，建议访问其主页获取更详细信息。对于追求智能化、低维护成本自动化测试方案的工程团队而言，这是一个值得重点关注的新兴基础设施工具。