易测 - Y-Test Runner

🚀 一个强大的 VSCode 扩展，让 UI 自动化测试变得更简单！

✨ 什么是易测？

易测是一个专为前端开发者设计的 UI 自动化测试助手，通过 VSCode 扩展的形式集成 y-test CLI 工具，让你可以在熟悉的编辑器中轻松进行测试项目初始化、测试用例生成、调试和执行。

本扩展提供了图形化界面封装 y-test 命令行工具的各项功能，无需记忆复杂的命令参数，通过可视化操作即可完成整个测试工作流。

🎯 核心功能

🚀 项目初始化

• 📦 一键初始化 y-test 测试项目（ytest c）
• ⚙️ 可视化配置开发/测试域名、Token等参数
• 🔄 自动创建项目配置文件并同步到服务器
• 💾 持久化保存项目配置，避免重复设置

📝 智能测试用例生成

• 📁 可视化选择项目目录和测试用例文件（JSON格式）
• 🤖 一键执行测试生成命令（ytest gp）
• 📊 实时查看生成进度和控制台输出
• ✅ 自动定位生成的测试文件（.spec.ts）

🔍 智能悬停提示

• 💡 在测试文件（.spec.js/.test.ts等）中悬停时自动识别测试用例
• ⚡ 快速生成单个测试用例的自动化代码
• 🧠 支持知识库辅助，让代码生成更智能
• 📝 支持从命令面板快速调用代码生成功能

🐛 交互式调试

• 🎮 启动 Playwright UI 调试模式（ytest tp --ui）
• 🔄 实时查看测试执行过程和调试信息
• ⏹️ 随时停止和重启调试会话
• 🔍 自动检测调试服务启动状态和错误

⚡ 测试执行

• 🏃 一键执行全部或指定测试文件（ytest tp）
• 📊 实时显示测试执行日志
• ⏹️ 支持中途停止执行
• 📈 测试完成后自动定位报告文件

📊 测试报告

• 📈 自动扫描并列出所有测试报告文件
• 🌐 一键在浏览器中打开 HTML 报告
• 🔄 实时刷新报告列表
• 📂 支持查看报告目录结构

💡 使用技巧

🎯 智能悬停功能

