Skip to content

YuanTest Playwright

Changelog

yuandiv/yuantest-playwright

更新日志¶

本文件记录了项目的所有重要变更。

格式基于 Keep a Changelog，本项目遵循语义化版本。

1.2.0 (2026-07-07)¶

✨ 新增功能¶

AI conversation history and real-time test progress tracking (61cb3de)
executor: improve stall detection and add all_tests_completed handling (ff67ac0)
merge ChatService and AgentService into UnifiedAIService (16ef1c0)

🐛 Bug 修复¶

修复 agent 循环中 tool_calls 缺失 type 字段导致 Plan-Execute 中断 (3666c84)
优化会话切换与流式状态管理 (ccf4037)

♻️ 重构¶

统一配置文件读写架构 (510bf3f)
用 Map 策略模式重构 Agent 管线工具路由 (87bd1ef)

1.1.6 (2026-06-09)¶

1.1.5 (2026-06-05)¶

📝 文档¶

update license (00b2a96)

1.1.4 (2026-06-04)¶

1.1.3 (2026-06-02)¶

🐛 Bug 修复¶

fix test error (9bed2af)

1.1.2 (2026-05-26)¶

1.1.1 (2026-05-22)¶

1.1.0 (2026-05-20)¶

✨ 新增功能¶

集成Playwright Test 代理 (bfeffd8)
add Agent system (f2ed3c0)

1.0.11 (2026-05-18)¶

修复冗余配置异常

1.0.10 (2026-05-13)¶

🐛 Bug 修复¶

修复lint和test异常，解决web ui 和cli不统一的问题 (348a900)

1.0.9 (2026-05-09)¶

🛠 变更¶

失败分析优化¶

FailureAnalysis - 优化失败分析与诊断增强
改进失败原因分类逻辑
增强诊断结果准确性
修复 FailureAnalysis 展示问题

不稳定用例分析优化¶

Flaky 分析 - 优化稳定性用例分析
改进不稳定用例检测算法
修复 Flaky Test 展示问题
增强历史数据追踪

用例隔离增强¶

隔离策略 - 增强用例隔离逻辑
支持自定义"不稳定用例"已隔离用例出入标准
优化隔离判定参数配置
改进隔离/释放操作流程

AI 分析优化¶

AI 诊断 - 优化 AI 诊断结果持久化存储
改进诊断结果存储机制
增强诊断结果持久化
优化 AI 分析结果展示

报告改进¶

HTML 报告 - 优化报告展示
支持执行器中用例排序
优化 HTML 报告展示
修复报告详情中截图和视频打开错误

🗑 移除¶

删除无用文件

1.0.8 - 2026-05-06¶

新增¶

AI 智能诊断¶

Diagnosis 模块 - 完整的 AI 智能诊断功能模块
cluster.ts - 失败测试聚类分析
context-enricher.ts - 测试上下文信息增强
knowledge-base.ts - 知识库管理
智能失败原因分析和修复建议
支持多维度失败模式识别

Flaky 测试智能分析¶

Flaky 分析增强 - Flaky 测试智能分析系统优化
causal-graph.ts - 因果关系图分析
predictor.ts - Flaky 测试预测器
quarantine-strategy.ts - 隔离策略管理
trend.ts - 趋势分析
classifier.ts - Flaky 测试分类器
correlation.ts - 相关性分析
root-cause.ts - 根本原因分析

前端增强¶

LLMConfigDialog - 新增 LLM 配置对话框组件
支持 AI 模型配置管理
API 密钥和端点配置
模型参数调整
TestDetailModal - 增强测试详情模态框
集成 AI 诊断结果展示
智能修复建议显示
失败原因可视化

API 扩展¶

API 服务 - 新增 AI 诊断相关 API
LLM 配置管理接口
智能诊断请求接口
失败分析接口

变更¶

Orchestrator 优化¶

Orchestrator - 增强测试编排功能
改进测试分配策略
优化负载均衡算法
增强失败处理机制

实时通信¶

Realtime - 改进实时通信模块
优化 WebSocket 消息处理
增强事件推送机制

修复¶

异常处理 - 修复部分异常处理逻辑
改进错误边界处理
增强异常捕获机制

文档¶

README - 更新中英文文档
添加 AI 诊断功能说明
更新使用示例

