🌑 Q•Ai — AI辅助的质量自动化工具包

Q•Ai 是一个现代且生产就绪的 QA 自动化堆栈，结合了以下组件：

• Playwright（UI + API + 视觉测试）
• Allure 报告
• MCP 工具（ChatGPT 可以运行测试、调试失败、生成新测试）
• GitHub CI/CD（每次推送和 PR 都进行测试）
• Slack 通知（CI 成功或失败）
• 清晰的文件夹结构，最小依赖项，团队友好

---

🚀 功能

✔ UI、API 和视觉测试

基于 Playwright 构建，具有清晰的测试用例和示例。

✔ Allure 报告

生成带有截图、跟踪和步骤的精美报告。

✔ AI 辅助测试

通过 MCP：

• 在 ChatGPT 中直接运行测试
• 调试失败
• 生成新的测试
• 发送 API 请求
• 检查响应

✔ CI/CD (GitHub Actions)

• 在推送和 PR 时自动运行测试
• 将 Playwright 报告作为工件上传
• 包含 Slack 通知

✔ Slack 集成

CI 发布：

• 成功/失败
• 仓库名称
• 运行链接
• 快速状态摘要

只需添加一个 GitHub 密钥： SLACK_WEBHOOK_URL

---

🏁 快速开始

npm install
npm test
npm run allure:generate
npm run allure:open
npm run mcp:dev

---

📁 项目结构

qai/
  tests/                # UI、API、视觉测试
  helpers/              # 测试用例、实用工具
  mcp/                  # ChatGPT 的 MCP 服务器
  .chatgpt/             # MCP 配置
  .github/workflows/    # CI/CD (GitHub Actions)
  assets/               # 图像 (横幅/Logo/等)
  package.json
  README.md

---

🤖 使用 MCP (AI 辅助测试)

一旦运行：

npm run mcp:dev

在 ChatGPT 中，你会看到：

• playwright
• api

你可以向 ChatGPT 提问：

• “运行测试并总结失败”
• “为登录端点生成一个新的测试”
• “发送 GET /users 并显示 JSON”
• “这个测试中有什么不稳定的地方？”

---

📊 Allure 报告

生成报告：

npm run allure:generate
npm run allure:open

包括：

• 截图
• 跟踪
• 步骤
• 附件
• 通过/失败矩阵

---

🔧 CI/CD (GitHub Actions)

在以下情况下自动运行：

• 向主分支推送
• 拉取请求

流水线执行：

1. 安装
2. 运行测试
3. 上传报告
4. 通知 Slack

Slack 消息示例：

Q•Ai CI: 成功为 user/repo – 运行 1 2345

---

该项目构建时考虑了：

• 极简主义
• 实用的 QA 工作流程
• AI 驱动的协助
• 团队协作

如果您想合作或改进此工具包，请随意提交 PR ⭐

❤️ 设计者：Vlad Babayan

---

🪪 许可证

MIT

<p align="center"><strong>Q•Ai — 智能质量自动化</strong></p> </中文翻译>