在已生成的测试文件（如 y-test/e2e/*.spec.ts）中：

1. 将鼠标悬停在 test() 或 it() 函数的测试用例描述上
2. 查看弹出的悬停提示窗口，显示测试用例完整信息
3. 点击 🚀 生成单条自动化测试代码 链接
4. 在打开的代码生成面板中：
   • 输入自然语言描述的测试步骤
   • 选择是否使用知识库辅助生成
   • 点击生成按钮查看生成的测试代码
   • 复制代码到项目中使用

提示：智能悬停支持多种测试文件格式：

• .spec.js / .spec.ts
• .test.js / .test.ts
• test/ 或 tests/ 或 e2e/ 目录下的文件

⌨️ 命令面板快捷操作

按 Ctrl+Shift+P (Windows/Linux) 或 Cmd+Shift+P (Mac) 打开命令面板，输入"易测"查看所有可用命令：

• YTest: 生成单条自动化测试代码 - 快速生成单个测试用例代码
• YTest: 打开单条用例代码生成面板 - 打开专用代码生成界面
• YTest: 重置插件状态 - 清除所有配置和状态，重新开始
• YTest: 刷新 YTest 环境 - 更新 y-test 工具链和依赖
• YTest: 检查插件更新 - 检查是否有新版本可用

🔧 状态管理与持久化

易测会自动保存以下信息（存储在 VSCode 工作区状态中）：

• 🏠 选择的根目录路径 - 避免每次打开都重新选择
• ⚙️ 项目初始化配置 - 保存域名、Token等设置
• 📝 最近使用的文件 - 快速访问常用测试文件

需要清除所有保存的状态？使用 重置插件状态 命令即可恢复初始状态。

📂 项目目录结构

初始化后，y-test 会在项目根目录创建以下结构：

your-project/
├─── midscene_run/         # 测试运行数据
│       └── report/           # 测试报告
│           └── index.html
├── y-test/                    # y-test 测试目录
│   ├── config.json           # 项目配置文件
│   ├── cases/                # 测试用例定义（JSON格式）
│   │   └── example.json
│   └── e2e/                  # 生成的测试文件
│       └── example.spec.ts
├── playwright.config.ts      # Playwright 配置（自动生成）
└── package.json

🎨 界面介绍

主侧边栏面板

• 🌳 目录选择器 - 树形结构浏览和选择项目根目录
• 📁 文件浏览器 - 显示 y-test/cases/ 下的测试用例 JSON 文件
• 🛠️ 操作工具栏 - 提供以下功能按钮：
  • 🚀 初始化项目 - 首次配置 y-test 项目
  • 📝 生成测试 - 从 JSON 生成测试代码
  • 🐛 开始调试 - 启动 Playwright UI 模式
  • ⚡ 执行测试 - 运行测试并生成报告
  • ⏹️ 停止任务 - 终止当前运行的任务
• 📊 报告列表 - 显示 midscene_run/report/ 下的所有报告文件
• 📋 实时日志 - 显示命令执行状态和输出

单条代码生成面板

• 💻 代码编辑器 - 实时预览生成的测试代码
• 📝 输入区域 - 输入自然语言测试步骤描述
• ⚙️ 配置选项 - 选择是否使用知识库辅助
• 🔄 生成按钮 - 触发代码生成流程
• 📋 复制按钮 - 一键复制生成的代码

输出面板

在 VSCode 底部的"输出"面板中，选择 "易测 YTest Runner" 频道可以查看：

• ✅ 命令执行的详细日志
• ⚠️ 错误和警告信息
• 📊 测试进度和结果
• 🔍 调试信息（用于问题排查）

🆘 常见问题

Q: 提示 "ytest 命令未找到"？

A:

1. 确保已全局安装 y-test CLI：npm install -g @ke/y-test
2. 验证安装：在终端运行 ytest --version
3. 如果安装后仍提示未找到，尝试重启 VSCode
4. 检查系统 PATH 环境变量是否包含 npm 全局包路径

Q: 初始化项目时出错？

A:

1. 确保选择的目录是前端项目的根目录（包含 package.json）
2. 检查目录是否有写入权限
3. 确认已安装 Git 并配置了用户信息（git config user.email）
4. 查看输出面板的详细错误信息

Q: 生成的测试代码在哪里？

A:

• 从 JSON 生成的测试文件位于：y-test/e2e/ 目录
• 单条代码生成的代码显示在代码生成面板中，需手动复制到项目
• 生成成功后，插件会自动打开生成的文件

Q: 调试模式启动失败？

A:

1. 确保项目已正确初始化（存在 y-test/ 目录）
2. 检查是否缺少依赖：运行 npm install 和 npx playwright install
3. 查看输出面板的错误信息，通常会提示缺少的模块
4. 确认端口未被占用（调试模式默认使用特定端口）

Q: 如何查看详细的执行日志？

A:

1. 打开 VSCode 底部面板（View → Output 或 Ctrl+Shift+U）
2. 在下拉菜单中选择 "易测 YTest Runner"
3. 所有命令执行、进程输出和错误信息都会实时显示

Q: 插件运行异常或状态错误？

A: 尝试以下方法：

1. 使用命令面板 → "YTest: 重置插件状态" 清除所有缓存
2. 重启 VSCode
3. 检查 y-test CLI 版本是否最新：npm update -g @ke/y-test
4. 查看输出面板的详细错误信息并反馈给开发团队

Q: 测试报告打不开？

A:

1. 确认测试已成功执行完成
2. 检查 y-test/midscene_run/report/ 目录是否存在报告文件
3. 点击侧边栏的"刷新报告"按钮重新扫描
4. 确保系统已安装浏览器（Chrome/Edge/Firefox）

Q: 智能悬停功能不生效？

A:

1. 确保文件路径包含 .spec.、.test. 或在 test/、e2e/ 目录下
2. 检查是否打开了 JavaScript/TypeScript 文件
3. 悬停位置需在 test() 或 it() 函数的字符串参数上
4. 如果插件侧边栏未打开过，悬停可能不生效（已在 v0.0.13 修复，通过添加语言激活事件）