README

让 AI 助手与测试套件像人一样直接操作真机。



  English •
  中文文档 •
  全流程演示 •
  快速上手 •
  MCP 接入 IDE •
  基准评测 •
  Discord 社区



  
  
  
  
  




  
  
  实机演示：在 Google Maps 中设置驾车路线并计算总耗时，随后打开 YouTube 播放 Coldplay 的歌曲。


 核心亮点

 跨 App 自动化：根据自然语言指令，在 Android 上执行测试流程和日常任务。
 多模态定位：优先使用元素索引，对自绘界面提供坐标和视觉定位兜底。
 IDE 内诊断：通过 MCP 协议，让 Antigravity、Claude Code、Windsurf 操作测试设备，收集 Logcat 输出和截图。
 Flash 执行：使用观察、执行循环和异步历史摘要，单步通常约 3–5 秒。
 Pro 探索：单个动作执行前校验目标，被拦截的动作交回 Operator 处理。支持长时间探索和稳定性测试。
 AndroidWorld 结果：在 Google Research AndroidWorld 基准评测（100+ 多步任务）中取得 99%+ 任务完成率。



 Antigravity × ARTEMIS：全流程自主测试演示

Antigravity 通过 MCP 调用 ARTEMIS，将测试需求转为计划、真机操作和诊断报告：


  
    
      1. 输入测试提示词 (Task Dispatch)
      在 Antigravity 中用自然语言描述测试需求与目标指标
      
    
    
      2. 生成测试方案 (Test Plan Generation)
      自动拆解任务，生成详细测试步骤与架构图供确认
      
    
  
  
    
      3. 自主执行测试 (Autonomous Test Execution)
      驱动真机操作、界面导航并实时分析性能指标
      
    
    
      4. 交付最终报告 (Comprehensive Final Report)
      生成结构化测试报告，交付性能图表、结论与原始数据
      
    
  




 快速上手

确保电脑已连接 Android 实体机（已开启 USB 调试）或 Android 模拟器。一键启动脚本将会自动完成以下配置：
- 安装系统环境依赖：自动检测并安装 ADB、scrcpy、FFmpeg 与 Python（uv）运行时及项目依赖。
- 全局挂载 MCP 服务与测试准则 (Rules)：主动引导并自动将全局 MCP 服务与 Artemis 移动端测试思维准则 (rules.md) 挂载至你使用的 AI IDE（支持 Antigravity、Cursor、Claude Code、Codex、Windsurf、VS Code、Cline/Roo、OpenClaw）。

 macOS 与 Linux

bash
 1. 克隆代码仓库并进入目录
git clone https://github.com/google/artemis.git && cd artemis

 2. 一键启动
./start.sh


 Windows PowerShell

powershell
 1. 克隆代码仓库并进入目录
git clone https://github.com/google/artemis.git
cd artemis

 2. 一键启动
.\start.bat


 PowerShell 默认不会从当前目录查找可执行脚本，因此必须使用 .\start.bat，且命令末尾不要添加 \。如果使用传统命令提示符（CMD），则运行 start.bat。

 提示：启动后将自动在默认浏览器中打开 Web 控制台（http://localhost:8000），提供设备连接向导、实时投屏、任务演练与状态回放面板。你也可以通过命令行直接运行：uv run artemis run "打开系统设置，找到电池选项并告诉我当前电量" --profile flash。




Codex / Antigravity / Claude Code / Windsurf MCP 配置（点击展开）



ARTEMIS 内置原生 Model Context Protocol (MCP) 服务。只需将以下配置加入你的 IDE 配置文件中，即可在编写代码时直接驱动真机：

 1. 一键自动安装到 IDE（推荐）

运行 ./start.sh（macOS/Linux）或 .\start.bat（Windows PowerShell）启动脚本时，会主动询问是否自动挂载全局 MCP 与测试行为准则（支持跳过并在之后随时手动执行以下命令挂载）：

bash
 一键安装全局 MCP 服务与 Rules 到 Antigravity / Jetski：
uv run artemis mcp --install antigravity

 或一键安装到所有支持的 AI IDE（包括 Codex）：
uv run artemis mcp --install all


 提示：你也可以在首次运行 uv run artemis init 配置向导时，交互式完成 IDE 的 MCP 自动挂载。
 进阶提示：如果希望在任意目录下都不需要加 uv run 就能全局直接使用 artemis 命令，可在项目根目录下执行一次 uv tool install -e .。

 2. 手动配置（可选）

如果你习惯手动复制配置，可运行 uv run artemis mcp --generate-config （例如 codex 或 antigravity）获取对应的 TOML 或 JSON 配置。请将 command 填写为项目下 .venv 虚拟环境中的 Python 绝对路径，并将 /path/to/artemis 替换为项目实际路径：

 Codex (~/.codex/config.toml)：
toml
[mcp_servers.artemis]
command = "/path/to/artemis/.venv/bin/python"
args = ["-m", "mcp_server"]
cwd = "/path/to/artemis"

[mcp_servers.artemis.env]
PYTHONUNBUFFERED = "1"
PYTHONPATH = "/path/to/artemis"


 Antigravity (~/.gemini/jetski/mcp_config.json)：
json
{
  "mcpServers": {
    "artemis": {
      "command": "/path/to/artemis/.venv/bin/python",
      "args": ["-m", "mcp_server"],
      "c

Top issues

Discussions