PkgFoundry
Catalog PyPI
Back to packageRELEASE DETAILS

0.5.2

PyPI

agent-for-webui-test

自主Web UI测试Agent — 告诉Agent测试哪个系统，Agent自主完成探索、用例生成、执行、判定

Published7 May 2026
Direct dependencies4
Transitive dependenciesNot calculated

README

Version 0.5.2 documentation

AgentForWebUITest

告诉 Agent 测试哪个系统，Agent 自主完成全流程 Web UI 测试

[Python] [Tests] [Version]

⚡ 5 秒安装

pip install agent-for-webui-test && webui-test check

🎯 一句话描述

AI 自主 Web UI 测试 Agent — 从页面探索、用例生成、执行判定到报告输出，全流程无人值守。

🧭 快速了解

🔍 自主探索🧪 智能用例⚡ ReAct执行🏗️ TestSuite
BFS递归爬取页面5类用例自动生成自愈选择器过滤+依赖编排
API拦截+知识图谱P0-P3优先级失败重试8个预置模板

🏗️ 架构总览

用户指令 → Strategy → Explorer → Planner → SuiteRunner → 报告
                          │          │           │
                    KnowledgeGraph  [TestCase]  SuiteResult
                          │          │           │
                    ┌──────┴──────────┴───────────┴──────┐
                    │        BrowserInterface             │
                    │  AgentBrowser │ PlaywrightBrowser   │
                    │  (Chrome 147)  │ (Chromium|FF|WK)   │
                    └─────────────────────────────────────┘

🚀 快速上手

# 1. 安装
pip install agent-for-webui-test

# 2. 自检
webui-test check

# 3. 冒烟测试
webui-test suite https://httpbin.org --preset smoke

# 4. CI 模式
webui-test suite https://example.com --ci --filter "P0+P1"

# Python API
from src.agent import WebUITestAgent

agent = WebUITestAgent()
result = agent.run_with_suite("测试 https://example.com", preset="smoke")
print(f"通过率: {result['suite_summary']['pass_rate']}%")

📊 项目状态

迭代内容状态
迭代1自主探索 + 知识图谱✅
迭代2智能用例生成 (5类)✅
迭代3ReAct执行 + 自愈选择器✅
迭代4智能判定 + 根因分析✅
迭代5TestSuite + CI集成 + 多浏览器✅
模块文件行数
核心引擎9~4,800
TestSuite6~750
浏览器驱动4~750
工具5~1,500
测试 (9用例)6~600
合计29~8,500

📚 文档

文档说明
快速上手5分钟从零到使用
安装指南pip + Docker 多路径
架构文档架构详解
配置参考完整参数说明
日志调试日志与调试
发版清单发布检查

🔧 CLI 命令

webui-test check                              # 环境自检
webui-test test <url>                         # 完整测试
webui-test explore <url>                      # 仅探索
webui-test suite <url>                        # TestSuite 编排
webui-test suite <url> --preset smoke         # 冒烟测试
webui-test suite <url> --filter "P0+form"     # 过滤执行
webui-test suite <url> --ci                   # CI模式
webui-test version                            # 版本信息

🧪 测试

pytest tests/ -v    # 9 passed
make test           # 等效

版本历史

版本日期变更
v0.5.02026-05-07TestSuite + CI + 多浏览器 + 文档完善
v0.4.02026-05-07工程化: pip/CLI/CI/Makefile
v0.3.02026-04-28迭代1-4: 探索/用例/执行/判定
v0.2.02026-04-26迭代1-2: 探索 + 用例生成
v0.1.02026-04-26项目初始化

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 4

Native requirements
4 direct targetsNot calculated transitive count
Package / targetRequirementRelationship
pyyaml
Environment
{
  "extras": "",
  "marker": null,
  "requires_python": ">=3.9",
  "evaluation": "NOT_EVALUATED"
}
pyyaml>=6.0runtime
pytest
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.9",
  "evaluation": "NOT_EVALUATED"
}
pytest>=7.0; extra == "dev"runtime
pytest-cov
Environment
{
  "extras": "",
  "marker": "extra == \"dev\"",
  "requires_python": ">=3.9",
  "evaluation": "NOT_EVALUATED"
}
pytest-cov; extra == "dev"runtime
playwright
Environment
{
  "extras": "",
  "marker": "extra == \"playwright\"",
  "requires_python": ">=3.9",
  "evaluation": "NOT_EVALUATED"
}
playwright>=1.40; extra == "playwright"runtime

Distribution files

2 collected
agent_for_webui_test-0.5.2-py3-none-any.whl

bdist_wheel · 95.07 KB · Python py3

Source file
agent_for_webui_test-0.5.2.tar.gz

sdist · 99.92 KB · Python source

Source file

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 21:58 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:58736fc21c8591c5437c6d316c1942cc3305a200abdcb9e118810397ce7e49af

Other collected versions

View all collected versions →