Releases: MGdaasLab/WHartTest
Releases · MGdaasLab/WHartTest
Release list
v2.5.1
v2.5.0
WHartTest v2.5.0-ce 更新说明
本项目已从 v2.4.0 正式升级至 v2.5.0-ce (Community Edition)。本版本在 API 测试管理、测试用例规划、系统安全审计、多主题交互、执行引擎自动化以及容器化部署等方面进行了全面的重构与升级。
本次发布的核心更新在于引入了 全新的“测试用例思维导图” 和 “安全审计与操作日志” 两大核心模块。以下是详细更新内容：
核心更新
1. 全新“测试用例思维导图”模块 (Interactive TestCase Mindmap)
系统全新集成了基于 simple-mind-map 的测试用例思维导图设计视图，彻底改变了传统的表格/列表用例管理模式，实现用例设计的可视化与直观规划。
- 一键视图切换：在测试用例管理页面，用户可通过头部视图切换器，在列表视图与思维导图视图之间一键无缝切换。
- 右键上下文菜单 (Context Menu)：在画布中右键可呼出快捷操作菜单，支持新建子模块、新建用例、新建前置条件、新建步骤、新建备注以及新建预期结果等节点操作。
- 极佳的交互控制：
- 模块拖拽调整：支持通过鼠标直接拖放（Drag-and-Drop）脑图中的分支节点，轻松调整模块的所属层级与排序。
- 快捷编辑：双击节点即可直接重命名，叶子节点右侧配有快捷
+按钮以便快速插入子项。 - 节点复制与粘贴：提供对思维导图节点的复制（Copy）与粘贴（Paste）功能。
- 用例等级标记：在右键菜单中支持一键将用例等级设为 P0、P1、P2、P3，并显示为彩色标签，方便过滤与重点排查。
- 画布控制：支持鼠标滚轮或快捷键放大、缩小、以及一键自适应画布。
- 多主题样式：内置 Morandi (莫兰迪)、Classic (经典蓝)、Fresh Green (清新绿)、Black Gold (黑金) 以及 Dark (暗色) 五种预置配色，并与系统主题色动态匹配。
- 脑图数据导出：支持一键将当前脑图导出为高清晰度 PNG 图片或
.json脑图数据文件。
2. 全新“安全审计与操作日志”模块 (Operation Logs & Audit)
为满足多用户协作、日常维护与系统安全审计需求，新增了全局的操作日志记录、查询与管理功能。
- 全方位安全审计追踪：系统自动记录所有用户的关键/敏感操作（包括用户名、操作模块、操作类型、请求路径、IP地址、执行耗时、User-Agent等）。
- 强大的检索与过滤：
- 支持按用户名、操作模块、请求路径进行模糊搜索。
- 支持按请求方法（GET, POST, PUT, DELETE, PATCH）和响应状态码（200, 400, 500等）进行快速过滤。
- 支持通过时间段（Date Range）进行精确定位。
- 深度日志明细查看：
- 支持以 Drawer 抽屉形式展开详细审计明细，清晰高亮显示执行时间长于 1000ms 的慢请求。
- 完整展示操作时捕获的 JSON 请求数据 (Request Data) 与 JSON 响应数据 (Response Data)，提供代码格式化显示并支持一键复制，极大地方便了问题定位。
- 灵活的清理设置：
- 支持管理员一键“立即清理”过期操作日志。
- 内置操作日志清理设置模态框，支持管理员灵活配置自动清理保留时间。
- 权限管控与国际化：
- 限制仅系统管理员及授权审计人员可访问该模块，普通用户提示无权限；主导航新增“Logs”入口，且已全面适配中英文国际化（i18n）。
其他功能优化与提升
3. 接口测试与用例编辑优化 (Test & Case Management)
- API提取变量元数据 (
extract_meta)：在ApiInterfaceInterface模型中引入新的 JSON 字段extract_meta并执行相应数据库迁移，优化了 ce/pe 变体数据逻辑，前端组件同步支持数据获取与交互。 - JSON 响应路径查看器：用例步骤中断言或参数提取的响应 JSON 路径选择抽屉替换为全新的 Response JSON Viewer 组件，选择体验更佳。
- 步骤细节打磨：允许测试用例步骤的“预期结果”字段为空，以增强断言灵活性；支持用例步骤重命名及接口数据快速更新；增强了断言规则和响应处理，支持多种值类型和格式化显示。
- 操作方法与参数映射：新增“切换页签”操作，增强并分组了操作方法选择，支持用例步骤数据覆盖，优化详情展示。
4. 目录管理与拖拽级联 (Module Directory & Drag-and-Drop)
- 模块排序与深度校验：在
ApiModule模型中增加level和order字段，实现防循环引用检测、深度层级限制校验和前端目录树拖拽。 - 级联删除与关联清理：支持删除模块时递归清空其下的所有子模块和关联测试用例，同步删除关联接口；限制用例只能在用例模块节点下创建，防止数据孤儿。
5. UI/UX 体验与主题切换 (UI/UX & Themes)
- 登录页全局主题切换：登录页面新增亮色/暗色主题按钮，结合全局主题 Store 实现视图切换的平滑过渡。
- 剪切板回退方案：针对 HTTP（非安全）环境，新增了手动复制回退方案，防止剪切板 API 报错。
6. 执行引擎与自动化能力 (Execution Engine & UI Automation)
- API 接口执行日志深度诊断：执行日志中新增详细
trace ID和请求体摘要；优化了网络传输失败时，对请求体数据的自动恢复与快照保留。 - 占位符与复杂函数解析：支持占位符自动解析，对请求中未解析的占位符增加警告日志；更新正则以支持更复杂的函数参数解析并补充单元测试。
- UI 自动化数据库交互扩展：Playwright 自动化执行器中新增对 MySQL 和 DB2 数据库的直接查询执行步骤，并完成了数据库配置的迁移与前端适配。
- 会话标题智能总结：支持对聊天会话标题的自动生成和异步轮询，并支持重命名。
7. 环境依赖与部署优化 (Dependencies & Deployment)
- Docker 镜像与端点优化：更新 Dockerfile 添加
ca-certificates和libgomp1依赖，优化 BM25 模型离线下载及多端点备选逻辑。 - 底层库升级：升级
langgraph-checkpoint-sqlite版本要求至>=3.0.3。 - SSL 验证配置：将默认 SSL 验证修改为
false，支持在环境参数中灵活开启。
v2.4.4
v2.4.3
v2.4.2
v2.4.1
v2.4.0
WHartTest v2.4.0
版本概述
v2.4.0 重点补齐了接口自动化平台，新增从接口定义、环境管理、快速调试、用例编排、测试任务到测试报告的完整链路；同时扩展了 Skill 中心能力，引入 DeepSeek 模型支持，并补齐中英双语与主题适配，进一步提升平台的可用性与扩展性。
重点新增
接口自动化平台
- 新增
接口管理、测试用例、测试任务、测试报告、环境管理、自定义函数、同步配置七大模块。 - 支持接口模块管理、接口定义维护、快速调试、断言配置、提取变量、请求头 / 参数 / 请求体配置。
- 支持环境变量、项目级全局请求头、数据库配置、自定义函数、SQL 钩子等能力。
- 支持接口测试用例编排、批量测试任务执行、报告查看、同步历史与回滚。
- 新增
api-automation-skill，支持通过 Skill 方式调用接口自动化能力。
Skill 中心与扩展能力
- 新增 Skill 商店与来源管理能力。
- 支持从默认源或自定义源浏览 Skill、查看 README、批量安装与批量卸载。
- 支持通过 ZIP URL 导入 Skill，扩展接入更加灵活。
模型与提示词能力
- 新增 DeepSeek 供应商支持，优化模型接入与连接配置体验。
- 默认提示词模板重构为按语言初始化，支持中英文提示词模板加载与更新。
国际化支持
- 新增登录页、注册页、主界面等场景的中英双语切换支持。
- 补齐 API 测试、用户管理、测试任务等模块的国际化与遗留文案适配。
体验优化
- 优化接口测试相关页面的亮色 / 暗色主题适配，改善表格、详情页、空状态与卡片展示体验。
- 优化任务详情、报告详情、执行历史与历史报告分页处理逻辑。
- 增强接口请求体、参数格式与错误处理兼容性。
- 优化环境配置、全局请求头和变量提取回写的使用体验。
- 调整 Docker / 安装脚本与分支本地数据库选择逻辑，降低本地开发和升级成本。
升级说明
- 升级后请执行数据库迁移：
uv run python manage.py migrate - 源码部署请同步依赖，确保接口自动化相关依赖已更新：
- 后端：
uv sync - 前端：
npm install
- 后端：
- 如使用 Docker / Compose 部署，请重新构建并启动最新镜像。
- 本版本新增接口自动化相关数据表与配置项，建议升级前先备份数据库。
- 如需启用新增的中英文默认提示词模板，可在系统内重新初始化对应语言的默认提示词。
v2.3.0
版本概述
v2.3.0 以 需求文档在线编辑与多模态输入 为核心，集成了 ONLYOFFICE DOCX 编辑器并支持需求文档图片规范化处理；同时引入多需求模块联合生成测试用例能力，进一步提升 AI 生成的精准度。Token 消耗追踪全面深化，新增缓存命中字段与工具/提示词真实 Token 开销统计；技能文件管理引入信号驱动自动清理机制；测试用例列表新增分页与轻量序列化，显著降低大数据量场景的传输开销。
🚀 重大升级
需求文档在线编辑
- 集成 ONLYOFFICE DOCX 编辑器，支持需求文档在线编辑与文件上传。
- 支持用户消息中需求文档图片的规范化与多模态输入处理。
- DOCX 编辑器服务不可用时提供友好的降级提示。
AI 测试用例生成增强
- 需求模块选择从单一改为多选，支持跨模块联合生成测试用例。
- 新增"全选模块"快捷操作与工具提示图标，提升交互效率。
- 模板生成逻辑同步升级，适配多模块输入场景。
✨ 新功能
Token 消耗深度追踪
- 新增缓存命中（Cache Hit）字段，精细化区分缓存与非缓存 Token 消耗。
- 增加工具定义与系统提示词的真实 Token 开销计算，优化上下文限制管理。
AgentLoopStreamAPIView新增缓存命中情况日志记录。
技能文件生命周期管理
- 采用信号（Signal）驱动替换模型
delete()方法，覆盖批量删除和级联删除等全场景的技能文件自动清理。 - 新增孤立技能目录清理的
dry-run管理命令，方便运维排查。
测试用例列表性能优化
- 新增标准分页类，支持动态页面大小配置。
- 新增测试用例列表专用序列化器，仅传输列表展示所需字段，减少大数据量场景的传输开销。
🐛 问题修复
- 修复
DocumentDetailView文本对齐样式异常。 - 修复测试用例视图中重复
Response导入导致的错误处理异常。 - 修复 DOCX 编辑器基础 URL 端口配置不一致问题。
- 修复
tsconfig.app.json路径别名配置（移除废弃的baseUrl，使用相对路径）。
🔧 优化改进
- 更新 Playwright MCP 服务入口点与健康检查命令。
- 优化 Skill 工具并发执行配置，调整最大工作线程数。
- 根据 git 分支后缀自动选择本地开发数据库，简化多分支并行开发配置。
📦 升级说明
- 升级后请执行数据库迁移：
python manage.py migrate。 - DOCX 编辑器为可选服务，不部署不影响其他功能正常使用。
- 若使用技能模块，建议执行一次孤立目录清理：
python manage.py cleanup_skill_dirs --dry-run预览后再执行。
v2.2.0
✨ 新功能
任务中心与定时调度系统
- 新增任务中心模块：基于 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 自动化用例”
📦 升级说明
- 数据库迁移：升级后请执行数据库迁移：
python manage.py migrate - 依赖安装：需要重新安装依赖：
pip install -r requirements.txt - 若需启用
xinference，请在 compose 文件中手动开启对应服务。 - 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一键构建和启动服务