左：AI 智能测试 全自动执行流程 | 右：覆盖多类测试场景
## 安装与配置 ### 🚀 Docker一键启动 在开始之前，请确保已安装 Docker。如未安装，请参考官方安装指南：[Docker 安装指南](https://docs.docker.com/get-started/get-docker/)。 ```bash # 1. 下载配置文件模板 mkdir -p config && curl -fsSL https://raw.githubusercontent.com/MigoXLab/webqa-agent/main/config/config.yaml.example -o config/config.yaml # 2. 编辑配置文件 # 设置 target.url、llm_config.api_key 等参数 # 3. 一键启动 curl -fsSL https://raw.githubusercontent.com/MigoXLab/webqa-agent/main/start.sh | bash ``` ### 源码安装 ```bash git clone https://github.com/MigoXLab/webqa-agent.git cd webqa-agent ``` 安装 Python >= 3.10，运行以下命令： ```bash pip install -r requirements.txt playwright install ``` 性能测试 - Lighthouse 安装（可选） ```bash # 需要 Node.js >= 18.0.0 package.json npm install ``` 安全测试 - Nuclei 安装（可选） 下载地址： [Nuclei Releases](https://github.com/projectdiscovery/nuclei/releases/) ```bash # MacOS brew install nuclei # 其他系统请从上述下载地址获取对应架构的版本 # 安装后更新模板并验证 nuclei -ut -v # 更新 Nuclei 模板 nuclei -version # 验证安装成功 ``` 参考“使用说明 > 测试配置”进行 `config/config.yaml` 配置后，运行下方命令。 ```bash python webqa-agent.py ``` ## 使用说明 ### 测试配置 `webqa-agent` 通过 YAML 配置测试运行参数： ```yaml target: url: https://example.com/ # 需要测试的网站URL description: example description test_config: # 测试项配置 function_test: # 功能测试 enabled: True type: ai # default or ai business_objectives: example business objectives # 建议加入测试范围，如：测试搜索功能 ux_test: # 用户体验测试 enabled: True performance_test: # 性能测试 enabled: False security_test: # 安全测试 enabled: False llm_config: # 视觉模型配置，当前仅支持 OpenAI SDK 兼容格式 model: gpt-4.1 # 推荐使用 api_key: your_api_key base_url: https://api.example.com/v1 browser_config: viewport: {"width": 1280, "height": 720} headless: False # Docker环境会自动覆盖为True language: zh-CN cookies: [] ``` 在配置和运行测试时，请注意以下重要事项： #### 1. 功能测试说明 - **AI模式**：当在配置文件中指定生成测试用例的数量时，系统可能会根据实际测试情况进行代理重新规划和调整。这可能导致最终执行的测试用例数量与初始设定存在一定出入，以确保测试的准确性和有效性。 - **Default模式**：功能测试的 `default` 模式主要验证UI元素的点击行为是否成功执行，包括按钮点击、链接跳转等基本交互功能。 #### 2. 用户体验测试说明 UX（用户体验）测试专注于评估网站的交互设计、可用性和用户友好程度。测试结果中包含的模型输出内容是基于用户体验最佳实践提供的改进建议，供开发和设计团队参考优化。 ## 查看结果 在 `reports` 目录会生成本次测试的文件夹，打开其中的 HTML 报告即可查看结果。 ## RoadMap 1. AI功能测试持续优化：提升覆盖率与准确性 2. 功能遍历与页面校验：校验业务逻辑正确性与数据完整性 3. 交互与可视化：用例可视化与本地服务实时展示推理过程 4. 能力扩展：多模型接入与更多评估维度集成 ## 开源许可证 该项目采用 [Apache 2.0 开源许可证](LICENSE)。