WHartTest

Appearance

版本说明 ​

v2.2.0 ​

版本概述 ​

v2.2.0 是 WHartTest 平台的重要功能升级版本，核心聚焦于任务调度自动化能力。新版本通过引入任务中心模块实现定时调度 UI 自动化与测试套件进一步提升了平台的自动化程度。

✨ 新功能 ​

任务中心与定时调度系统 ​

  • 新增任务中心模块：基于 django-celery-beat 构建动态任务调度系统
  • 支持多种调度策略：一次性、每小时、每天、每周等灵活配置，支持失败重试机制
  • 自动化执行能力：定时触发 UI 自动化批量执行与测试套件执行
  • 完整的管理界面：提供任务管理页面、配置弹窗及执行记录日志查看功能

draw.io 图表生成（skill） ​

注意！！！：原智能图表功能现已优化为统一加载skill的方式在对话中实现智能图表的生成，使用更加便捷。

  • 生成 .drawio 图表文件：创建原生 draw.io 格式的图表（XML 格式的 mxGraphModel），支持各种图表类型：流程图、架构图、ER图、网络拓扑图、UML图等
  • 导出为多种格式：PNG - 图片格式，支持嵌入 XML（可在 draw.io 中重新编辑）、SVG - 矢量图格式，支持嵌入 XML、PDF - 文档格式，支持嵌入 XML、JPG - 图片格式（不支持嵌入 XML）
  • 嵌入可编辑性：对于 PNG、SVG、PDF 格式，使用 --embed-diagram 参数导出后，文件会包含完整的图表 XML，可以在 draw.io 中打开并继续编辑。

WeKnora 知识库查询工具（skill） ​

  • 列出知识库：查询所有可用的知识库，获取 ID、名称、描述等信息。
  • 搜索知识库内容：根据查询文本，在指定知识库中搜索相关的文档片段，返回匹配结果。

🐛 问题修复 ​

界面与交互修复 ​

  • 修复任务中心展示时间没有进行时区转换的问题
  • 修复深色与默认主题的适配问题
  • 修复执行器执行用例没有传执行人id的问题
  • 修改执行用例时勾选“是否自动生成playwright脚本”为“生成 UI 自动化用例”

📦 升级说明 ​

  1. 数据库迁移：升级后请执行数据库迁移：python manage.py migrate
  2. 依赖安装：需要重新安装依赖：pip install -r requirements.txt
  3. 若需启用 xinference，请在 compose 文件中手动开启对应服务。
  4. Celery 配置：任务中心依赖 Celery，需要配置Celery Beat 服务,采用docker部署方式自动部署Celery服务，采用源码部署需要单独启动Celery服务。

Windows源码部署启动Celery Beat 服务方式如下：

开启两个终端窗口分别运行：

uv run celery -A wharttest_django worker --loglevel=info -Q celery,task_center

uv run celery -A wharttest_django beat --loglevel=info

🔗 相关资源 ​

  • 部署脚本：使用 run_compose.sh 一键构建和启动服务

v2.1.0 ​

版本概述 ​

v2.1.0 是一个全栈 UI 自动化与 AI 能力深度融合的重大升级版本。 核心变化是新增全栈 UI 自动化测试体系，支持批量并发执行与 Playwright 追踪回放；同时AI 引擎全面增强，集成多供应商 LLM（如通义千问），引入项目上下文注入与工具审批中断恢复能力。此外，部署体验大幅优化，支持 Skills 自动初始化与一键启动脚本，测试管理与系统稳定性同步提升。

🚀 重大升级 ​

全栈 UI 自动化体系升级 ​

  • 新增全栈 UI 自动化测试系统（Web 管理端 + 执行器）。
  • 支持批量并发执行、执行器配置管理、执行记录按项目过滤。
  • 新增 Playwright 执行追踪录制与可视化回放能力。

LangGraph 与模型能力升级 ​

  • 新增多供应商 LLM 支持并集成通义千问（Qwen）。
  • 新增项目作用域上下文注入能力（提示词自动拼装项目信息）。
  • 聊天支持图表预览、HTML 预览与代码块可折叠预览。

部署与开箱体验升级 ​

  • 容器启动新增预置 Skills 自动初始化（init_skills）。
  • Docker 本地开发支持挂载 bundled skills 自动同步。
  • 新增 run_local_compose.sh 一键构建、启动、日志采集脚本。

