TestHub测试平台1月份更新记录：让 AI 重塑你的全场景自动化测试体验

20260108更新内容：

一、AI用例生成模块

1.修复AI生成用例后，多处前置条件仍显示br换行符问题；

2.AI生成用例记录-查看任务详情-查看用例详情，弹框增加编辑功能，允许用户采纳前先编辑用例；

3.AI生成用例记录-查看任务详情，页面顶部增加'需求描述'折叠/展开卡片展示，支持一键复制；

二、配置中心

1.AI智能模式配置：

①修改为允许添加多条配置，列表增加启用/禁用按钮(仅允许启用一个)；

②新增&编辑弹框增加测试连接按钮；

2.AI模型配置：

①菜单改名为：AI用例生成模型配置；

②增加模型选择联动机制，选择厂商自动映射带出API地址；

三、其他

1.更新Django后端icon；

2.修复JWT Token 刷新机制问题：前端在尝试刷新 token，但接口路径不正确、报错404；

20260112更新内容： 一、配置中心定时任务相关： 1.修复定时任务执行失败问题 2.修复接口测试定时任务飞书机器人发送通知不成功（UI自动化定时任务正常） 二、接口测试模块： 1.修复新建项目，前后台开始时间、结束时间必填项校验不一致问题 2.修复新增或编辑接口，除raw格式body参数外，保存数据丢失问题 三、UI自动换测试模块 1.去除UI自动化测试模块数据看板页面AI智能模式相关的操作日志统计和展示 2.UI自动化模块没创建项目时，AI智能测试页面执行按钮无法点击 四、AI智能模式 1.AI智能测试页面"开始执行"按钮下方的提示文案修改 五、其他 1.新增core模块，合并API和UI统一定时任务调度器 2.api_testing、ui_automation等应用下的management命令统一迁移到core模块管理 3.api_testing、ui_automation应用下的通知配置统一迁移到core模块下管理 4.删除api_testing、testcase下无效的management命令 5.修复注册完成自动重定向到了/home页面，但是点击任意界面又自动退出到了登录页面 6.更新项目README文档，补充Python3.12版本推荐、core模块说明、统一调度器启动步骤等

深度开源 | TestHub：让 AI 重塑你的自动化测试体验

在软件测试工作中，我们一直在寻找那个能平衡“效率”与“质量”的支点。

从繁琐的手工用例编写，到接口自动化的维护痛点，再到 UI 自动化不稳定的“老大难”问题，测试工程师的日常往往被各种琐碎的工具链所割裂。我们不仅需要编写代码，还需要管理环境、维护文档、产出报告……

今天向大家介绍一款全栈式、智能化的开源测试管理平台——TestHub。

TestHub 不仅仅是一个工具的堆砌，它是一个基于 Django + Vue3 技术栈打造的现代化测试生态系统 。它深度融合了当下最前沿的 AI 能力，将 AI 用例生成、接口测试、UI 自动化测试、AI 智能测试（Browser-use）、AI 问答助手 以及 统一配置中心 融为一体 。

无论你是想从零搭建自动化体系，还是希望通过 AI 为现有的测试流程提效，TestHub 都能为你提供一种全新的视角。

图片

💡 一、 AI 驱动：告别“填鸭式”用例编写

编写测试用例通常是测试生命周期中耗时最长的环节之一。面对厚厚的需求文档，如何快速提取测试点并转化为标准用例？TestHub 的 AI 用例生成模块 给出了答案 。

1. 懂文档的 AI，才是好助手

TestHub 支持两种灵活的需求采集方式：你可以直接手动输入需求描述，也可以直接上传需求文档 。

更贴心的是，系统对文档格式的兼容性极佳，支持 PDF、Word、TXT 等多种常见类型 。这意味着，你不需要费力地将产品经理的 PRD 文档复制粘贴，只需简单拖拽上传，系统内置的 AI 引擎就会自动解析文档内容，深入理解业务逻辑，提取出核心的测试需求 。

图片

2. 异步生成，拒绝焦虑

在处理大型文档时，AI 的思考需要时间。为了不打断你的工作流，TestHub 的 AI 生成任务采用了异步执行机制 。你可以在点击“生成”后，转身去处理其他任务，无需在当前页面枯燥等待。

任务完成后，在任务列表中即可清晰地看到生成状态。不管是简单的登录功能，还是复杂的业务流转，AI 都能为你批量产出结构化的用例数据。

3. 人机协同，精准把控

AI 生成的用例并非“一锤子买卖”。TestHub 提倡“AI 辅助，人工把关”的理念。在任务详情页，你可以查看到每一个生成的用例明细 。

平台提供了完善的采纳与管理机制：

