CodeBuddy-H5自动化测试工具

文件说明（技能包结构）

e2e-test-framework/

├── SKILL.md # 给 AI 的工作流指引（触发条件、初始化、5大能力、排查）

├── scripts/

│ └── init_project.js # 一键初始化：复制模板 + npm install

├── assets/

│ └── project-template/ # 完整测试框架模板（15+ 核心脚本 + 配置 + 示例 collection + 72项主规范）

│ ├── run-e2e.js # 统一入口（闭环）

│ ├── ui-deep-scan.js # 深度 UI 扫描（菜单遍历 / iframe 登录 / 人机验证识别）

│ ├── generate-ui-scan-report.js # UI 扫描报告（可视化）

│ ├── run-quality-gate.js # API 质量门禁

│ ├── generate-compliance-table.js # 规范达标表

│ ├── test-config.json # profiles 配置

│ ├── package.json # 依赖声明

│ ├── sessionLiveV4 / casp2026 示例 collection

│ └── reports/generate/ # 主规范数据（72 项）

└── references/

├── FRONTEND_TESTING_GUIDE.md # 前端站点测试 SOP

├── QUALITY_SPEC.md # API 质量门禁规范

└── CHANGELOG.md # 框架变更记录

e2e-test-framework 技能 — 安装说明

> 适用：把本技能（`e2e-test-framework.zip`）安装到另一台电脑的 CodeBuddy 中使用。

> 技能用途：对任意测试 URL/页面自动完成 API 质量门禁 + 前端 UI 深度测试，产出 5 份 HTML 报告。

• --

一、需要准备的东西

| 文件 | 说明 |

|------|------|

| `e2e-test-framework.zip` | 本技能包（约 132KB），复制到新电脑即可 |

• *目标电脑前置条件：**
• 已安装 **CodeBuddy**
• 已安装 **Node.js 18+**（框架基于 Node 运行）
• 能联网（首次需 `npm install` 和下载浏览器）

• --

二、安装技能（让 CodeBuddy 识别）

1. 把 `e2e-test-framework.zip` 复制到新电脑，**解压**，得到一个文件夹 `e2e-test-framework/`。

2. 把这个文件夹放到 CodeBuddy 的**用户技能目录**：

• **Windows**：`C:\Users\<你的用户名>\.codebuddy\skills\`
• **macOS / Linux**：`~/.codebuddy/skills/`
• 如果目录不存在，手动新建 `skills` 目录。

3. 完成后目录结构应类似：

```

C:\Users\<你>\.codebuddy\skills\e2e-test-framework\

├── SKILL.md

├── scripts\

├── assets\

└── references\

```

4. **重启 CodeBuddy**，让技能被加载。

5. 验证：向 CodeBuddy 提问「用 e2e-test-framework 技能测试一个页面」，若它能识别并调用，说明安装成功。

> 💡 另一种方式：把技能文件夹直接放到**项目级**技能目录 `.codebuddy/skills/`（仅该项目可用）；用户级 `skills/` 则对所有项目可用。推荐用户级。

• --

三、初始化测试项目（新电脑首次使用）

在任意想放置测试框架的**工作区目录**执行：

```bash

1. 用技能内置脚本初始化（自动复制所有脚本 + npm install）

node <技能目录>/scripts/init_project.js <你的项目目录>

示例（Windows，技能在用户目录，项目放在 jenkins_workspace）：

node C:\Users\<你>\.codebuddy\skills\e2e-test-framework\scripts\init_project.js C:\jenkins_workspace\posteman-tests

```

• 脚本会自动把 `assets/project-template/` 下的全部脚本/配置复制到项目目录，并执行 `npm install` 安装依赖（playwright、newman、iconv-lite 等）。
• 若已存在同名文件（如 `test-config.json`），会**保留你已有的**，不覆盖。

如果不想用脚本，也可以手动把 `e2e-test-framework/assets/project-template/` 里的文件复制到项目目录，然后：

```bash

npm install

npx playwright install chromium

```

• --

四、首次验证框架可运行

```bash

cd <你的项目目录>

node run-e2e.js --profile sessionLiveV4 --no-block