✨ 新功能 ​

UI 自动化能力增强 ​

  • 新增 UI 自动化 Skill 工具集并优化元素采集策略（优先 agent-browser-skill）。
  • 支持测试步骤变量动态替换。
  • 批量执行详情新增步骤结果与错误信息展示。
  • 支持删除执行记录并自动清理关联文件。
  • UI 自动化菜单提升为顶级入口。

Agent 交互能力增强 ​

  • 工具消息支持头像与图片悬浮预览，支持拖动和关闭。
  • 支持用户消息图片 URL 提取与工具结果图像 URL 展示。
  • 工具审批弹窗支持分组折叠，并增强中断恢复上下文。
  • 优化 MCP 工具输出解析与展示逻辑。

测试用例管理增强 ​

  • 测试用例新增测试类型分类。
  • 支持 Skill 工具批量执行。
  • 支持按模块导出测试用例。

🐛 问题修复 ​

聊天与会话 ​

  • 修复 tool_calls / tool_call_id 历史配对异常问题。
  • 修复会话 Token 统计更新时间缺失问题。
  • 修复聊天侧边栏无效日期导致的时间显示异常。
  • 清理会话启动时残留的停止信号。

UI 自动化 ​

  • 修复模块树扁平化循环引用问题并切换树形 API。
  • 修复搜索框清空后列表不刷新的问题。
  • 优化编辑与查看详情时的数据加载与错误提示。
  • 修复页面步骤按钮文案与列表列宽等交互问题。

系统稳定性 ​

  • 增强 persistent client 连接异常处理与日志记录。
  • 中间件新增模型重试与异常处理，优化上下文限制逻辑。
  • 修复数据库未就绪时的认证错误响应提示。
  • 修复登录页原生密码显示按钮与自定义图标重复问题。

🔧 优化改进 ​

  • 移除内置 Diagram 工具，适配 MCP 响应格式。
  • Draw.io 由自托管切换为官方在线版本。
  • Docker 镜像构建纳入 ui_automation，并清理冗余产物。
  • 默认禁用 xinference 服务，降低默认资源占用。
  • 更新本地 compose 注释与开发体验文档。

📦 升级说明 ​

  1. 升级后请执行数据库迁移：python manage.py migrate。
  2. Docker 本地开发建议使用：./scripts/run_local_compose.sh docker-compose.local.yml。
  3. 若需启用 xinference，请在 compose 文件中手动开启对应服务。
  4. 若依赖 Draw.io 自托管能力，请调整为官方在线模式或自行扩展代理方案。
  5. 提示：此版本去掉了UI自动化脚本库，重构成了UI自动化模块，升级此版本会造成数据丢失，请提前备份。

v2.0.0 ​

版本概述 ​

v2.0.0 是一个重大架构升级版本，核心变化是将 LangChain 和 LangGraph 升级至最新的 v1.x 版本。新版本重构了 Agent Loop 架构，引入了 Middleware 模式实现自动上下文压缩和 HITL 审批流程，同时集成了 Token 用量追踪与统计看板，大幅提升了 AI 交互体验和系统可观测性。

重大升级 ​

LangChain & LangGraph 架构升级 ​

  • LangChain 升级至 v1.2.3，LangGraph 升级至 v1.0.6
  • 核心依赖版本：
    • langchain-core==1.2.7
    • langchain-openai==1.1.7
    • langchain-community==0.4.1
    • langgraph-checkpoint==4.0.0
    • langgraph-prebuilt==1.0.6
  • 重构 Agent Loop 架构，采用 create_agent() 统一创建方式
  • 引入 Middleware 模式：SummarizationMiddleware 自动上下文压缩、HumanInTheLoopMiddleware 处理 HITL 审批
  • 统一使用 LangChain 标准库计算 Token 用量

新增功能 ​

Agent 与 AI 能力增强 ​

  • 工具自动拒绝策略：在工具偏好设置中可为指定工具配置"始终拒绝"策略，AI 调用该工具时将自动拒绝执行，无需人工确认弹窗
  • HITL 工具审批：图表编辑器集成工具审批卡片，支持中断事件处理与执行恢复
  • agent-browser 集成：集成 agent-browser 工具并优化执行稳定性

