Metadata-Version: 2.4
Name: mat-uitest
Version: 0.7.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://mobileaitest.com/manual.html
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
Requires-Dist: openpyxl>=3.1
Requires-Dist: cryptography>=42
Provides-Extra: dev
Requires-Dist: ruff==0.16.9; extra == "dev"
Requires-Dist: pytest>=8; extra == "dev"
Requires-Dist: pytest-cov>=5; extra == "dev"
Provides-Extra: image
Requires-Dist: opencv-python-headless>=4.8; extra == "image"
Provides-Extra: mcp
Requires-Dist: mcp>=2.0; extra == "mcp"
Provides-Extra: ios
Requires-Dist: facebook-wda>=1.5; extra == "ios"
Requires-Dist: pymobiledevice3>=3.0; extra == "ios"
Provides-Extra: maestro
Requires-Dist: pyyaml>=6; extra == "maestro"
Dynamic: license-file

# MAT Engine

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

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

```bash
# Windows
py -m pip install --user mat-uitest
# macOS / Linux（推荐：uv 自动解决 Python 3.11+，不需要预装；已有 uv 跳过第一行）
curl -LsSf https://astral.sh/uv/install.sh | sh
uv tool install mat-uitest && uv tool update-shell   # 最后一步把 ~/.local/bin 加进 PATH，重开终端生效
# 已装 pipx（等价备选）：pipx install mat-uitest && pipx ensurepath

mat doctor   # 环境自检（首次启动控制台会自动建好工作区与示例用例）
```

文档：https://mobileaitest.com/manual.html
