chenjigang4167/testhub_platform

TestHub – AI 驱动的全栈测试管理平台

这是什么 – TestHub 是一个开源的 Web 应用程序，帮助 QA 团队规划、编写、运行测试并生成报告。它在传统的测试管理栈之上，加入了 AI 驱动的助手（需求到测试用例生成、集成式聊天机器人，以及让语言模型驱动浏览器的 Browser-use 模式）。

核心功能

领域	TestHub 提供的功能
AI 辅助	• 上传需求文档（PDF/Word/TXT），让支持的 LLM（DeepSeek、OpenAI、Anthropic、Gemini 等）自动提取业务需求并生成测试用例。 • 基于 Dify 的聊天机器人，提供按需测试建议。 • Browser-use 模式：LLM 解析页面结构（文本或视觉）并创建 Selenium/Playwright 脚本，以自动执行 UI 操作。
测试用例生命周期	按项目/版本创建、编辑、版本控制、归档、标记和组织用例。支持包含模板、检查清单和状态跟踪的多人审查。
API 测试	支持 HTTP 与 WebSocket、分层请求集合、变量替换、断言、定时运行、邮件/Webhook 通知、Allure 风格报告。
Web UI 自动化	Selenium 与 Playwright 后端、多浏览器（Chrome/Firefox/Edge）、元素库、Page-Object Model、可视化脚本编辑器、录像/截图、基于 cron 的调度，以及 AI 驱动的“智能模式”。
移动端 (Android) 自动化	Airtest 图像识别引擎、本地模拟器或远程设备处理、资源锁定、组件库、UI-Flow 编排、由 Celery 支持的异步执行与实时 WebSocket 进度。
性能测试	基于 Locust 的负载测试任务，具备结果聚合和报告功能。
数据工厂	>50 种实用工具（随机数据、编码、加密、JSON 辅助工具、cron 表达式解析器等），可在 API 或 UI 测试中引用。
安全与协作	JWT 双令牌与自动刷新、登出时黑名单、基于角色的权限、多项目隔离、统一通知（邮件、企业微信、DingTalk、Feishu）。

架构

• 后端：Django 4.2 + DRF、MySQL、Redis（Celery/WebSocket 可选）、JWT 认证、Celery + APScheduler 用于异步任务、Channels/Daphne 用于 WebSocket、Allure 用于报告、LangChain-OpenAI 与 browser-use 用于 LLM 集成。
• 前端：Vue 3 + Vite、Element Plus UI 库、Pinia store、Vue-Router、Axios、ECharts、Monaco 编辑器、i18n 支持。

开始使用（如 README 中所述）

1. 克隆仓库并创建 Python 3.12 虚拟环境。
2. 从 requirements.txt 安装 Python 依赖项。
3. 复制 .env.example 到 .env 并填入 MySQL、Redis、邮件和 LLM API 密钥。
4. 创建 MySQL 数据库，运行 Django 数据库迁移，并创建超级用户。
5. （可选）使用提供的管理命令加载内置定位器策略和 Android 组件包。
6. 启动服务：
   • python manage.py runserver（HTTP API）或 daphne … 以支持 WebSocket。
   • celery -A backend worker -l info 用于异步任务。
   • python manage.py run_all_scheduled_tasks 用于 cron 任务。
7. 在另一个终端中，构建前端：

   cd frontend
   npm install
   npm run dev   # 开发服务器位于 http://localhost:3000
   

8. 访问 UI（http://localhost:3000）、API 文档（/api/docs/）和 Django 管理后台（/admin/）。

Docker 用户可以运行 ./build-and-push.sh，接着运行 docker-compose up -d 以一键启动全栈。

适用人群

• 需要单一门户进行需求分析、测试用例编写、审查和执行的 QA 团队。
• 希望通过 LLM 生成的用例或 AI 引导的 UI 自动化来增强手动测试的组织。
• 需要可扩展平台（Django 应用、Vue 组件）以插入自定义测试类型集成的开发者。

许可证 – GPL 3.0（请参阅 LICENSE）。

---

以上所有信息均直接取自仓库的 README；未推断任何额外功能。