```

• `--no-block`：跳过 API 门禁阻断（调试用），让流程走到底。
• 跑完检查 `reports/sessionLiveV4/` 下是否生成 5 份 HTML 报告：

`sessionLiveV4-report.html`、`quality-report.html`、`checklist.html`、`规范达标表.html`、**`UI扫描报告.html`**。

• --

四·五、如何向 CodeBuddy 下达测试指令（给使用者的话术）

> 装好技能后，**不需要手动改脚本**。直接向 CodeBuddy 用自然语言下达指令，它会按 SKILL.md 的流程自动完成。

> 下面是最推荐的话术模板，把 `[ ]` 里的内容换成实际值即可。

✅ 完整闭环测试（最常用）

```

按 e2e-test-framework 技能，测试这个新页面：

• 测试 URL：https://[站点域名]/[路径]/index.html
• 报告名（profile）：[页面名，如 conf2027]
• 登录账号：[手机号] / [密码]
• 页面类型：不确定，请自动判断（或写「C端前端官网」/「管理后台」）

```

示例：

```

按 e2e-test-framework 技能，测试这个新页面：

• 测试 URL：https://www.eventomeeting.com/casp2027/index.html
• 报告名：casp2027
• 登录账号：18900000000 / Abc123456
• 页面类型：C端前端官网

```

CodeBuddy 收到后会：新增 profile → 判断类型 → 跑 `run-e2e.js` → 产出 5 份报告。

✅ 仅深度 UI 扫描（不测 API 门禁）

```

按 e2e-test-framework，只对这个 URL 做深度 UI 扫描，不要跑 API 门禁：https://...

```

✅ 生成/查看某页面的 UI 扫描报告

```

按 e2e-test-framework，生成 [页面名] 的 UI 扫描报告，并告诉我结果。

```

✅ 处理已存在的页面（重新跑/补报告）

```

按 e2e-test-framework，重新跑一遍 [页面名] 的完整测试，并汇总结果。

```

• --

四·五·二、遇「登录+滑块」页面的操作（同事必读）

> 如果被测页面登录时**弹滑块拼图验证**（C端前端官网常见，如会议官网），纯自动化过不了。

> 框架已内置「交互式登录」：**脚本自动打开登录页、填好账号密码、点登录，弹出一个真实浏览器窗口，

> 你只需手动滑一下滑块，脚本检测到登录成功后会自动继续跑完所有测试。**

触发方式（对 CodeBuddy 说）：

```

按 e2e-test-framework 测试 https://[站点]/[路径]/index.html，报告名 [页面名]，登录账号 [手机号]/[密码]。

该页面登录有滑块验证，请用交互式登录。

```

你会看到的流程（3 步）：

1. **窗口自动弹出** → 脚本已自动：打开页面、点「个人注册/投稿入口」、填好账号密码、点了登录。

2. **你只需把滑块向右拖到缺口松手**（唯一需要你操作的）。

3. 脚本检测到登录成功 → **自动继续跑后续所有测试** → 产出 5 份报告。

手动执行的等价命令：

```bash

一步到位：自动打开→填号→点登录→弹窗等滑滑块→登录成功→自动继续测试

node run-e2e.js --profile <页面名> --login-interactive --no-block

若站点无「退出/个人中心」字样、脚本检测不到登录成功，加 --force：

node run-e2e.js --profile <页面名> --login-interactive --force --no-block

```

注意事项：

• ⚠️ `--login-interactive` 需要**有桌面的电脑**（能弹真实浏览器窗口供滑滑块）。
• 登录态会存到 `auth-state.json`，之后可用 `--skip-login` 直接复用（无需再滑滑块）。
• 登录态有**有效期**，过期后重新跑一次 `--login-interactive` 即可。

> 💡 **一句话记住**：把「URL + 报告名 + 登录账号」丢给 CodeBuddy，说"按 e2e-test-framework 测试，有滑块用交互式登录"，它就会照做——**你只需滑一下滑块。**

• --

五、日常使用

测一个新页面（完整闭环）

1. 编辑 `test-config.json`，新增一个 profile：

• 判断页面类型（见 SKILL.md「Capability 5」）：
• **管理后台**（独立 JSON API）→ 不设 `skipApiGate`
• **C 端前端官网**（Vue 多页/iframe 登录）→ 设 `skipApiGate: true` + 配 `login.phone/password`

2. 运行：

```bash

node run-e2e.js --profile <新页面名> --no-bloc