mirror of
https://github.com/tester-army/e2e.git
synced 2026-11-22 18:19:48 +08:00
Drops the QuickJS sandbox, the guest prelude, and the closed grammar. The code runs in the server's process on the objects a test body gets, with a recorder that writes down each test line. run_code now has a test file's authority; SECURITY.md and AGENTS.md say so.
314 lines
26 KiB
Plaintext
314 lines
26 KiB
Plaintext
---
|
||
title: 安全规则
|
||
description: 运行器对模型输入、工具调用、机密值、脱敏、会话、回放缓存、产物和网络连接执行的所有规则。
|
||
"og:image": "https://e2e.com/docs/images/og/reference/security.png?v=888009ffe4"
|
||
"twitter:image": "https://e2e.com/docs/images/og/reference/security.png?v=888009ffe4"
|
||
---
|
||
|
||
[安全](/security)指南解释了信任边界。本页按代码的实际执行方式列出其背后的规则。
|
||
|
||
## 参考
|
||
|
||
| 章节 | 涵盖内容 |
|
||
| --- | --- |
|
||
| [模型输入](#model-input) | 模型在每个步骤中读取的内容 |
|
||
| [工具调用](#tool-calls) | 内置工具和项目工具、节点 ID |
|
||
| [策略拒绝](#policy-denials) | 以 `POLICY_DENIED` 失败的调用 |
|
||
| [导航](#navigation) | 各入口允许的 URL 协议 |
|
||
| [请求凭据](#request-credentials) | `headers`、`basicAuth` |
|
||
| [站点检查](#site-check) | 子框架 |
|
||
| [填入机密值](#secret-fills) | `type_secret`、`fill(secret)` |
|
||
| [填入机密值后的截图](#screenshots-after-a-secret-fill) | 遮盖的范围 |
|
||
| [引擎选项中的机密值](#secrets-in-engine-options) | `basicAuth` 和其他引擎选项 |
|
||
| [脱敏](#redaction) | 模型输入、报告、下载、输出 |
|
||
| [脱敏的边界](#where-redaction-stops) | 变换后的值、视频、`command.log` |
|
||
| [下载](#downloads) | 应用提供的文件 |
|
||
| [会话](#sessions) | 保存的身份验证状态 |
|
||
| [缓存信任](#cache-trust) | 回放缓存文件和 `cache.store` |
|
||
| [产物](#artifacts) | 输出目录下的文件 |
|
||
| [出站连接](#outbound-connections) | 运行器连接的目标 |
|
||
| [MCP 和 explore](#mcp-and-explore) | MCP 会话、探索器的登录行为 |
|
||
|
||
### 模型输入
|
||
|
||
模型将应用内容作为引用的证据读取,与运行器策略和可信项目上下文分开。应用内容无法授予工具、凭据或更大的预算。[智能体步骤的工作原理](/agent-steps)完整介绍了一个步骤。
|
||
|
||
| 提示词中的内容 | 形式 |
|
||
| --- | --- |
|
||
| 你的指令和参数 | 引用在 `<instruction>` 中并标记为数据。`Secret` 参数只显示名称和用途。 |
|
||
| 屏幕 | 包含节点 ID、角色、名称、文本、测试 ID、链接目标和状态的无障碍树,按大小上限截断。不包含选择器。链接的查询字符串和片段只显示为 `?…` 和 `#…`。安全字段显示为 `value=<secure>`。 |
|
||
| 位置 | 当前 URL,经过脱敏且不含用户信息。判定在应用源内获取路径,在其他源获取完整 URL,并按大小上限截断。在设备上则为应用和屏幕标题。 |
|
||
| 截图 | 在需要或被请求时提供,且仅在引擎能证明安全字段已遮盖时提供。 |
|
||
| 先前步骤 | `agent.act` 接收来自同一测试或串行组的有限记录。判定只使用当前屏幕、屏幕位置、指令及其参数,以及智能体上下文。 |
|
||
|
||
### 工具调用
|
||
|
||
- 内置工具使用封闭的 schema,只有引擎支持时才会出现。声明字段的工具会拒绝未声明的键。不含字段的工具会丢弃额外键并运行。
|
||
- 项目工具必须使用带有 `execute` 的 `defineTool`,且不能替换内置名称。项目工具保留传给 `defineTool` 的 schema,因此是移除还是拒绝未声明的键,由该 schema 决定。
|
||
- 只有只读项目工具可以请求观测。
|
||
- 调用步骤未提供的工具,或向声明字段的内置工具传入未声明参数,都不会执行。模型会将拒绝信息作为调用结果读取并重试。
|
||
- 运行器绝不会将模型文本作为代码、选择器、Shell 命令或配置求值。唯一的例外是 MCP 服务器的 [`run_code`](/reference/mcp#run_code):它在服务器的 Node 进程中不受限制地运行编码智能体的 JavaScript,拥有测试文件的权限。智能体本来就可以编写并运行测试。`run_code` 返回的内容中,每个已配置密钥的原值会被遮盖,但代码本身可以读取应用显示的密钥,因此不要让你不愿托付项目文件和密钥的智能体连接。
|
||
|
||
| 失败代码 | 触发条件 |
|
||
| --- | --- |
|
||
| `CONFIG_LOAD_FAILED` | 加载配置时发现 `defineTool` 没有 `execute`。 |
|
||
| `INVALID_CONFIG` | 工具不是通过 `defineTool` 创建的,或名称与内置工具或测试执行框架工具相同。 |
|
||
| `LOCATOR_NOT_FOUND` | 节点 ID 不在当前屏幕上。操作失败,模型读取失败信息后再次操作。 |
|
||
|
||
### 策略拒绝
|
||
|
||
以下调用会以 `POLICY_DENIED` 失败。
|
||
|
||
| 被拒绝的操作 | 原因 |
|
||
| --- | --- |
|
||
| 导航到 `http:` 和 `https:` 以外的任何协议,`about:blank` 除外 | `file:`、`data:`、`javascript:` 和 `view-source:file:` 等包装协议会加载本地或内联内容。 |
|
||
| 格式错误的 URL | 不会进行任何修复。 |
|
||
| `Secret` 进入 JSON 输出位置 | 句柄不携带值,任何实际值都不得序列化。 |
|
||
| 使用 getter 或 `toHaveValue`、`toHaveText`、`toContainText`、`toHaveAttribute` 匹配器读取安全字段的值、文本或属性 | 应断言结果,而不是机密值。被隐藏的值经过脱敏,并非空值或不存在。 |
|
||
| `type_secret` 使用未声明的名称 | 只能填入步骤参数中声明的机密值。 |
|
||
| `type_secret` 填入禁用或不可编辑的节点 | 可接收值的节点为 `textbox`、`searchbox` 和 `combobox`。 |
|
||
| 向非密码字段填入密码 | 用途必须匹配。通用机密值可填入任何可编辑输入框。 |
|
||
| 会修改状态的项目工具请求观测 | 请单独调用观测。 |
|
||
| 像素被隐藏时使用 `vision: 'only'` | 没有可回退的内容。 |
|
||
| `browser.setCookies` 使用既非 `http:` 也非 `https:` 的 Cookie URL | 只有网页源可以存储 Cookie。 |
|
||
| 引擎无法证明所有安全字段均已遮盖时调用 `toHaveScreenshot()` | 不会保留截图。 |
|
||
| 智能体、执行器或 MCP `upload` 上传项目根目录外的文件、隐藏文件或隐藏目录下的文件 | 只有项目文件和 e2e 附带的示例文件(`sample:photo.png` 等)可以通过表单离开计算机。 |
|
||
| MCP `screenshot` 的 `path` 位于项目根目录外、是隐藏路径或位于隐藏目录下 | 会话只写入项目文件,绝不覆盖 `.git` 或 `.e2e`。 |
|
||
|
||
### 导航
|
||
|
||
| 入口 | 接受 | 拒绝 |
|
||
| --- | --- | --- |
|
||
| `app.open`、`browser.goto`、智能体的 `navigate` 操作 | `http:`、`https:` 和完全匹配的 `about:blank` | 其他所有协议 |
|
||
| 设置了 `app.linkBase` 的设备测试目标上的 `app.open(path)` | 拼接后的链接或绝对链接:应用自定义协议,或 `http:` 和 `https:` | `file:`、`data:`、`javascript:`、`view-source:`、`blob:`、`filesystem:` |
|
||
| `device.openLink` | 任意绝对 URL:应用自定义协议,或 `http:` 和 `https:` | `file:`、`data:`、`javascript:`、`view-source:`、`blob:`、`filesystem:` |
|
||
| `device.openApp`、`open_app` 工具 | 应用 ID | 链接 |
|
||
| `e2e login` 打开的浏览器 | `http:` 和 `https:` | 其他所有协议;改为打印链接,由你自行打开 |
|
||
|
||
- 运行器不会重新检查重定向,也不会连接弹出页面。注册 `browser.onDialog` 来处理浏览器对话框。
|
||
|
||
<Warning>
|
||
没有源白名单。智能体可以跟随应用前往其他站点,并在那里使用步骤中的机密值。
|
||
</Warning>
|
||
|
||
### 请求凭据
|
||
|
||
浏览器引擎将配置的请求凭据限定到精确的源:`app.url` 的协议、主机和端口,以及 `credentialOrigins` 列出的额外源。
|
||
|
||
| 选项 | 发送到 |
|
||
| --- | --- |
|
||
| `headers` | 从允许的源发起的每个请求 |
|
||
| `basicAuth` | 对允许的源发出的 `401` 质询的响应 |
|
||
|
||
- 同一主机的其他端口、子域名,以及 `vercel.app` 等共享域下的同级主机,都属于其他源。除下文说明的情况外,从那里发起的请求不携带 `headers`,来自那里的 `401` 也不会得到响应。
|
||
- `headers` 取决于请求最初发起的源。向允许的源发起的请求会在所有重定向中保留它们,无论重定向到哪个源。从其他源发起的请求不携带它们,即使重定向到允许的源也是如此。
|
||
- `basicAuth` 响应发出 `401` 的源。重定向到其他源,例如从 `http:` 到 `https:`,或从根域名到 `www`,不会得到响应,除非你列出了最终落点的源。
|
||
- 在 WebKit 中,如果允许的源使用其协议的默认端口(`https://staging.example.com`)或 IPv6 主机,`basicAuth` 会响应任何源的 `401`。WebKit 无法将凭据限定到此类源。
|
||
- 额外源必须是没有路径、查询字符串或片段的 `http:` 或 `https:` 源,例如 `https://api.example.com`。其他形式、主机中的 `*` 和端口 `0` 都会在加载配置时触发 `INVALID_CONFIG`。
|
||
|
||
### 站点检查
|
||
|
||
浏览器引擎通过比较主机名来判断哪些内容属于测试目标的站点。观测会排除其他站点的子框架和 `data:` 框架。
|
||
|
||
检查会在不使用公共后缀列表的情况下近似计算可注册域。`vercel.app` 等共享托管域会被视为同一个站点。
|
||
|
||
### 填入机密值
|
||
|
||
`Secret` 是不提供明文访问器的不透明句柄。有三处可以接收它:定位器的 `fill`、智能体步骤的参数,以及声明支持它的引擎选项。
|
||
|
||
```ts title="tests/stripe.e2e.ts"
|
||
import { secrets, test } from 'e2e';
|
||
|
||
test('connect Stripe', async ({ screen, agent }) => {
|
||
await screen.getByLabel('Secret key').fill(secrets.get('stripe-key'));
|
||
await agent.act('Connect Stripe with the given key', {
|
||
params: { apiKey: secrets.get('stripe-key') },
|
||
});
|
||
});
|
||
```
|
||
|
||
| 填入方式 | 解析值之前的检查 |
|
||
| --- | --- |
|
||
| 模型指示的填入(`type_secret`) | 步骤声明了机密值。机密值已配置。目标是最新观测中已启用、可编辑的输入框。密码填入密码字段。回放时重复这些检查。 |
|
||
| 确定性 `fill(secret)` | 不检查字段:测试代码已选择字段。仍会注册该值以进行脱敏。 |
|
||
|
||
运行器在主机上解析值并将其传给引擎。模型从不会看到或选择实际值。
|
||
|
||
### 填入机密值后的截图
|
||
|
||
填入机密值不会关闭截图。填入前后,模型、像素工具和运行器保留的产物都会获得相同的遮盖截图。
|
||
|
||
<Warning>
|
||
截图只遮盖安全字段。填入普通输入框的通用机密值会出现在图像中,应用在其他任何位置显示的值也一样,例如开启显示密码开关后显示的值。模型提供方也会获得该图像。请使用测试凭据,并像对待[视频](#where-redaction-stops)一样对待截图。
|
||
</Warning>
|
||
|
||
### 引擎选项中的机密值
|
||
|
||
引擎选项中的机密值,例如 `web({ basicAuth: { password: secrets.get(name) } })`,不属于填入操作。
|
||
|
||
```ts title="e2e.config.ts"
|
||
import type { E2EConfig } from 'e2e';
|
||
import { secrets } from 'e2e';
|
||
import { web } from '@e2e-dev/web';
|
||
|
||
export default {
|
||
targets: [
|
||
{
|
||
engine: web({
|
||
basicAuth: { username: 'preview', password: secrets.get('previewPassword') },
|
||
}),
|
||
app: { url: 'https://staging.example.com' },
|
||
},
|
||
],
|
||
secrets: { previewPassword: () => process.env.PREVIEW_PASSWORD ?? '' },
|
||
} satisfies E2EConfig;
|
||
```
|
||
|
||
- 运行器在每次尝试开始时于主机上解析它。
|
||
- 运行器注册该值及引擎从中派生的内容以进行脱敏。对于基本身份验证,派生内容是 `Authorization` 请求头中以 base64 编码的 `user:password`。
|
||
- 报告、`screen-at-failure.txt`、追踪记录页面、模型和 `e2e mcp` 会话读取的内容,以及文本下载中的该值都会脱敏。
|
||
- 截图和模型的像素仍然启用。如果页面在屏幕上显示密码,像素中的密码不会被遮盖。
|
||
|
||
### 脱敏
|
||
|
||
运行器会在以下内容中将每个已注册的机密值替换为 `<secret:name>`:
|
||
|
||
- 模型输入,包括项目工具结果、结构化文本字段,以及工具或引擎错误消息,
|
||
- 报告和追踪记录页面,包括跳过原因和 AI 追踪记录的工具结果,
|
||
- 文本下载,
|
||
- 你的代码在 `e2e run` 期间打印的内容:测试、配置和测试文件的顶层代码、测试过滤器和报告器。
|
||
|
||
即使以普通字符串而非 `secrets.get()` 句柄传入,以下位置中的值也会脱敏:测试和 `describe` 标题、步骤标签(`app.open` URL、定位器文本)、`fill`、`agent.act` 或 `agent.assert` 指令、`agent.act` 参数中的字符串、`agentContext`,以及 `e2e explore` 目标。
|
||
|
||
| 规则 | 详情 |
|
||
| --- | --- |
|
||
| 匹配形式 | 原始形式、JSON 转义、HTML 转义和百分号编码形式,不区分字母大小写(因此 CSS `text-transform` 无法隐藏它),以及合并空白后的形式。 |
|
||
| 截断文本 | 按长度上限截断的文本,如果以某个值的前 8 个或更多字符结尾,或以长度不足 16 的值的前半部分结尾,会被遮盖;支持原始形式和合并空白后的形式。 |
|
||
| 观测到的屏幕 | 每个字符串(名称、文本、值、测试 ID、属性、选择器、框架路径)都会在模型、执行器的树、回放缓存描述符或结束锚点读取之前脱敏一次。 |
|
||
| 标题 | 运行器收集测试文件时脱敏。测试 ID、`--grep`、报告器,以及产物和失败页面的文件名看到的都是 `<secret:name>`。两个只在机密值上不同的标题会形成重复的标题路径。 |
|
||
| 执行器 | 自定义执行器的 `ctx.step` 和内置智能体的提示词携带的是标记,因此只有句柄才能输入实际值。 |
|
||
| 配置输出 | 加载配置期间打印的输出在加载完成后才显示。如果加载失败,则不显示。 |
|
||
| 最小长度 | 短于 6 个字符的静态值会触发 `INVALID_CONFIG`。提供方返回此类值会使填入失败。 |
|
||
| 断言 | 不受影响。脱敏只改写运行器报告的内容。 |
|
||
| 缓存条目 | 机密值及其截断部分绝不会进入缓存条目。 |
|
||
|
||
### 脱敏的边界
|
||
|
||
脱敏依靠字符串匹配。以下内容不会被拦截:
|
||
|
||
- 经过变换的值,例如其最后四个字符,
|
||
- 整体编码后的值,例如哈希值,或文本[下载](#downloads)和测试过滤器的 `redact` 以外的 base64 编码值,
|
||
- 使用其他 Unicode 规范化形式的值,例如机密值采用组合重音字符,而文本采用分解重音字符,
|
||
- 删除值内部空白的文本。扩大空白的文本也会通过,但观测到的屏幕除外:如果字段合并空白后的形式包含该值,字段会保持合并空白并遮盖,
|
||
- 分散在多个节点中的值,例如 PIN 键盘上每个单元格一个字符,
|
||
- 关于某个值的“是”或“否”:`e2e mcp` 的 `locate` 计数会说明屏幕是否匹配智能体传入的文本,包括 `exact: false`,就像测试中的断言一样,
|
||
- 对截断文本规则而言,会改变长度的大小写映射(`ß` 显示为 `SS`),
|
||
- 机密值提供方返回的值,如果出现在标题、测试过滤器读取或发送的内容,以及 `e2e explore --changed-since` 简报中,因为这三者都在任何提供方运行之前脱敏,
|
||
- 嵌入宿主在内存中传入配置或测试时,在运行器自身进程中运行的测试的控制台输出,
|
||
- 截图,包括发送给模型的截图:它只遮盖安全字段,因此应用在其他位置显示的值会出现在图像中,
|
||
- 视频:不遮盖任何内容,并标记为 `redaction: "incomplete"`。托管浏览器或设备服务保存的录制留在该服务中,报告只包含其 URL,
|
||
- `e2e explore --changed-since` 简报中,某个值不足 8 个连续字符的片段,例如 git 单独输出一行的多行密钥的较短末行,
|
||
- `command.log`:运行器原样捕获应用输出。
|
||
|
||
### 下载
|
||
|
||
下载内容就是应用提供的内容。当会话知道某个机密值时,运行器会改写文本下载(`.txt`、`.csv`、`.json`、`.html` 或 `.htm`),并标记为 `redaction: "complete"`。以下内容会被替换为 `<secret:name>`:
|
||
|
||
- 该值的每次完整出现,
|
||
- 该值的任意 8 个或更多连续字符,无论是否合并空白,因此与该值有 8 个相同连续字符的无关文本也会被遮盖,
|
||
- 解码后符合上述任一条件的 base64 或 base64url 片段。
|
||
|
||
其他所有下载都原样保留,并标记为 `redaction: "incomplete"`:
|
||
|
||
- 任何其他扩展名,
|
||
- 不是有效 UTF-8 或无法改写的文件,
|
||
- 来自不掌握任何机密值的会话的下载。
|
||
|
||
### 会话
|
||
|
||
保存的会话包含身份验证状态。它还在同一密文中携带准备测试从提供方解析出的机密值。恢复会话的测试会对这些值脱敏。封装中包含未经加密但经过认证的机密值名称。
|
||
|
||
| 属性 | 值 |
|
||
| --- | --- |
|
||
| 位置 | [输出目录](/reference/config#output)下的 `sessions/<runId>/`(默认 `.e2e/sessions/<runId>/`),目录权限为 `0700`,文件权限为 `0600` |
|
||
| 加密算法 | AES-256-GCM,每次保存使用新的 12 字节 IV |
|
||
| 密钥 | 每次运行生成 32 个随机字节,仅保存在内存中。工作进程通过 IPC 接收,绝不经过磁盘或环境变量。 |
|
||
| 绑定到 | 运行 ID、测试目标、引擎名称和版本、平台及应用身份,全部作为附加数据进行认证 |
|
||
| 有效期 | 最长 24 小时;如果保存的状态声明了更早的到期时间,则提前过期 |
|
||
| 清理 | 运行结束时删除目录 |
|
||
|
||
运行器会拒绝无效、过期、缺失或不匹配的会话。参阅[会话错误](/reference/errors)。
|
||
|
||
### 缓存信任
|
||
|
||
缓存条目无需模型即可回放操作,且未经签名。
|
||
|
||
| 规则 | 详情 |
|
||
| --- | --- |
|
||
| 验证 | 每个条目在使用前都会验证。无效条目视为未命中。 |
|
||
| 文件名 | 预期键的哈希值。拒绝大于 1 MiB 的文件。 |
|
||
| 键 | 仅以脱敏文本的哈希形式包含智能体上下文。 |
|
||
| 内容 | 操作和脱敏后的摘要。回放只执行操作。其他输入值原样存储。 |
|
||
| 填入机密值 | 存储名称,并在回放时重新授权填入。 |
|
||
| 智能体 | 一个智能体录制的条目绝不会供另一个智能体回放。 |
|
||
| 起始屏幕 | 不以导航开头的条目只会在录制时的路由上回放:路径和查询字符串相同,忽略生成的 ID。应用自身源上的路由可匹配任何共享 `app.identity` 的部署。其他源上的路由会保留该源。参阅[缓存](/cache)。 |
|
||
| CI | 未显式设置的缓存模式变为 `read-only`,除非配置了 `cache.store`。 |
|
||
| Git | `e2e init` 会忽略 `.e2e/cache/`。如果你[提交录制内容](/cache#commit-the-replay-cache),请审查其中的操作和输入值。 |
|
||
| `cache.store` | 接收每个录制条目,并提供每个回放条目。返回的内容会再次验证。 |
|
||
|
||
### 产物
|
||
|
||
默认情况下,一次运行会写入 `.e2e/` 下。[`output`](/reference/config#output) 选项或 `--output` 可以更改位置。回放缓存仍位于 `cache.dir`,`command.log` 则写入你配置的项目相对路径。
|
||
|
||
| 路径 | 内容 | 脱敏 |
|
||
| --- | --- | --- |
|
||
| `report.json` | 运行记录。错误、推理摘录和操作摘要均经过脱敏器。 | 完整 |
|
||
| `results/<test>/trace.md` | 根据脱敏后的报告写入的追踪记录页面。 | 完整 |
|
||
| `results/.../*.png` | 安全字段已遮盖的截图。 | 完整 |
|
||
| `results/.../*.webm`、`*.mp4` | 视频,通过 `video` 或 `--video` 启用。 | 不完整 |
|
||
| `results/.../downloads/*` | 应用提供的文件。参阅[下载](#downloads)。 | 完整或不完整 |
|
||
| `results/.../screen-at-failure.txt` | 失败时经过脱敏的树。 | 完整 |
|
||
| `ai-trace.json` | 除测试过滤器之外的每次模型调用,通过 `--ai-trace` 启用。提示词是模型看到的脱敏版本。内联图像字节替换为其大小。 | 与提示词相同 |
|
||
| `sessions/<runId>/` | 加密会话,在清理时删除。 | 已加密 |
|
||
| `videos/<session>/*.webm`、`*.mp4` | `e2e mcp` 会话通过 `start_recording` 录制的视频,保留到你删除为止。绝不交给 `artifacts.store`。 | 无 |
|
||
| `cache.dir`(默认 `.e2e/cache/`) | 回放缓存条目。 | 设计上不含机密值 |
|
||
| `command.log` 中的路径 | 应用的标准输出和标准错误,原样保留。必须位于项目根目录内。 | 无 |
|
||
|
||
`artifacts.store` 会在每个产物生成时接收其字节内容,下载脱敏已在此之前完成,同时附带报告记录的 `redaction` 标签。
|
||
|
||
### 出站连接
|
||
|
||
| 目标 | 时机 |
|
||
| --- | --- |
|
||
| `eu.i.posthog.com` | 每次 CLI 调用,或 `e2e/runner` 中每次返回报告的 `run()` 或 `explore()`,发送一次遥测请求;此外 `e2e mcp` 提供的每个会话最多发送一次,除非你选择退出([遥测](/telemetry))。每次发送 `e2e feedback` 报告时发送一次请求;使用 `--dry-run` 或 `E2E_TELEMETRY_DEBUG`、报告缺少 `--repro` 的 Bug,或设置 `E2E_TELEMETRY_DISABLED` 或 `DO_NOT_TRACK` 时不发送。 |
|
||
| 你的模型提供方 | 调用模型的智能体步骤。确定性测试和完全回放的步骤不会调用模型。 |
|
||
| 订阅提供方的登录和模型列表端点 | `e2e login` 和 `e2e models`([订阅](/subscriptions))。 |
|
||
| 应用的 `readyUrl` | 对运行器启动的应用进行就绪探测。 |
|
||
| Playwright 浏览器下载 | 浏览器缺失时下载一次。 |
|
||
| `web({ connect })` 中的 DevTools 端点 | 每次运行该测试目标时。 |
|
||
| GitHub API | 仅来自 `@e2e-dev/github` 报告器。 |
|
||
| 你传入的 `model` 的提供方 | 仅来自 [`decisionFilter()`](/filters):提交更改的差异(只有工作区发生变化的文件仅发送名称)、测试文件,以及保存其会话的准备文件,按[文本下载](#downloads)的方式脱敏,但机密值提供方返回的值除外。 |
|
||
| `registry.npmjs.org` | 终端中运行的 CLI 命令每天最多发送一次请求,检查是否有更新的 e2e 版本。在 CI 中、标准错误被管道重定向时、执行 `e2e mcp` 和 `e2e upgrade` 时,以及设置 `E2E_UPDATE_CHECK_DISABLED`、`NO_UPDATE_NOTIFIER`、`E2E_TELEMETRY_DISABLED` 或 `DO_NOT_TRACK` 时跳过。每次运行 `e2e feedback` 发送一次请求,使用 `--allow-outdated` 或设置 `E2E_TELEMETRY_DISABLED` 或 `DO_NOT_TRACK` 时跳过。每次运行 `e2e upgrade`,为项目中以注册表版本列出的每个 `e2e` 或 `@e2e-dev/*` 包发送一次请求;如果包管理器设置了 `npm_config_registry`,则改为请求该地址;随后包管理器从自己的注册表安装。 |
|
||
| `api.limrun.com`(或 `LIMRUN_BASE_URL`)及其设备 | 仅来自 [`limrun()`](/integrations/limrun)。使用 `LIMRUN_API_KEY` 登录。 |
|
||
| Kernel API 及其托管浏览器 | 仅来自 [`kernel()`](/integrations/kernel)。 |
|
||
| TestMu AI 的 CDP 中心及其托管浏览器 | 仅来自 [`testmuBrowsers()`](/integrations/testmu#run-web-targets-in-browsers)。用户名和访问密钥只通过 CDP URL 传输,绝不出现在日志行中。 |
|
||
| `mobile-hub.lambdatest.com`、`mobile-api.lambdatest.com`(或 `TESTMU_API_ENDPOINT`)和 `manual-api.lambdatest.com` | 仅来自 [`testmu()`](/integrations/testmu#run-mobile-targets-on-devices)。使用 `LT_USERNAME` 和 `LT_ACCESS_KEY` 登录。每个会话中,agent-device 会在 API 目录中查找设备,将本地 `app` 上传到 `manual-api.lambdatest.com`,并在 TestMu AI 的 Appium 中心运行会话。提供方只在某次尝试录制视频时才向 API 请求会话视频。 |
|
||
| `hub-cloud.browserstack.com` 和 `api-cloud.browserstack.com`(或 `BROWSERSTACK_API_ENDPOINT`) | 仅来自 [`browserstack()`](/integrations/browserstack)。使用 `BROWSERSTACK_USERNAME` 和 `BROWSERSTACK_ACCESS_KEY` 登录。每个会话中,agent-device 会在 App Automate API 中查找设备、上传本地 `app`,并在 BrowserStack 的 Appium 中心运行会话。对于 `https` `app`,提供方让 API 每次运行获取一次构建产物,并只在某次尝试录制视频时向 API 请求会话视频。 |
|
||
| `api.e2b.app` 及其沙盒(或 `E2B_DOMAIN`、`E2B_API_URL`、`E2B_SANDBOX_URL`) | 仅来自 [`e2b()`](/integrations/e2b#run-android-targets) 和 [`e2bBrowsers()`](/integrations/e2b#run-web-targets-in-browsers)。使用 `E2B_API_KEY` 登录。引擎通过 `127.0.0.1` 上的隧道访问各沙盒的 agent-device 或 Chromium([沙盒如何保持私有](/integrations/e2b#how-the-sandboxes-stay-private)),`e2b()` 也通过该隧道发送 `.apk`。每个 Android 沙盒在缺少 Node 时从 `nodejs.org` 下载 Node,并从 npm 安装 agent-device。 |
|
||
| Expo API 和模拟器的 agent-device 守护进程 | 仅来自 [`expoSimulators()`](/integrations/eas) 或其已弃用的别名 `easSimulators()`。使用 `EXPO_TOKEN` 登录,否则使用 `~/.expo/state.json` 中的 eas-cli 登录信息。在 CI 运行器上,设置 `EXPO_TOKEN`,或不要在运行器的主目录中保留该登录信息。 |
|
||
| `mcr.microsoft.com` | 仅来自 [`smol()`](/integrations/smol),用于拉取 Playwright 镜像。随后机器拥有不受限制的网络访问权限,并可通过 `host.smolvm.internal` 访问你计算机回环地址上的每个端口,而不只是 `hostPorts`([配置提供方](/integrations/smol#set-up-the-provider))。 |
|
||
| 包注册表 | `e2e init` 安装依赖项时。 |
|
||
| 被测应用 | 每次运行,以及应用自身加载的任何内容。 |
|
||
|
||
<Note>
|
||
没有崩溃报告。`--ai-trace` 写入本地文件,不会上传。你的测试代码、插件和应用可能发起更多连接。
|
||
</Note>
|
||
|
||
### MCP 和 explore
|
||
|
||
| 命令 | 规则 |
|
||
| --- | --- |
|
||
| `e2e mcp` | 使用 stdio,并采用与测试运行相同的操作授权。默认允许打开四个会话([`--max-sessions`](/reference/mcp),范围 1 到 16)。关闭空闲会话。`open_session {engine}` 加载智能体指定的已安装包,并调用指定的导出。与配置中的导入一样,这些代码拥有服务器的全部权限。`engine` 只能指定包,不能指定路径或 URL,服务器不会安装任何内容。 |
|
||
| `e2e explore` | 向每个步骤提供所有已配置的凭据。探索器可以看到账号名称和用户名。密码始终是句柄,需要支持敏感值填入的引擎;没有此类引擎时,探索器会跳过密码。没有凭据时,它可能使用编造的测试凭据登录,并以纯文本输入。 |
|
||
| `e2e explore --changed-since` | 向模型发送从基准提交起的提交消息、已更改文件名和已提交补丁,并截断以适应上下文。未被任何提交更改的文件(例如 CI 写入的文件),以及已提交文件后续的本地修改,只发送名称,不读取内容。配置以字符串形式提供的机密值及其连续 8 个或更多字符的片段会脱敏。机密值提供方返回的值,以及已提交到仓库但未在配置中命名的机密值,会传给模型。 |
|