这个项目能做什么

Mercury Device Farm 是一个基于浏览器的真机实验室，允许用户通过单一 Web 工作区管理 Android、iOS 和 Tizen 设备。由于 iOS 自动化需要在主机上使用 Xcode 工具，该项目针对 macOS 进行了优化。它将基于 Docker 的后端、编译后的 Web UI 以及主机端 iOS provider 打包进单个 GHCR 镜像中。使用提供的安装脚本安装 macOS launcher 后，用户可以通过 `~/.mercury‑farm/mercury up` 启动服务。对于 iOS 设备，需要在 Xcode 中进行一次性的 WebDriverAgent 签名步骤，之后 provider 会自动在配对的 iPhone 或 iPad 上安装并更新 agent。用户可以通过动态域名 (MERCURY_DOMAIN) 访问 UI，其中包含设备列表、远程控制、设置和日志记录等页面。模拟身份验证系统提供了一个初始管理员账号。该工具支持在保留配置和 MongoDB 数据的情况下更新到新版本，并可以回滚到特定版本。文档涵盖了硬件建议（Mac mini 型号、带电源的 USB hub、网络设置）、设备准备、屏幕流技术（Android 使用 Minicap/Scrcpy，iOS 使用 WebDriverAgent MJPEG）、带宽调节、并行执行、Appium 集成、自动化 API、架构以及故障排除。后端和 CLI 采用 Apache-2.0 许可；Web UI 是一个不公开的专有私有子模块。