Repository navigation
给 Maestro 做了个开源 MCP 增强层:多设备并行、断言、失败自动归因 #3596
Fwmouomu
started this conversation in
Show and tell
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
用 Maestro 做移动端 UI 自动化测试的应该不少。它的官方 MCP server 能让 AI Agent 读屏、点击、跑 flow,但用下来有个明显感受:它刻意只做到"能操作"这一步 —— 单设备、原子操作,对结果对不对没有态度。
跑一整套回归时,三个问题特别疼:
所以我写了个开源项目 maestro-plus,定位很克制:官方 MCP 的增强层,一个官方工具都不重复实现(仓库里有条测试强制这一点,谁忘了构建直接红)。
补了什么
run_parallelrun_and_assertdebug_failureassert_visualexplore_and_recordlist_device_pool/health_checkdebug_failure的归因规则举一个例子:logcat 有FATAL EXCEPTION→ 应用缺陷,高置信;焦点被系统权限弹窗抢走 → 测试缺陷(flow 没处理弹窗),高置信;失败步骤引用的元素在层级里存在但 disabled → 应用缺陷,中置信;元素完全不存在 → 诚实地给 unknown + 低置信,因为一次失败确实分不清"界面没渲染出来"和"选择器过期"。我认为诊断工具宁可说"不知道",也不能把 bug 送错团队。
设计上守两条线
debug_failure这种脏活官方不会做用法
{ "mcpServers": { "maestro-plus": { "command": "npx", "args": ["-y", "maestro-plus"] } } }前置要求就是 Maestro CLI + adb,Python 3.10+。CI(3.10/3.12 双版本 lint + test)是绿的。
GitHub:https://github.com/Fwmouomu/maestro-plus
设计决策的完整论证(逐条对着官方文档核对过的能力缺口)在 docs/why.md,已知坑也在 docs/limitations.md 里摊开了 —— 包括"没有无障碍树就没有诊断"和"真实失败里 unknown 会比你希望的多"。
Android 先行,iOS(simctl)在 roadmap。欢迎来提 issue,特别是真实失败样本 —— 归因规则需要真实 case 校准,我拿自己那套 JusCall 测试套件在喂它。
All reactions