SuperAPI AI 工具集

validate-ui

测试与质量

查看项目

更新于 10-15 15:39

技能介绍

用途

validate-ui 用于对 Archon Web UI 进行全面的端到端验证。它结合浏览器自动化测试与代码库审查,目标是判断 Archon 在管理并行智能体、执行自定义工作流以及提供智能体工作完整可见性方面,是否做到了尽可能好。

该技能支持一个可选的重点参数($ARGUMENTS),例如 "workflows"、"chat"、"projects"。若参数为空,则运行全部测试部分。

主要能力

验证覆盖以下测试套件:

  • 仪表盘(路由 /):初始加载、统计卡片准确性、最近会话与工作流运行列表、空状态与新建聊天入口。
  • 项目管理:通过 GitHub URL 或本地路径添加项目、去重、选择/取消选择、删除项目、折叠面板中的项目选择器。
  • 聊天界面:新建聊天(无项目/有项目)、斜杠命令(/status、/help、/commands、/getcwd)、消息渲染(代码块、表格、链接、引用、行内代码)、流式与实时更新、工具调用卡片、错误处理、队列位置、自动滚动行为、会话导航。
  • 会话管理:重命名、删除、自动标题、搜索。
  • 工作流管理:工作流列表页、从工作流页或侧边栏调用工作流、工作流路由器(智能体编排器)、聊天中的工作流进度、工作流执行页、并行智能体步骤、循环迭代、工作流产物、陈旧检测、取消工作流。
  • 项目范围视图:项目详情中的会话与工作流运行、跨项目导航。
  • SSE 与实时基础设施:SSE 连接、重连、多标签页行为。
  • UI/UX 质量审计:视觉层级与深色主题、交互状态、颜色一致性、边框与分隔线。

使用方式

技能按阶段执行:

Phase 0:环境准备

  • 终止旧的 Archon 进程(后端与前端),释放端口 3090 和 5173。
  • 安装 agent-browser(如未安装)。注意:不要使用 bunx,因为 Bun 会跳过 agent-browser 所需的 postinstall 脚本;应使用 npx 或全局 npm 安装。在 WSL2/Linux 上使用 agent-browser install --with-deps 获取 Chromium 系统依赖。
  • 启动后端(端口 3090)和前端(端口 5173),并验证健康状态。
  • 如需要,准备测试数据(注册代码库、创建测试会话)。

相关 URL:

  • 前端:http://localhost:5173
  • 后端 API:http://localhost:3090/api
  • SSE 流:http://localhost:3090/api/stream/{conversationId}(开发环境绕过 Vite 代理)

Phase 1:浏览器自动化端到端测试 使用 agent-browser CLI 进行所有浏览器交互,遵循 snapshot-refs 工作流:

  • agent-browser open <url> 导航
  • agent-browser snapshot -i 获取带 ref 的交互元素
  • 使用 ref 进行点击、填写等操作
  • 导航或 DOM 变化后重新 snapshot
  • 在每个主要测试点截图:agent-browser screenshot /tmp/archon-test-{name}.png

适用场景

  • 需要验证、测试或审计 Archon Web UI 时。
  • 需要确认仪表盘统计、会话管理、工作流执行、实时流式更新等前端功能是否正常。
  • 需要评估 UI/UX 质量与视觉一致性。
  • 需要检查 SSE 连接、重连与多标签页行为。

限制

  • 该技能依赖本地运行 Archon 前后端服务,需要相应环境与端口可用。
  • 浏览器自动化依赖 agent-browser,且不能通过 bunx 安装。
  • 部分测试(如队列位置、取消工作流)在条件不满足时可能无法执行,需记录为 UX 缺口。
  • 多标签页场景下,Web 适配器在新连接时会替换旧流,因此只有最新标签页能获得实时 SSE。
  • 资料未提供该技能的收费、价格、平台支持范围等额外信息。