测试¶

单元测试 - 新增大量单元测试
diagnosis.test.ts - 诊断模块测试
flaky-*.test.ts - Flaky 分析相关测试
cluster.test.ts - 聚类分析测试
knowledge-base.test.ts - 知识库测试
orchestrator.test.ts - 编排器测试

1.0.7 - 2026-04-29¶

新增¶

Flaky 测试管理增强¶

Flaky 模块 - 增强 Flaky 测试管理功能
改进不稳定用例检测算法
优化隔离策略
增强历史数据追踪

前端优化¶

Dashboard UI - 多项前端优化
App.tsx - 优化主应用组件逻辑
HealthDashboard.tsx - 改进健康状态面板
SidebarCards.tsx - 增强侧边栏卡片组件
ReporterPanel.tsx - 改进报告面板

国际化¶

i18n - 新增翻译键
添加 Flaky 管理相关翻译
改进错误提示本地化

变更¶

执行器优化¶

Executor - 大幅优化执行器逻辑
改进测试执行流程
优化并发控制
增强错误处理和重试机制
改进进度追踪

报告器改进¶

Reporter - 重构报告生成模块
移除 EJS 模板，改用静态 HTML
优化报告生成性能
简化报告结构

实时通信¶

Realtime - 增强实时通信功能
优化事件推送
改进连接管理

修复¶

CI 修复 - 修复 CI 构建错误
修正 constants.test.ts 测试用例

测试¶

单元测试 - 新增 Flaky 模块单元测试
flaky.test.ts - 完整的 Flaky 管理测试套件

1.0.6 - 2026-04-24¶

新增¶

实时报告¶

Realtime 模块 - 新增实时报告功能
实时测试进度推送
WebSocket 连接管理
事件广播机制

文档¶

USAGE.md - 新增详细使用文档
完整的 CLI 使用指南
API 编程示例
配置说明

工具函数¶

Utils - 新增工具模块
filesystem.ts - 文件系统操作工具
strings.ts - 字符串处理工具

变更¶

执行器优化¶

Executor - 优化执行器相关逻辑
改进测试执行流程
优化进程管理
增强错误处理

报告器增强¶

Reporter - 优化报告实时展示
改进报告生成逻辑
增强实时更新机制
优化数据结构

测试发现¶

Discovery - 改进测试发现模块
优化测试文件扫描
改进测试用例收集
增强性能

前端改进¶

Dashboard UI - 多项前端改进
App.tsx - 优化主应用组件
HealthDashboard.tsx - 改进健康状态面板
增强实时数据展示

配置优化¶

Config - 改进配置加载和合并
loader.ts - 优化配置加载逻辑
merger.ts - 改进配置合并策略

修复¶

测试修复 - 修复单元测试问题
更新测试断言
修正测试用例

移除¶

示例测试 - 移除示例测试文件
删除 api-tests.spec.ts
删除 dashboard.spec.ts
删除 login.spec.ts
删除 shopping-cart.spec.ts
删除 user-management.spec.ts

文档¶

README - 更新中英文文档
添加实时报告功能说明
更新使用示例

1.0.5 - 2026-04-21¶

修复¶

功能修复¶

执行逻辑 - 不再使用正则表达式匹配测试标题，改为收集测试用例的文件位置信息，遍历 describe 块收集所有测试的位置

1.0.4 - 2026-04-21¶

修复¶

测试修复¶

E2E 测试 - 修复 CLI E2E 测试兼容性问题
更新测试用例以适配新的 API 响应格式
改进测试超时处理

配置修复¶

ConfigLoader - 修复配置加载中的路径解析问题
改进配置文件的搜索逻辑
增强错误处理机制
PlaywrightConfigMerger - 修复配置合并的边界情况
处理缺失配置项的默认值
优化配置验证逻辑

单元测试¶

Trace 测试 - 修复 Trace 管理器的单元测试
添加缺失的模拟数据
修复断言逻辑

1.0.3 - 2026-04-21¶

新增¶

文档生成¶

TypeDoc 配置 - 添加 TypeDoc 文档生成支持
配置 typedoc.json 支持中文文档生成
添加 docs 和 docs:watch 脚本命令
支持自定义导航链接和侧边栏链接
配置代码可见性过滤器