• 一键导出：支持导出为 Excel 格式，方便线下评审 。
• 灵活编辑：发现 AI 遗漏了前置条件？直接在线编辑修正。
• 状态管理：对于符合要求的用例，点击“采纳”，它们会自动导入到系统的测试用例库中；对于不合理的用例，直接“弃用” 。

这种设计既保留了 AI 的高效率，又确保了测试数据的严谨性。

图片

图片

🔗 二、 接口测试：从调试到监控的闭环

接口测试是自动化测试金字塔的中坚力量。TestHub 的 API 测试模块不仅仅是一个发包工具，而是一个完整的接口生命周期管理方案 。

1. 井井有条的项目管理

平台支持 HTTP 和 WebSocket 协议，采用树形结构来组织 API 项目和集合 。无论你的项目接口数量多么庞大，清晰的目录结构都能让你快速定位到目标接口。

在请求管理方面，全面支持 GET、POST、PUT、DELETE、PATCH 等主流 HTTP 方法 ，满足绝大多数业务场景的测试需求。

图片

2. 沉浸式的调试体验

TestHub 的接口调试界面设计简洁直观。你可以方便地配置 Params、Headers、Body 等参数，支持 raw、form-data 等多种格式。发送请求后，响应数据格式化展示，状态码、响应时间一目了然 。

图片

3. 自动化与持续集成

单个接口跑通只是第一步。TestHub 支持创建测试套件，将多个 API 请求组合起来批量执行，并支持配置断言和执行顺序 。

对于需要长期监控的接口，定时任务功能不可或缺。你可以通过 Cron 表达式灵活设置执行计划 。无论是每小时的例行巡检，还是每天凌晨的回归测试，TestHub 都能按时执行，并通过邮件或 Webhook（钉钉、飞书、企业微信）及时通知测试结果 。

图片

4. 专业的环境变量管理

为了解决开发、测试、生产环境切换的难题，平台内置了强大的环境变量管理功能 。你可以定义全局变量或局部变量，在接口请求中通过变量引用的方式（如 {{base_url}}）实现配置与代码的解耦。

最后，所有的测试结果都会生成标准的 Allure 测试报告 。这种业界公认的报告格式，不仅界面美观，更能通过图表直观展示测试通过率、失败原因等关键指标。

图片

图片

💻 三、 UI 自动化：稳健与灵活并存

UI 自动化测试因为维护成本高、执行不稳定而常被诟病。TestHub 在设计之初就考虑到了这些痛点，致力于提供一个更稳健的执行环境 。

1. 双引擎驱动，兼容性 Max

TestHub 极具前瞻性地实现了 Selenium + Playwright 双引擎支持 。

• Selenium：作为老牌王者，生态成熟，兼容性强。
• Playwright：作为微软推出的新星，以速度快、不仅支持无头模式还支持有头模式调试而著称。

你可以根据项目特点灵活选择执行引擎，同时支持 Chrome、Firefox、Edge、Safari 等多浏览器运行 ，确保你的应用在各种环境下都能正常工作。

图片

2. 页面对象模式（POM）的最佳实践

为了提高脚本的可维护性，TestHub 深度集成了 POM（Page Object Model）设计模式 。 通过元素管理模块，你可以将页面元素与测试逻辑分离。系统支持 ID、XPath、CSS Selector 等多种定位策略 。当页面 UI 发生变化时，你只需要在元素库中更新定位符，而无需修改成百上千条测试用例，大大降低了维护成本。

图片

图片

3. 可视化的执行回溯

UI 测试失败了，究竟是网络问题还是页面渲染 Bug？ TestHub 提供了详细的执行记录 。每一次测试执行，系统都会保留完整的日志、截图以及测试报告。你可以清晰地看到每一步操作的执行情况，甚至回溯错误发生的现场，让 Bug 无处遁形。

图片

当然，UI 自动化同样支持灵活的定时任务配置，配合 Cron 表达式，实现无人值守的夜间回归测试 。所有的通知都会通过配置好的 Webhook 实时触达团队成员 。

图片

🤖 四、 AI 智能模式：下一代自动化测试

如果说传统的 UI 自动化还需要人工编写步骤，那么 TestHub 的 AI 智能模式 则展示了未来的可能性 。

1. 基于自然语言的 Browser-use

这一模块基于前沿的 Browser-use 框架，让 AI 能够像人类一样理解页面结构 。你不再需要去查找元素的 XPath，只需要告诉 AI：“使用账号 testadmin 登录，然后点击新建版本”。

AI 会自动规划任务路径，生成执行步骤，并驱动浏览器完成操作 。

图片

2. 多模型接入与智能感知

目前，该模式支持文本模式（基于 DOM 解析），未来还将规划支持视觉模式（基于截图识别） 。在模型支持上，平台保持了高度的开放性，支持接入 DeepSeek、硅基流动 等多种强大的 AI 模型 。

图片

3. 过程可视，结果可查

