artemis/
├── agents/ # AI Agent 集合（需要 LLM）
│ ├── flash/ # Flash 反应式循环 Agent
│ ├── planner/ # Pro - 任务规划器
│ ├── operator/ # Pro - 设备操作执行器
│ ├── checker/ # Pro - 结果验证器
│ ├── outputter/ # Pro - 报告生成器
│ ├── explorer/ # 元素感知/定位 Agent（flash/pro/ultra 三档）
│ ├── validator/ # 操作前安全检查
│ ├── diagnoser/ # 错误诊断 Agent
│ ├── summarizer/ # 历史压缩/总结
│ ├── video_analyzer/ # 录屏分析
│ ├── history_analyzer/# 历史步骤分析
│ ├── log_analyzer/ # Logcat 日志分析
│ ├── image_processor/ # 图像处理
│ └── object_detector/ # 目标检测
│
├── tools/ # Agent 可调用的工具
│ ├── mobile/ # 移动设备交互工具
│ ├── system/ # 系统级工具
│ ├── history/ # 历史回看工具
│ ├── explorer_tool # 元素定位深度探索
│ ├── command_tool # ADB 命令执行
│ ├── video_tool # 录屏/视频分析
│ ├── log_tool # 日志获取
│ ├── wait_tool # 等待/延时
│ ├── scratchpad # Agent 笔记本
│ └── committee_tool # 多 Agent 投票决策
│
├── drivers/ # 设备驱动
│ ├── android/ # Android 设备驱动
│ ├── cloud/ # 云端设备
│ └── mock/ # 模拟设备（测试用）
│
├── packages/ # 配套包
│ ├── artemis-accessibility-helper/ # 安装到 Android 设备的 APK
│ │ ├── ArtemisAccessibilityService.java # AccessibilityService 核心
│ │ ├── HierarchyDumper.java # UI 树 dump（比 UIAutomator 快+稳）
│ │ ├── GestureController.java # 手势执行（通过 AccessibilityService）
│ │ ├── CommandServer.java # 接收 PC 端命令的 HTTP 服务
│ │ ├── DisplayUtils.java # 屏幕信息获取
│ │ └── A11yNode.java # UI 节点数据模型
│ └── artemis-client/ # Python SDK 客户端
│
├── mcp_server/ # MCP 协议层（IDE 集成入口）
│ └── tools/
│ ├── device_state.py # screenshot + hierarchy
│ ├── task_runner.py # 启动任务
│ ├── task_manager.py # 管理任务
│ ├── inspect_trace.py # 查看执行轨迹
│ └── diagnose.py # 环境诊断
│
├── utils/ # 工具集
│ ├── coordinates.py # 坐标归一化 (0-1000) ← 今天的关键发现
│ ├── ocr_api.py # OCR 文字识别（补充 accessibility 遗漏）
│ ├── ocr_xml_fusion.py# OCR + XML 层级融合
│ ├── video.py # 视频录制/处理
│ ├── image_diff.py # 画面变化检测
│ └── visualization.py # 边界框绘制 + 元素列表格式化
│
├── memory/ # Agent 记忆管理
│ ├── chunking.py # 历史压缩分块
│ ├── transcript.py # 会话记录
│ ├── step_memory.py # 步骤记忆
│ └── context_policy.py# 上下文管理策略
│
├── graph/ # LangGraph 状态机（Pro 模式）
│ ├── graph.py # 图执行引擎
│ ├── state.py # 状态定义
│ ├── perception.py # 感知节点
│ ├── checkpoints.py # 检查点管理
│ └── visibility.py # 节点可见性控制
│
├── runtime/ # 运行时基础设施
│ ├── daemon_client.py # 后台守护进程
│ ├── device_pool.py # 多设备管理池
│ ├── device_lock.py # 设备互斥锁
│ ├── helper_manager.py# Helper APK 管理
│ └── supervisor.py # 任务监控
│
├── data_engine/ # 数据持久化
│ ├── engine.py # 数据引擎
│ ├── storage.py # 存储层
│ └── trace.py # 执行轨迹存储
│
├── llm/ # LLM 接口层
│ ├── router.py # 模型路由（Gemini/Claude/GPT/Qwen）
│ ├── structured.py # 结构化输出
│ ├── reliability.py # 可靠性/重试
│ └── parser.py # 输出解析
│
└── telemetry/ # 遥测
├── tracer.py # 追踪器
├── replay.py # 回放
└── models.py # 数据模型