网页自动回归测试安装和使用

你只需要做两件事：在项目里安装 dh-cm-web-e2e，然后告诉 AI 要固化哪条业务流程。查看代码、生成测试、打开浏览器和整理报告都由 AI 完成。下文以 Qoder 为例。

这套能力用于固定测试环境，由用户手动发起，不会自动加入发布流程。

先选对工具

• 改完代码测一测、拿一份带截图的报告：用 dh-cm-qa-flow。AI 直接操作页面，不写测试代码，大多数场景用它就够。
• 核心流程要长期、稳定、反复回归：用本页的 dh-cm-web-e2e，把流程写成 Playwright 用例提交到仓库。QA Flow 测通过的用例可以直接作为它的输入。

第 1 步：安装 dh-ai

电脑需要有 Node.js 16 或更高版本。打开终端，先检查版本：

node -v

设置公司 npm 源。这条命令只需执行一次：

npm config set @szhn:registry https://npmmirror.digitalhainan.com.cn/

安装最新版 dh-ai：

npm i -g @szhn/ai-cli@latest

确认安装成功：

dh-ai --version

第 2 步：把 Skill 安装到项目

先在终端进入业务项目根目录，再执行：

dh-ai skill init common/dh-cm-web-e2e --tool qoder --scope project

安装完成后，项目中会出现：

.qoder/skills/dh-cm-web-e2e/SKILL.md

完全退出 Qoder，重新打开项目，然后新建一个对话。

第 3 步：创建第一条测试

把下面这段话复制到 Qoder，只需要替换测试环境地址：

使用 /dh-cm-web-e2e，为“质检与反馈闭环”创建一条自动化测试。
测试环境：https://替换成你的测试环境地址
先测试一条最主要的用户流程，像真实用户一样操作页面。
登录时停下来让我手动完成。默认只读，不要新增、修改或删除数据。

接下来 Qoder 会：

1. 查看项目代码，找到页面入口、按钮和接口。
2. 创建一张测试任务卡，记录测试目标和通过条件。
3. 询问代码里查不到的信息，比如什么结果算通过、能否写入测试数据。
4. 项目没有网页测试能力时，安装最小的 Playwright 测试环境。
5. 打开可见浏览器。遇到登录、扫码或验证码时，等待你手动完成。
6. 运行测试并给出结果。失败时保留截图和执行过程，便于排查。

不要把账号、密码、验证码或 Cookie 发给 Qoder。直接在打开的浏览器里完成登录。

第 4 步：以后重复运行

第一次创建成功后，在 Qoder 中直接说：

使用 /dh-cm-web-e2e，运行“质检与反馈闭环”已有测试。
失败时告诉我是产品问题、测试过期，还是测试环境不可用。

AI 会运行项目里已经保存的测试，不会重新探索整条流程。

测试文件放在哪里

• .ai/web-e2e/<流程编号>.md：业务目标、操作流程和通过条件，需要提交到代码仓库。
• 项目原有测试目录：真正执行的测试用例，需要提交到代码仓库。
• playwright-report/、test-results/：报告、截图和执行过程，只保存在本机。
• playwright/.auth/：登录状态，只保存在本机。

项目没有同类配置时，把下面这些目录加入 .gitignore：

playwright/.auth/
playwright-report/
blob-report/
test-results/

不要忽略整个 .ai/web-e2e/，里面的任务卡需要和测试一起长期维护。

更新 Skill

团队发布新版本后，在项目根目录执行：

dh-ai skill update --skill common/dh-cm-web-e2e

安装失败怎么办

提示找不到 dh-ai 命令

完全退出终端并重新打开，再执行 dh-ai --version。仍然找不到时，重新运行全局安装命令。

提示找不到 dh-cm-web-e2e

清空本地内容缓存，再重新安装：

dh-ai cache clear
dh-ai skill init common/dh-cm-web-e2e --tool qoder --scope project

仍然找不到，说明 Skill 还没有发布到团队内容库，请联系维护者。

Qoder 没有识别到 Skill

先确认 .qoder/skills/dh-cm-web-e2e/SKILL.md 存在，再完全退出并重新打开 Qoder，新建一个对话。

只想检查这次改动

不需要长期保留测试时，使用 dh-cm-qa-flow：

dh-ai skill init common/dh-cm-qa-flow

继续阅读：dh-cm-web-e2e 能力说明 · dh-cm-qa-flow 使用说明 · dh-ai cli 使用说明