自愈式 QA 智能体vostride/agent-qa

npm
npm version
GitHub stars

文档
·
演示
·
问题反馈

agent-qa
具备记忆能力的自我改进型智能体 QA 测试框架

用自然语言为 Web 和移动端编写测试。agent-qa 从过往运行中学习，适应 UI 变化，并在你发布前捕获回归问题。

文档 | 快速开始

功能特性

- 用自然语言为 Web 和移动端编写测试：用人类语言定义操作和断言，智能体则根据可见的角色、标签和屏幕状态开展工作。
- 自愈式测试执行：当任何子操作（如点击、填写或选择）失败时，agent-qa 会重新观察 UI，并在同一次运行中尝试不同的路径。测试能够从 UI 漂移和不稳定的交互中恢复，而不是在第一个失败的操作上就报错。
- 通过记忆实现自我改进：每次测试运行，agent-qa 都会从产品、测试套件和测试观察中构建执行记忆，然后将这些上下文添加到未来的运行中。agent-qa 还会从执行期间被修复的步骤中整理记忆，帮助未来的运行避免同样的错误。
- 为人类和机器而构建：为开发者提供精致的仪表盘和 CLI，同时为编码智能体提供 MCP 和技能。
- 通过智能缓存加速运行：操作缓存会在后续类似的测试运行中复用已验证的计划，减少规划器工作量、token 使用量和运行时开销。
- 在测试期间运行沙箱化钩子：在隔离的 Docker 容器中运行 Node、Bun、Python 或 Bash 钩子，以搭建环境、调用 API、填充测试数据、清理状态，或将结构化输出传回当前测试运行。
- 开源、可审查的 QA：该测试框架是开源的，测试、配置、钩子、记忆和套件逻辑都以版本控制的代码形式存在，因此每一次变更都可以进行差异对比、审查、复用，并在团队之间共享。
- 自带 LLM：通过 OpenAI 和 Anthropic 兼容端点、Gemini、本地或开源模型，以及 Codex 和 Claude Code 等订阅服务，使用你选择的模型运行测试。

快速开始

安装该包：

npm install -D agent-qa

对于 Codex 或 Claude Code 订阅认证，还需安装：

sh
npm install -D @vostride/agent-qa-subscription-auth

使用钩子前请先安装 Docker。agent-qa 在沙箱化运行时中执行钩子，Node、Bun、Python 和 Bash 钩子容器都需要 Docker。

初始化 agent-qa 并安装你需要的运行时支持：
sh
npx agent-qa init
npx agent-qa install-browsers --chromium
移动端项目：
npx agent-qa install-mobile-drivers --all

启动仪表盘，完成认证，并从 UI 运行测试：
sh
npx agent-qa dashboard --open

完整的设置流程，请参阅快速入门。

CLI

从 CLI 运行测试：
sh
npx agent-qa run tests/hacker-news-top-story.yaml

文档

- 完整文档
- 快速入门
- CLI 参考
- 仪表盘
- 配置
- 许可证
- 声明