配置增强¶

PlaywrightConfigMerger - 增强配置合并功能
支持 PLAYWRIGHT_* 环境变量覆盖
改进项目路径验证逻辑
添加配置验证结果缓存
优化默认配置与项目配置的合并策略

变更¶

配置加载器¶

ConfigLoader - 改进配置加载机制
优化配置文件的搜索优先级
改进配置解析错误处理
支持更多配置格式变体

测试发现¶

Discovery - 优化测试发现模块
改进测试文件扫描性能
优化测试目录解析逻辑
增强对复杂项目结构的支持

UI 服务器¶

DashboardServer - 改进服务器配置处理
优化测试目录切换逻辑
改进配置验证反馈
增强错误信息本地化

Dashboard UI¶

App.tsx - 优化主应用组件
改进状态管理逻辑
优化组件渲染性能
简化代码结构
ExecutorDialog - 改进执行器对话框
优化用户交互体验
改进错误提示
HealthDashboard - 改进健康状态面板
优化数据展示逻辑
改进组件性能

国际化¶

i18n 模块 - 改进国际化支持
优化语言切换逻辑
更新翻译内容

API 服务¶

API - 改进前端 API 服务
优化请求处理逻辑
改进错误处理

文档¶

README - 更新中英文文档
添加更详细的功能说明
改进使用示例
更新路线图

1.0.2 - 2026-04-16¶

新增¶

测试产物管理¶

ArtifactManager - 完整的测试产物管理模块
discoverArtifacts() - 扫描目录发现所有测试产物
getArtifact() - 根据 ID 或路径获取单个产物
getArtifactContent() - 读取产物文件内容
deleteArtifact() - 删除指定的产物文件
cleanArtifacts() - 清理过期产物（默认 7 天）
getArtifactsByType() - 按类型筛选产物（截图/视频/追踪）
getArtifactsByTest() - 按测试 ID 筛选产物
getArtifactStats() - 获取产物统计信息
自动文件类型检测（图片、视频、追踪文件）
可通过 maxFileSize 配置文件大小过滤

变更¶

存储改进¶

FilesystemStorage.mkdir() - 修复目录创建的竞态条件
创建目录前添加存在性检查
正确处理并发创建时的 EEXIST 错误
使用 { recursive: true } 选项安全创建嵌套目录

测试改进¶

测试优化 - 添加模拟以防止实际 Playwright 测试执行
在集成测试和单元测试中模拟 runPlaywrightTests()
提高测试速度并专注于逻辑验证

修复¶

.gitignore 规则 - 修正产物文件夹忽略模式
添加前导 / 仅忽略根目录文件夹：/artifacts/、/traces/、/visual-testing/、/html-report/
防止意外忽略同名的子目录

1.0.1 - 2026-04-15¶

新增¶

配置管理¶

PlaywrightConfigMerger - 新的配置验证和合并系统
自动发现 playwright.config.ts/js/mts/mjs 文件
配置文件验证（存在性和可解析性）
用户配置与框架默认值的智能合并
自动注入必需的报告器（html/json）

国际化 (i18n)¶

i18n 模块 - 完整的国际化支持
支持中文 (zh) 和英文 (en)
通过 setLang() 进行全局语言切换
翻译函数 t(key, lang?) 支持动态语言
新增翻译键：configNotFound、configParseFailed、testDirNotFound、executorAlreadyRunning

变更¶

API 增强¶

API 响应结构 - 增强带有详细错误信息的 API 响应
startRun() 和 rerunTest() 现在返回 StartRunResult 对象而非 boolean
新接口：{ success: boolean; error?: string }
提供详细错误信息以便更好地调试

配置变更¶

默认端口 - 默认 UI 端口从 3000 改为 5274
避免与常见开发服务器冲突（如 React Dev Server）
更新所有文档和示例

前端改进¶

仪表板 UI - 增强用户体验
移除"刷新测试用例"按钮（切换目录时自动刷新）
使用 formatStartError() 函数改进错误处理
更好的测试目录切换逻辑并提供验证反馈

后端增强¶