Token 用量追踪 ​

  • 集成 Token 用量追踪与统计看板
  • 优化 Token 统计日期逻辑与前端服务集成
  • 新增 LLM 模型列表获取代理接口

项目与仪表盘 ​

  • 资源统计优化：调整首页资源统计显示与页面布局
  • 版本检查功能：界面展示当前版本号并自动检测 GitHub 新版本更新

系统配置 ​

  • LLM 配置优化：测试连接后状态自动流转，防止重复创建
  • Draw.io 降级机制：加载超时自动降级至公共服务

修复 ​

Token 计费统计 ​

  • 修正 Token 计算逻辑，避免 input_tokens 重复累加
  • 优化计费精度，使用 LLM 返回的真实 usage_metadata
  • 修复日期筛选的时区偏差问题

会话与消息处理 ​

  • 修复重试时消息截断导致前后端不同步问题
  • 修复用户消息中 HTML 内容被解析及换行丢失问题
  • 优化流式响应在等待审批时的状态判断

界面与交互 ​

  • 优化测试用例列表表格滚动与高度自适应
  • 优化接口错误处理逻辑，优先展示详细错误信息

优化与改进 ​

  • 简化 Token 指示器与工具审批卡片 UI 展示
  • 增强系统诊断工具，新增 Qdrant 向量一致性校验
  • 优化 MEDIA_ROOT 配置，支持环境变量灵活定义
  • 执行统计汇总周期由 30 天调整为 7 天
  • 增强安装脚本跨平台兼容性并重构 JSON 解析逻辑
  • 新增系统操作手册并更新运行环境与 Skills 资源

升级说明 ​

  1. 本版本包含 LangChain/LangGraph 重大升级，升级前请备份数据
  2. 需要重新安装依赖：pip install -r requirements.txt
  3. 数据库迁移：python manage.py migrate

v1.4.0 ​

版本概述 ​

v1.4.0 版本重点增强了 AI 智能交互能力和自动化测试生态。新版本引入了 agent-browser 工具，赋予了 AI 更强大的浏览器操作能力；新增了 AI 智能安装助手，大幅简化了部署流程；强化了 LangGraph 代理接口，优化了前端交互体验。同时，在项目管理、Dashboard 展示及系统文档方面也进行了全方位升级，进一步提升了平台的易用性和稳定性。

新增功能 ​

AI 智能安装助手 ​

  • 新增 ai_install.sh 智能安装脚本，支持 AI 流式响应与命令交互
  • 支持命令拒绝时的用户反馈机制
  • 优化系统提示词，提升安装引导体验
  • 新增 Docker 镜像加速源推荐列表，优化国内下载体验

Skills 生态扩展 ​

  • 集成 agent-browser 工具，支持更强大的浏览器自动化操作
  • 新增 wharttest_skills 工具集，支持测试用例管理、项目查询及截图上传
  • 新增 playwright-skill 工具，提供专业的 Playwright 自动化测试能力
  • 适配标题生成模式知识库参数，并增加 Prompt 模块 ID 支持

LangGraph 与 Agent 增强 ​

  • 新增 LLM 模型列表获取代理接口，优化前端模型选择交互
  • 支持需求文档多模态交互（如图片智能分析），增强 Agent 鲁棒性
  • 优化 API 响应类型定义与错误格式

需求与用例管理 ​

  • 实现需求评审进度实时追踪，新增需求逻辑分析维度
  • 支持 H4-H6 标题拆分及旧版 Word 文档 (.doc) 解析
  • 新增自定义 Excel 模版导入导出功能
  • 优化用例详情导航与审核状态管理功能

优化与改进 ​

仪表盘 (Dashboard) ​

  • 调整首页资源统计显示与页面布局
  • 将执行统计汇总周期由 30 天调整为 7 天

系统配置与依赖 ​

  • 新增 pandas 与 xlrd 依赖以支持 Excel 解析
  • 优化构建配置，修复初始化脚本与登录路由
  • 新增 AI 接口相关环境变量配置

文档体系 ​

  • 新增系统操作手册，详细说明运行环境与 Skills 资源
  • 更新 API 基础地址以适配容器环境

