Agent Qa

🤖双子座QA com编剧MCP

此存储库包含在目标 Web 应用程序上运行高级 E2E 测试所需的配置和上下文，使用 Gemini Code Assist （代理模式） 和 Playwright Model Context Protocol （MCP）。

该代理被配置为自动执行功能、回归（日期/变量）和接口质量（响应性/a11y/XSS）测试。

⚙️ 先决条件 要运行代理，您需要安装：

Node.js（LTS 或更高版本）：Gemini CLI 和 Playwright MCP 需要。

npm（Node Package Manager）：通常包含在 Node.js 中。

Git：用于克隆此仓库。

Google 帐户：验证 Gemini CLI。

Gemini Code Assist / Gemini CLI：全球安装的代理工具。

🚀 1. 设置和安装 在终端（CMD 或 PowerShell）中按照下面的步骤来准备环境。

步骤1.1：克隆仓库 Bash

1. 将此仓库克隆到您的计算机

cd gemini-agente-e2e

2. 访问项目目录

cd gemini-agente-e2e

步骤 1.2: 安装基本工具 安装 Gemini CLI（全局）和 package.json 中定义的本地依赖关系（Playwright MCP）。

Bash

安装 Gemini CLI（如果尚未安装）

npm install -g @google/gemini-cli@latest

安装 Playwright MCP 依赖项

npm install

安装浏览器二进制文件（Chromium，Firefox，WebKit）

npx playwright install

双子座牛仔队

Digite "Gemini" no seu cmd

步骤 1.3：双子座身份验证 在您的计算机上首次使用 gemini 时，您必须验证：

🛠️ 2. 设置代理和MCP 为了让 Gemini 使用 Playwright，它需要一个配置文件。

步骤 2.1: 创建全局配置文件 （settings.json） 您需要在用户目录中创建此文件才能配置 MCP 服务器 。

Windows 位置： C:Users\.geminisettings.json

settings.json 内容：

粘贴以下代码。它配置 Playwright MCP 并删除无头模式（--headless），以便您可以查看运行：

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
        // O modo visível (non-headless) é o padrão sem o argumento --headless.
      ]
    }
  },
  "security": {
    "auth": {
      "selectedType": "oauth-personal"
    }
  }
}

步骤 2.2: 代理上下文 （GEMINI.md） 此项目的根文件 GEMINI.md 包含复杂测试的整个上下文。代理会自动读取它以了解选择器（如“库存”按钮的选择器）和高级测试规则。

⏯️ 3. 执行E2E测试 要运行 GEMINI.md 中定义的复杂 E2E 测试，请按照以下步骤操作：

步骤3.1：启动Gemini CLI（或IDE中的代理模式） Bash

在工程文件夹中启动 Gemini CLI

双子座 步骤 3.2：确认 MCP 加载 在 Gemini CLI 中，检查服务器状态：

/mcp 输出必须是 ：🟢 剧作家 - 准备 (XX 工具)

步骤3.3：开始测试 请求代理通过引用上下文文件执行“库存”测试 ：

代理，按照我的GEMINI.md详细说明，运行完整的登录流和库存生成测试。请记住，查看是强制性的。 代理将提出行动计划（10个功能步骤+非功能验证）。批准第一步（y）将强制打开浏览器，并开始可见的运行。

🔒 安全性（ 忽略文件） Git 会忽略以下文件（通过 .gitignore），因为它们包含依赖关系或敏感数据：

节点模块/

.gemini/ （包含您的私人settings.json和令牌）

测试结果和日志文件（/test-results，/playwright-report）