ClaudeMap

mobile-agent-testers

Claude Code 插件:在免费 GitHub runner 上让 20 个 AI 测试员并行上 20 部手机——每个 persona 一个 Claude Code agent,跑在 iOS 模拟器与 Android 模拟器上,像新用户一样使用你的应用并写出带截图的 bug 报告

插件与代理claude code pluginmobile testingiosandroidgithub actionsqa

把模板 fork 成你自己的仓库(gh repo create --template),跑一次 setup.sh(密钥对、secrets 与 Claude token),然后触发 agent-testers.yml:一个 workflow 先构建应用,再按 persona 各起一台模拟器/仿真器,由 Claude Code agent 驱动——每个 agent 只拿三个工具:看屏幕(带点按坐标)、手势、打字。persona 决定设备:机型、OS、字号、深色模式、语言与位置。报告与录屏在进入日志前用你的密钥加密,模拟器内屏蔽分析类域名,测试永不污染你的真实统计。agent 从截图与无障碍树读屏,任何 UI 工具包都能用——带标签的控件(Flutter Semantics、Android contentDescription、accessibilityLabel)能换来更准的点按目标。框架自动识别:Flutter、React Native/Expo、原生 Kotlin/Java 与 Swift/Objective-C、Kotlin Multiplatform、Capacitor/Ionic、.NET MAUI(beta),或经 android_build/ios_build 输入接你自己的构建命令。README 自报的演示运行:演示应用埋了 11 个故意 bug,4 个测试员找到其中 9 个(每人 2-7 分钟,整轮约 21 分钟、含构建),还顺带发现了没埋的真实问题,4 个 agent 的模型用量为 $0.87。

它做什么

  • 免费 GitHub runner 上的 20 个并行测试员——按 GitHub 公开仓限制约 20 个并行作业,其中 macOS 5 个
  • persona 驱动测试:每个 persona 固定机型、OS、字号、深色模式、语言与位置;按平台指定 persona
  • 每 agent 三个工具(带点按坐标的屏幕、手势、打字),读屏走截图 + 无障碍树,任何 UI 工具包都可测
  • 报告与录屏加密(公开仓的日志人人可读),collect.sh 把一轮结果解密成 runs/<id>/SUMMARY.md
  • 模拟器内屏蔽分析类域名;block_hosts 输入可在测试期间追加屏蔽
  • 框架识别面广:Flutter、React Native/Expo、原生 Kotlin/Swift、KMP、Capacitor/Ionic、.NET MAUI(beta)或自定义构建命令

什么时候用

适合发布移动应用前想要一轮便宜、可重复的冒烟测试:基于 persona 的并行探索式测试跑在真实模拟器/仿真器构建上,bug 报告带截图落在你的仓库里,不新增测试基础设施账单——代价是 agent 回合产生的 Claude 用量。

如何上手

模板流程(README 快速开始):

gh repo create my-testers --public --template pierridotite/mobile-agent-testers --clone
cd my-testers && ./setup.sh           # key pair + secrets + Claude token (Windows: .\setup.ps1)
gh workflow run agent-testers.yml     # demo: 2 Android + 2 iOS testers, ~20 min
bash scripts/collect.sh <run id>      # decrypts reports into runs/<id>/SUMMARY.md

或作为 Claude Code 插件使用:

/plugin marketplace add pierridotite/mobile-agent-testers
/plugin install mobile-agent-testers@mobile-agent-testers

测你自己的应用:gh workflow run agent-testers.yml -f source_repo=you/app -f app_id=com.you.app -f android_personas=anna,malik -f ios_personas=clara,jonas

注意事项

「免费」的账是 README 明说的,不是暗示:GitHub 托管 runner 对公开仓免费、约 20 个并行作业、macOS 仅 5 个;20 个 agent 可在约 15 分钟里烧完一个 Claude 订阅的 5 小时窗口(README 建议按 6-10 个一批跑);托管 runner 本意是给仓库自身项目用的——闭源应用请把 workflow 放进你的私有仓或自己的 Mac 上跑(私有仓拉取你的应用需要只读的 SOURCE_REPO_TOKEN secret)。结果加密正是因为公开仓的日志人人可读。模型花费随测试员数量增长:演示的 $0.87 覆盖 4 个 agent、找到 11 个埋入 bug 中的 9 个。iOS 跑在 macOS runner 的 arm64 Xcode 构建(并发 5)。MIT 许可。撰稿时 29 星(2026-11-18)。

代码仓库

pierridotite/mobile-agent-testers

收录日期

地图上的相关资源

  • clawd-conduit

    插件 / 代理

    把全部 15 个 Claude Code hook 事件接进 Clawd on Desk 桌面宠物,权限请求变成可等待的桌面卡片。

    • hooks
    • desktop
    • notifications
    • claude-code
  • CometixCode

    插件 / 代理

    非官方的 Claude Code 终端 UI 复刻:用 Rust 按 1:1 逐文件移植到 iocraft 这套 React 风格 TUI 框架上。

    • terminal-ui
    • rust
    • reimplementation
    • unofficial
  • Abide

    插件 / 代理

    把 AGENTS.md、CLAUDE.md 里的自然语言规则变成钩子级强制:每次编辑都被评审,违规当场修复。

    • hooks
    • code-review
    • rules
    • agents-md