UStackUStack
KushoAI UI Testing TUI icon

KushoAI UI Testing TUI

KushoAI UI Testing TUI 开源 CLI TUI:录制 UI 流程并用 AI 扩展为完整 Playwright 测试套件,覆盖边界与错误场景。

KushoAI UI Testing TUI

什么是 KushoAI UI Testing TUI?

KushoAI UI Testing TUI 是一个开源命令行界面 (TUI),用于从录制的浏览器流程生成 Playwright UI 测试套件。只需录制一次用户操作,即可使用 AI 将其扩展为额外测试变体,包括边界情况和错误场景,而无需手动翻译每个点击和输入。

核心工作流程全程在终端中进行:使用 Playwright 的浏览器录制器录制,终端编辑器中审查并调整生成的 Playwright 脚本,然后根据纯英文指令让 KushoAI 扩展测试套件。您可以无头或可见浏览器运行生成的测试,并生成详细的 HTML 报告。

主要特性

  • 使用 Playwright 的浏览器录制器录制 UI 流程:在真实浏览器中捕获导航、点击、表单输入和提交,作为测试生成的起点。
  • AI 将单次录制扩展为完整的 Playwright 测试套件:从原始捕获流程生成多个变体、边界情况和错误场景。
  • 交互式 TUI 菜单(箭头键引导工作流程):提供凭据、录制、测试生成和运行的提示步骤,无需记忆标志。
  • 使用纯英文指令编辑和优化生成的测试:通过 “Kusho Edit” 流程,根据覆盖需求迭代调整扩展测试。
  • 无头或有头运行测试,支持可选视频和 HTML 报告:选择执行模式,生成用于检查失败的有用工件。
  • 本地执行,本地凭据存储:凭据保存至 ~/.kusho-credentials,工具使用您选择的 LLM 提供商。

如何使用 KushoAI UI Testing TUI

  1. 安装并链接 CLI:克隆仓库,安装依赖,安装 Playwright 浏览器二进制文件,并全局链接 kusho 命令。
    • 页面示例命令:
      • git clone https://github.com/kusho-co/kusho-ui-testing-tui.git
      • cd kusho-ui-testing-tui
      • npm install
      • npx playwright install
      • npm link
      • 验证:kusho --help
  2. 设置 LLM 提供商凭据:运行 kusho credentials,选择提供商(OpenAI、Anthropic 或 Google Gemini),粘贴 API 密钥。凭据本地存储于 ~/.kusho-credentials
  3. 录制用户流程:运行 kusho record 并提供目标 URL(或省略 URL 交互输入)。浏览器中完成操作后关闭;生成的 Playwright 脚本将在终端编辑器中打开。
    • 脚本保存至 kusho-tests/recordings/
  4. 生成测试套件:使用 kusho extend(或 TUI 的 “Extend” / “Kusho Edit”)将录制发送至选定 LLM,生成带额外变体的扩展套件。
  5. 运行测试套件:无头或有头运行扩展测试,支持可选视频录制和详细 HTML 报告。

如果偏好引导式体验,使用 kusho ui 启动交互菜单,通过箭头键导航完成凭据设置、录制、测试生成和运行。

使用场景

  • 覆盖不止快乐路径:当前仅测试主用户流程的团队,可用一次录制生成额外场景,包括边界情况和错误状态。
  • QA 边界条件工作流程:QA 工程师从真实交互(表单输入、导航、提交)开始,然后扩展以测试边界条件和负面案例。
  • 调试原始捕获流程:使用 “Run recording” 选项执行原始录制派生的测试,验证捕获内容后再依赖 AI 生成的扩展。
  • 迭代优化覆盖:开发者可扩展初始套件,然后使用 “Kusho Edit” 根据纯英文指令调整套件覆盖内容。
  • 跨团队标准化 UI 测试生成:终端导向循环(录制 → 审查 → 扩展 → 运行)可为 Web 应用生成 Playwright 测试提供可重复工作流程。

常见问题

KushoAI UI Testing TUI 生成什么?
它基于捕获的 UI 流程生成 Playwright 测试套件,包括额外变体、边界情况和错误场景。

需要从零编写 Playwright 代码吗?
不需要。您使用 Playwright 的浏览器录制器录制流程,然后在终端编辑器中审查和编辑生成的脚本。

支持哪些 LLM 提供商?
页面列出 OpenAI、Anthropic 和 Google Gemini 为支持提供商。设置时也可覆盖默认模型。

API 密钥存储在哪里?
工具将凭据本地保存至 ~/.kusho-credentials,调用选定提供商时使用。

可以在浏览器窗口运行测试吗?
可以。页面指出可无头或可见浏览器(“headed mode”)运行测试套件,还支持可选视频录制。

替代方案

  • 手动编写 Playwright 测试:直接在 Playwright 中编写测试可提供完全控制,但需要手动转换每个点击/输入并添加边界情况测试。
  • 基于脚本交互的组件/UI 测试框架:从脚本或开发者编写的场景生成测试的框架,仍需编写这些场景,而不是从交互式浏览器录制开始。
  • 专注于录制与回放的自动化工具(非 Playwright 优先):录制与回放方法可快速捕获用户操作,但工作流程可能并非针对生成 Playwright 测试套件,并需额外转换步骤。
  • AI 辅助测试代码生成:通用 AI 编码工具可帮助编写或扩展测试,但通常不提供围绕 Playwright 录制和从单一 UI 流程扩展的终端优先循环。