AI 执行的过程不再是黑盒。系统会记录每一步的执行日志，并在步骤完成后自动标记状态 。 更酷的是，执行过程会自动生成 GIF 动图 。你可以像看电影一样回放 AI 的操作过程，直观地检查 AI 是否按照预期完成了任务。测试报告还支持导出为 PDF，包含时长、步骤、完成率等多维度的统计数据 。

图片

图片

🎓 五、 AI 问答助手：你的贴身测试顾问

遇到棘手的测试难题？对某个测试理论拿捏不准？ TestHub 内置了 AI 问答助手（AI 评测师） 。它集成 Dify AI 能力，能够基于专业的知识库为你提供实时的咨询服务 。

不仅如此，它还支持类似于“豆包”的会话记录功能，左侧自动保存历史会话 。当你下次遇到类似问题时，可以快速翻阅之前的解决方案，它就像一位经验丰富的导师，随时待命。

图片

⚙️ 六、 统一配置中心：化繁为简

强大的功能背后，是极其简便的运维管理。TestHub 的 统一配置中心 让环境搭建变得轻而易举 。

• 环境自动检测：系统会自动检测服务器的浏览器环境和 Playwright 执行环境，缺什么补什么 。
• 驱动一键管理：再也不用为了浏览器驱动版本不匹配而头秃，系统支持一键安装和更新驱动 。
• 模型统一配置：无论是 DeepSeek 还是通义千问，你都可以在这里统一管理 API Key 和参数配置，并支持一键连接测试，确保 AI 模型随时在线 。
• 通知渠道集成：钉钉、飞书、企微机器人的 Webhook 地址都在这里统一配置，打通消息推送的最后一公里。

图片

TestHub 测试平台通过将传统测试工具与现代 AI 技术深度融合，为测试团队提供了一个高效、智能、统一的协作空间。它不仅解决了工具碎片化的问题，更通过 AI 能力大幅降低了自动化测试的门槛。

无论你是希望提升团队效率的测试经理，还是热衷于探索新技术的测试工程师，TestHub 值得你一试。

开源共建，未来可期。

欢迎大家关注项目，提出宝贵的 Issue 和 PR，让我们一起重新定义自动化测试！

Testhub保姆级部署教程

TestHub 是基于 Django (后端) 和 Vue3 (前端) 的智能测试管理平台，部署它主要分为三步：环境准备、后端部署、前端部署。

一、 环境准备

在开始之前，需要安装以下软件：

1. Git
2. Python 3.12: 推荐使用此版本，老版本python可能出现兼容性问题！
3. Node.js (版本 18+)
4. MySQL 8.0+: 本项目目前不支持8.0以下的mysql版本**

二、 获取代码

1. 下载代码：

git clone https://github.com/chenjigang4167/testhub_platform.git

2. 进入项目文件夹：

cd testhub/testhub_platform

三、 后端部署 (Backend)

1. 创建虚拟环境

虚拟环境的作用是隔离依赖，让本项目的依赖包不影响你电脑上的其他 Python 程序。在项目根目录 (testhub_platform) 打开命令行 (CMD 或 PowerShell)，执行：

python -m venv venv

2. 激活虚拟环境

windows命令： venv\Scripts\activatemac命令：source venv/bin/activate

3. 安装依赖包

这一步会下载项目需要的所有 Python 库。为了下载更快，我们使用国内镜像源：

pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

4. 配置数据库

在 testhub_platform 目录下创建一个名为 .env 的文件，用记事本打开填入以下内容：

DB_NAME=testhub 
DB_USER=root 
DB_PASSWORD=你的数据库密码 
DB_HOST=127.0.0.1 
DB_PORT=3306  
SECRET_KEY=test-secret-key-123456 
DEBUG=True

然后，我们需要在 MySQL 中创建这个数据库。打开一个新的命令行窗口，输入：

mysql -u root -p

输入密码后，进入 MySQL，执行创建数据库的命令：

CREATE DATABASE testhub CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
exit;

5. 初始化项目

回到刚才激活了 (venv) 的命令行窗口，依次执行以下命令：

python manage.py makemigrations
python manage.py migrate
python manage.py createsuperuser
python manage.py init_locator_strategies

6. 启动后端服务

python manage.py runserver

如果看到 Starting development server at http://127.0.0.1:8000/，说明后端启动成功了！注意，不要关闭这个窗口！

四、 前端部署

1. 进入前端目录

打开一个新的命令行窗口进入 frontend 目录：

cd testhub/testhub_platform/frontend

2. 安装前端依赖

同样使用国内镜像加速：

npm install --registry=https://registry.npmmirror.com

3. 启动前端服务

npm run dev

如果看到 Local: http://localhost:3000/ ，说明前端启动成功了！

五、 访问项目

打开浏览器，访问 http://localhost:3000 即可开始使用 TestHub。