Metadata-Version: 2.4
Name: mat-uitest
Version: 0.6.0
Summary: MAT — AI 移动端 App UI 自动化测试（引擎与 CLI，开源核心 AGPL-3.0）
Author: vlmpilot
License-Expression: AGPL-3.0-or-later
Project-URL: Homepage, https://github.com/vlmpilot/mat-uitest
Project-URL: Repository, https://github.com/vlmpilot/mat-uitest
Project-URL: Documentation, https://github.com/vlmpilot/mat-uitest/tree/main/docs
Project-URL: Changelog, https://github.com/vlmpilot/mat-uitest/blob/main/CHANGELOG.md
Project-URL: Issues, https://github.com/vlmpilot/mat-uitest/issues
Keywords: ui-testing,mobile-testing,android,ios,automation,test-automation,ui-automation,regression-testing,e2e,uiautomator2,adb,appium,maestro,ai-testing,llm,mcp
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: Software Development :: Testing :: Acceptance
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: uiautomator2>=3.0
Requires-Dist: pydantic>=2.7
Requires-Dist: requests>=2.31
Requires-Dist: pillow>=10
Provides-Extra: dev
Requires-Dist: ruff==0.16.9; extra == "dev"
Requires-Dist: pytest>=8; extra == "dev"
Requires-Dist: pytest-cov>=5; extra == "dev"
Requires-Dist: openpyxl>=3.1; extra == "dev"
Provides-Extra: image
Requires-Dist: opencv-python-headless>=4.8; extra == "image"
Provides-Extra: import
Requires-Dist: openpyxl>=3.1; extra == "import"
Provides-Extra: mcp
Requires-Dist: mcp>=2.0; extra == "mcp"
Provides-Extra: ios
Requires-Dist: facebook-wda>=1.5; extra == "ios"
Dynamic: license-file

# MAT Engine

AI 移动端 App UI 自动化测试工具——执行引擎与 CLI（命令 `mat`）。

- 自然语言一句话生成用例，真机 dry-run 校准
- 混合驱动定位链：控件层 → 图像模板 → 视觉大模型兜底，失败自动自愈
- 每步强制截图证据，失败五分类归因（崩溃 / 断言失败 / 定位失败 / 环境问题 / 待归因）
- 探索测试：预算制自主遍历，页面层级（L0-Ln）与页面图谱沉淀，发现附复现路径
- 本地执行免费不限量，数据不出本机

```bash
pipx install mat-uitest
mat doctor   # 环境自检
mat init     # 初始化工作区
```

文档：https://github.com/vlmpilot/mat-uitest/tree/main/docs （含产品使用手册 docs/13）
