TestHub 智能测试管理平台
基于 AI 驱动的全栈测试管理平台
📖 项目简介
TestHub 是一个 AI 驱动的全栈测试管理平台，覆盖测试全流程，包含：AI 需求分析与用例生成、测试用例管理与评审、API 测试、UI 自动化测试（Web）、APP 自动化测试（Android）、性能测试、数据工厂等模块，助力测试团队全面提效。
✨ 核心特性
🤖 AI 智能化
- 需求分析: 上传需求文档（PDF/Word/TXT），AI 自动提取业务需求并生成测试用例
- 智能助手: 集成 Dify AI 助手，提供测试咨询和问题解答
- AI 智能模式: 基于 Browser-use 的智能浏览器自动化，AI 理解页面并自动完成测试（支持文本/视觉两种模式）
- 多模型支持: DeepSeek、通义千问、硅基流动、OpenAI、Anthropic、Google Gemini 等
📋 用例管理与评审
- 完整的用例生命周期管理：创建、编辑、版本控制、归档
- 多维度组织：项目、版本、标签分类；步骤化设计（前置条件 / 操作步骤 / 预期结果）
- 附件与团队协作评论
- 评审流程：多人评审、评审模板与检查清单、多层级评审意见、状态跟踪
🌐 API 测试
- 支持 HTTP / WebSocket 协议，树形集合组织，环境变量与变量替换
- 测试套件批量执行，支持断言与执行顺序配置
- 请求历史记录、定时任务（邮件 / Webhook 通知）、Allure 测试报告
🖥️ UI 自动化测试（Web）
- Selenium / Playwright 双引擎，多浏览器支持（Chrome / Firefox / Edge）
- 元素库（多种定位策略）+ 页面对象模式（POM）
- 可视化脚本编辑、测试套件批量执行、执行日志 / 截图 / 视频录制
- 定时任务：Cron 表达式、固定间隔、单次执行
- AI 智能模式：AI 理解页面结构自动完成测试任务
📱 APP 自动化测试（Android）
- 基于 Airtest 图像识别，支持本地模拟器与远程设备，设备锁定避免资源冲突
- 元素管理（图片 / 坐标 / 区域）与多分辨率适配
- 组件化编排 + UI Flow 流程编排，变量管理（global / local / outputs）
- Celery 异步执行 + Allure 报告，WebSocket 实时进度追踪
🚀 性能测试
- 基于 Locust 的压测任务管理与执行，性能指标统计与报告
🏭 数据工厂
- 50+ 实用工具：字符处理、编码转换、随机数据、加密解密、测试数据生成、JSON 处理、Crontab 表达式等
- 标签管理与使用记录，支持在 API 测试与 UI 测试中直接引用数据
🔐 安全与协作
- JWT 双 Token 机制：自动刷新续期、登出黑名单、防重放攻击
- 多项目管理、成员角色权限控制、版本规划
- 统一通知：邮件 + 企业微信 / 钉钉 / 飞书 Webhook 机器人
🏗️ 技术架构
后端
- 框架: Django 4.2 + Django REST Framework
- 数据库: MySQL 8.0+
- 认证: JWT（rest_framework_simplejwt）+ Token 黑名单
- 自动化: Selenium、Playwright、Airtest + OCR、Allure
- 异步与任务: Celery、APScheduler、Channels + Daphne（WebSocket）
- AI 集成: browser-use、langchain-openai，多模型提供商
- API 文档: drf-spectacular（Swagger / ReDoc）
前端
- Vue 3 + Vite + Element Plus
- Pinia 状态管理、Vue Router、Axios
- ECharts 可视化、Monaco Editor、vue-i18n 国际化
在进行 Web、API 及自动化测试时，不同地区的网络环境可能带来不同的访问体验。IPWO住宅代理，支持多地区网络环境配置，可用于海外网站访问、区域测试及自动化测试场景。
IPWO为 TestHub 用户提供更多测试环境选择，让跨地区测试更加灵活。覆盖全球195+地区动静态IP资源，支持免费测试入口，90折扣码：0204
📁 项目结构
testhub_platform/
├── apps/ # Django 应用模块
│ ├── users/ # 用户认证与管理
│ ├── projects/ # 项目管理
│ ├── testcases/ # 测试用例管理
│ ├── testsuites/ # 测试套件
│ ├── executions/ # 测试计划与执行
│ ├── reports/ # 测试报告
│ ├── defects/ # 缺陷管理
│ ├── reviews/ # 用例评审
│ ├── versions/ # 版本管理
│ ├── core/ # 核心模块（管理命令、变量解析、通知配置）
│ ├── api_testing/ # API 测试
│ ├── ui_automation/ # UI 自动化测试（含 AI 智能模式）
│ ├── app_automation/ # APP 自动化测试
│ ├── perf_testing/ # 性能测试
│ ├── requirement_analysis/ # AI 需求分析
│ ├── assistant/ # Dify 智能助手
│ ├── data_factory/ # 数据工厂
│ └── llm_judge/ # LLM 评测
├── backend/ # Django 项目配置（settings / urls / asgi）
├── frontend/ # Vue 3 前端（src: views / api / stores / router）
├── media/ # 媒体文件（上传文件、截图等）
├── logs/ # 日志文件
├── allure/ # Allure 报告工具
├── requirements.txt # Python 依赖
└── manage.py # Django 管理脚本
🚀 快速开始
环境要求
- Python: 推荐 3.12，其他版本可能存在兼容性问题
- Node.js: 18+（前端构建必需，生产环境可不安装）
- MySQL: 8.0+
- Java: 17+（可选，Allure 报告生成需要）
- Redis: 6.0+（可选，APP 自动化 WebSocket / Celery 需要）
- 浏览器驱动: ChromeDriver / GeckoDriver（UI 自动化，也可通过管理命令自动下载）
后端部署
- 克隆项目
git clone
cd testhub_platform
- 创建虚拟环境并安装依赖
python -m venv venv
# Windows
venv\Scripts\activate
# Linux / Mac
source venv/bin/activate
pip install -r requirements.txt
- 配置环境变量
# 复制模板并按需修改数据库、Redis、邮箱等配置
cp .env.example .env
- 初始化数据库
# 创建数据库
mysql -u root -p -e "CREATE DATABASE testhub CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
# 执行迁移并创建超级用户
python manage.py makemigrations
python manage.py migrate
python manage.py createsuperuser
- 初始化模块数据（可选）
# UI 自动化元素定位策略
python manage.py init_locator_strategies
# APP 自动化组件库
python manage.py load_component_pack
- 启动服务
# Django 开发服务器（仅 HTTP）
python manage.py runserver
# 如需 WebSocket（APP 自动化实时进度），改用 Daphne 启动
daphne -b 0.0.0.0 -p 8000 backend.asgi:application
# 定时任务调度器（API / UI 定时任务，可选）
python manage.py run_all_scheduled_tasks
# Celery worker（APP 自动化异步任务，可选）
celery -A backend worker -l info
前端部署
cd frontend
npm install
npm run dev # 开发模式
npm run build # 生产构建
访问应用
- 前端: http://localhost:3000
- 后端 API: http://localhost:8000
- API 文档: http://localhost:8000/api/docs/
- Admin 后台: http://localhost:8000/admin/
Docker 部署（可选）
./build-and-push.sh # 构建并推送镜像
docker-compose up -d # 一键启动全栈服务
🔧 配置说明
环境变量统一在 .env 中配置（参考 .env.example），主要包括：
- 数据库:
DB_NAME、DB_USER、DB_PASSWORD、DB_HOST、DB_PORT - Redis:
REDIS_URL（APP 自动化 WebSocket / Celery 需要） - AI 模型: 在「统一配置中心」管理多家提供商的 API Key / Base URL / 模型参数，支持按角色配置（用例编写、用例评审、Browser Use），并提供连接测试
- UI 自动化: 执行引擎（Selenium / Playwright）、浏览器、有头 / 无头模式
- 通知: 邮件（SMTP）与 Webhook 机器人（企业微信 / 钉钉 / 飞书）
📄 文档
更多使用说明见 docs/docs-center：
- 数据工厂使用说明 / 快速开始 / 功能说明 / API 接口文档
- UI 自动化测试执行说明 / UI 自动化测试用户使用手册
- WebDriver 驱动管理优化说明
- 用例评审管理功能说明
- I18N 国际化使用说明
- 问题排查指南
🤝 贡献指南
欢迎提交 Issue 和 Pull Request 来帮助改进项目！
- Fork 本仓库
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 开启 Pull Request
📝 许可证
本项目采用 GPL 3.0 许可证 - 详见 LICENSE 文件
📧 联系方式
如有问题或建议，欢迎通过 Issue 反馈，也可以扫码添加作者，加入官方交流群。
使用手册、视频教程、学习中心、Skills商店，欢迎访问TestHub官网。
Made with ❤️ by 大刚（公众号：测试开发实战）