HadesRunner
简介
HadesRunner 是为提升 Hades 自动化测试框架开发效率而设计的 VS Code 插件。它集成了用例执行、AI 辅助编码、多语言处理、环境变量管理等实用功能，帮助开发者更高效地编写和维护测试用例。
功能特性
1. 用例快捷执行
- 悬浮按钮操作 - 用例上方显示快捷操作按钮
- 多种执行方式 - 支持运行单条用例、整个文件
- 环境切换 - 快速切换 Coohom/Beta 执行环境
- 调试支持 - 右键菜单快速 debug 当前 test 文件
2. AI 智能辅助
- 生成测试代码 - 选中用例描述，AI 自动生成对应的测试代码片段
- 函数注释生成 - 自动为函数生成 JSDoc 格式注释
- 报错日志分析 - 右键终端报错日志，AI 分析错误原因
- 知识库集成 - 将常用 JS 函数上传至 FastQA 知识库
3. 多语言 (i18n) 支持
- 批量替换 - 一键将文件中的中文文案替换为多语言词条
- 单个替换 - 支持通过 API 或本地缓存进行单个词条替换
- 词条高亮 - 自动将多语言词条高亮为中文显示，便于阅读
- Coohom 英文 - 支持 Coohom 环境英文文案替换
4. 环境变量管理
- 可视化面板 - 侧边栏环境变量管理面板
- 实时生效 - 修改后无需重启，立即生效
- 分组管理 - 支持按分组管理环境变量
- 状态持久化 - 内存存储，项目切换自动重置
5. CodeAgent 模块
- OpenCode 集成 - 快速打开 OpenCode，发送文件到 AI 助手
- ClaudeCode 集成 - 快速打开 ClaudeCode，发送文件到 AI 助手
- 配置页面 - 可视化配置页面，引导安装和配置插件
- 智能发送 - 支持发送整个文件或选中的代码片段，自动附带行号信息
6. 代码辅助
- 自动导包 - 检测缺失的模块并自动导入
- Hook 注释 - 一键注释/取消注释 hook 函数（beforeAll、beforeEach、afterAll、afterEach）
- 用例折叠 - 快速折叠其他用例，专注当前编写
- API 文档 - 内置 API 文档树视图，快速查询
7. WebSocket 服务
安装方式
从vscode 应用市场安装即可。
使用指南
用例执行
运行单条用例
运行整个文件
- 右键编辑器 →
Hades: 执行test文件
- 或使用快捷键（需自行配置）
Debug 用例
- 右键编辑器 →
Hades: debug test文件
- 点击用例上方的
Debug 按钮
切换执行环境
在运行用例时，若路径包含 beta 关键字，可选择 yarn beta 命令
需在设置中开启 HadesRunner.selectEnvWhenRunTest
AI 生成代码
- 在编辑器中选中用例描述文本
- 右键选择
Hades: AI 生成用例代码片段
- 在弹出的面板中查看生成的代码
- 点击
插入代码 或 复制代码
多语言替换
批量替换整个文件
- 打开包含中文文案的文件
- 右键 →
Hades: 替换 xpath 中文词条 (批量)
- 确认后自动替换所有匹配的中文
替换单个词条
选中需要替换的中文，右键选择：
Hades: 替换文案词条 by API (单个) - 通过 API 获取Hades: 替换中文文案词条byCache (单个) - 使用本地缓存
环境变量管理
- 点击左侧活动栏的
H 图标
- 选择
环境变量管理 面板
- 修改变量值后自动同步到项目
CodeAgent 模块
打开 AI 助手
- 在左侧活动栏点击
H 图标
- 选择
API 文档 面板
- 点击
CodeAgent 配置 菜单项
- 在配置页面中点击对应插件的
打开 按钮
发送文件到 AI 助手
方法一：右键菜单
- 在编辑器中右键 →
Hades: 发送文件到 OpenCode 或 Hades: 发送文件到 ClaudeCode
方法二：命令面板
- 按
Ctrl+Shift+P 打开命令面板
- 输入
Hades: 发送文件到 OpenCode 或 Hades: 发送文件到 ClaudeCode
注意：
- 如果有选中文本，会自动附带行号范围信息（如
@file.ts#L10-L20）
- 如果未选中，则发送整个文件
- OpenCode 首次启动需要等待 terminal 初始化（约 5-10 秒）
配置说明
在 VS Code 设置中搜索 HadesRunner 可查看所有配置项：
| 配置项 |
类型 |
默认值 |
说明 |
showCustomButton |
boolean |
true |
是否在用例上方显示运行按钮 |
showFold |
boolean |
true |
是否在用例上方显示折叠按钮 |
showCommentHook |
boolean |
true |
是否显示注释 hook 函数按钮 |
showOpenAIChat |
boolean |
true |
是否显示 AI 答疑按钮 |
selectEnvWhenRunTest |
boolean |
false |
执行用例时是否支持选择环境 |
hightlightPubLang |
boolean |
true |
是否自动翻译词条并高亮 |
autoImportMissingModule |
boolean |
true |
是否自动导入缺失的模块 |
codeAgent |
boolean |
true |
是否开启 AI 生成代码入口 |
命令列表
通过命令面板（Ctrl+Shift+P 或 Cmd+Shift+P）可执行以下命令：
用例执行
| 命令 |
说明 |
Hades: 执行test文件 |
运行当前测试文件 |
Hades: 执行test文件 (Coohom) |
使用 Coohom 环境运行 |
Hades: debug test文件 |
调试当前测试文件 |
Hades: 执行单条test |
运行光标所在的用例 |
AI 功能
| 命令 |
说明 |
Hades: AI 生成用例代码片段 |
选中用例描述，AI 生成测试代码 |
Hades: 分析报错原因 |
在终端中选中报错日志，AI 分析错误 |
Hades: 上传至fastQA知识库 |
将 lib 中的函数上传至知识库 |
Hades: 分析用例规范性 |
检查用例编写是否符合规范 |
CodeAgent
| 命令 |
说明 |
Hades: 打开 OpenCode |
打开 OpenCode 插件 |
Hades: 发送文件到 OpenCode |
发送当前文件到 OpenCode AI 助手 |
Hades: 打开 ClaudeCode |
打开 ClaudeCode 插件 |
Hades: 发送文件到 ClaudeCode |
发送当前文件到 ClaudeCode AI 助手 |
Hades: CodeAgent 配置 |
打开 CodeAgent 配置页面 |
多语言
| 命令 |
说明 |
Hades: 替换 xpath 中文词条 (批量) |
批量替换文件中的中文词条 |
Hades: 替换文案词条 by API (单个) |
通过 API 替换单个词条 |
Hades: 替换中文文案词条byCache (单个) |
使用本地缓存替换单个词条 |
快捷功能
| 命令 |
说明 |
Hades: 注释hook函数 |
注释/取消注释 hook 函数 |
Hades: 切换Socket服务器状态 |
开启/关闭 WebSocket 服务 |
Hades: 安装Hades Cli 工具 |
安装命令行工具 |
升级 pyBell 版本 |
升级二方包版本 |
开启脚本录制 |
启动脚本录制功能 |
更新日志
查看CHANGELOG.md了解版本更新历史。https://marketplace.visualstudio.com/items/hudi.hades-runner/changelog
| |