修复 ​

  • 修复添加用例工具方法传参默认值及接口返回信息
  • 修复需求管理文档详情切换项目监听事件
  • 修复自动化脚本项目权限校验及列表刷新逻辑
  • 修复部分文档内容及其他已知 Bug

v1.3.0 ​

版本概述 ​

v1.3.0 是一个重大功能更新版本，新增了 AI 智能图表生成、Playwright 自动化脚本管理等核心功能，同时对底层架构进行了重要升级。

新增功能 ​

Playwright 自动化脚本管理 ​

  • 新增自动化脚本管理模块，支持 AI 智能生成 Playwright 测试脚本
  • 集成 Monaco Editor 代码编辑器，WebSocket 实时执行日志输出
  • 测试套件支持同时管理测试用例和自动化脚本

AI 智能图表生成 ​

  • 集成 Draw.io 自托管服务，支持 AI 生成流程图、架构图等

Agent Loop 可视化与 Token 管理 ​

  • 执行步骤可视化显示，增强调试体验
  • 新增 Token 使用量指示器，支持上下文限制配置

项目管理 ​

  • 新增项目管理视图
  • 测试用例支持模块过滤筛选

架构升级 ​

向量数据库迁移 ​

  • 从 ChromaDB 迁移到 Qdrant，提升性能和稳定性

数据库多引擎支持 ​

  • 同时支持 PostgreSQL 和 SQLite

LLM 配置优化 ​

  • 统一使用 OpenAI 兼容格式
  • 新增模型连接测试功能
  • 增加重试机制和超时设置

体验优化 ​

  • 用户消息时间显示、聊天消息引用、自动滚动到最新消息
  • 知识库改为全局配置模式，优化 Word 文档嵌套表格提取
  • Docker 镜像使用国内源加速，优化部署体验

升级说明 ​

  1. 向量数据库迁移到 Qdrant，升级后需重新导入知识库文档
  2. 新增 Qdrant 和 Draw.io 服务，请使用最新的 docker-compose.yml

v1.2.0 ​

版本概述 ​

v1.2.0 新增批量测试执行、大脑模式等高级功能。

新增功能 ​

批量测试执行 ​

  • 基于 Celery 实现批量异步测试执行
  • 支持拖拽排序测试步骤
  • 批量删除聊天会话和截图

大脑模式 ​

  • 支持思维过程展示和折叠
  • 工具名称和思考过程标记

聊天增强 ​

  • 聊天消息支持图像输入和显示
  • 聊天历史记录自动刷新
  • 消息引用和自动滚动

项目凭据管理 ​

  • 支持管理项目的系统访问信息
  • 系统提示词中注入凭据信息

需求评审 ​

  • 实现异步需求评审处理
  • 专项报告视图

架构优化 ​

  • GitHub Actions 自动构建 Docker 镜像
  • 使用 supervisord 管理多进程
  • 会话级 MCP 客户端缓存
  • 分布式任务队列基础设施

v1.1.0 ​

版本概述 ​

v1.1.0 重点优化了嵌入模型架构，从内置本地模型改为 API 调用模式，提升了灵活性和部署便捷性。

重要变更 ​

嵌入模型架构升级 ​

  • 弃用本地模型依赖，改用 API 调用嵌入模型
  • 支持自定义嵌入服务 API 配置
  • 新增模型连接测试功能

LLM 配置增强 ​

  • 模型名称自动完成输入框
  • LLM 配置切换功能
  • 默认 API Key 配置，开箱即用

功能优化 ​

  • 知识库信号处理器，确保数据库与 ChromaDB 一致性
  • Word 文档嵌套表格提取（支持3层）
  • 测试用例表单优化，支持只发送变更字段
  • PDF 内容提取改用 pypdf 库

部署优化 ​

  • Docker 镜像使用 DaoCloud 源加速
  • 优化 docker-compose 配置
  • 完善部署文档

v1.0.0 ​

版本概述 ​

v1.0.0 是项目的首个开源版本，建立了 AI 驱动测试自动化平台的基础架构。

核心功能 ​

  • AI 智能测试用例生成
  • 知识库管理与文档理解
  • MCP 工具调用集成
  • 项目管理与需求管理
  • 测试用例管理
  • LangGraph 对话编排
  • 多嵌入服务支持（OpenAI、Azure OpenAI、Ollama）