UI 服务器 - 改进请求处理
添加语言中间件以自动检测语言
使用 PlaywrightConfigMerger.validateProjectPath() 重构测试目录验证
增强 test discovery API，添加 configValidation 字段
测试发现 - 更好的配置处理
使用配置文件目录作为工作目录
错误时返回验证结果而非空列表
执行器 - 动态配置管理
动态配置合并而非硬编码路径
基于配置位置正确解析工作目录

修复¶

类型安全 - 在 CLI 中添加 Artifact 类型导入
错误追踪 - 在配置加载器的错误对象中添加 cause 属性
测试断言 - 更新测试消息以匹配新的 CLI 输出

依赖¶

FontAwesome - 从 CDN 迁移到本地包
用 @fortawesome/fontawesome-free: ^7.2.0 替换 CDN 链接
提高稳定性并减少外部依赖

破坏性变更¶

默认端口：端口从 3000 改为 5274 - 需更新脚本和配置
API 响应：startRun() 和 rerunTest() 现在返回 { success, error? } 而非 boolean
测试目录验证：使用新的 validateProjectPath() 方法替代旧的验证逻辑

1.0.0 - 2026-04-11¶

新增¶

核心功能¶

Orchestrator - 智能测试编排，支持自动测试发现和智能分片
支持跨多个分片的分布式测试执行
基于测试历史时长的负载均衡
ShardOptimizer 用于智能测试分配
Executor - 通过 Playwright CLI 的测试执行引擎
支持并行测试执行
失败测试的自动重试机制
多浏览器测试（chromium、firefox、webkit）
通过事件实时进度追踪
ParallelExecutor 用于并发测试运行
Reporter - 全面的测试报告系统
使用 EJS 模板生成 HTML 报告
JSON 报告输出
失败分析，包含分类和修复建议
测试产物管理（截图、视频、追踪）
不稳定用例管理 - 自动检测和隔离不稳定用例
基于可配置阈值的不稳定用例检测
隔离问题测试的隔离机制
历史不稳定用例追踪
用于隔离/释放操作的 REST API
Web 仪表板 - 测试管理的可视化界面
通过 WebSocket 实时显示测试进度
历史测试运行可视化
不稳定用例管理 UI
失败分析仪表板
包含 15+ 端点的 REST API
CLI 工具 - 完整的命令行界面
yuantest run - 使用各种选项执行测试
yuantest orchestrate - 预览测试分配计划
yuantest report - 查看测试报告
yuantest flaky - 管理不稳定用例
yuantest analyze - 分析测试失败
yuantest ui - 启动 Web 仪表板

附加功能¶

追踪管理 - Playwright 追踪文件管理和组织
注解支持 - 解析并遵守测试注解（skip、only、fail、slow、fixme、todo）
标签管理 - 用于筛选和组织的测试标签系统
视觉测试 - 集成 pixelmatch 的截图对比
产物管理 - 测试产物的有序存储
存储提供者 - 可插拔的存储系统（内存和文件系统实现）
缓存系统 - LRU 和 TTL 缓存实现
配置加载器 - 从 yuantest.config.ts 加载和合并配置
验证 - 基于 Zod 的配置验证
中间件 - 用于错误处理和验证的 Express 中间件工具

技术细节¶

使用 TypeScript 5.9+ 构建
目标 ES2020
CommonJS 模块输出
包含完整类型声明
支持 Node.js >= 16.0.0

依赖¶

@playwright/test ^1.40.0
express ^4.18.2
ws ^8.14.2
ejs ^5.0.1
commander ^11.1.0
zod ^3.25.76
pixelmatch ^7.1.0
chalk ^4.1.2
ora ^5.4.1
dayjs ^1.11.10

文档¶

包含使用示例的详细 README
API 编程指南
CLI 命令参考
REST API 文档

测试¶

核心模块的单元测试
orchestrator-executor 流程的集成测试
CLI 功能的 E2E 测试
带覆盖率阈值的 Jest 配置

未来路线图¶

计划功能¶

[ ] 自定义报告器和执行器的插件系统
[ ] 云存储提供者（S3、GCS、Azure Blob）
[ ] 跨多台机器的分布式测试执行
[ ] AI 驱动的失败分析和修复建议
[ ] Slack/Teams 通知集成
[ ] GitHub Actions 集成
[ ] 性能基准测试和回归检测
[ ] 测试用例管理集成