mobile-mcp-ai 2.1.2__py3-none-any.whl → 2.5.8__py3-none-any.whl

core/ios_client.py

@@ -1,219 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-iOS客户端 - 类似Android的MobileClient
-
-功能：
-1. 设备连接管理
-2. 页面结构获取（snapshot）
-3. 元素操作（click, type, swipe等）
-4. App管理（launch, stop等）
-
-用法:
-    client = IOSClient(device_id=None)
-    await client.launch_app("com.example.app")
-    await client.click("登录按钮")
-"""
-import asyncio
-from typing import Dict, Optional, List
-
-from .ios_device_manager import IOSDeviceManager
-
-
-class IOSClient:
-    """
-    iOS客户端 - 类似Android的MobileClient
-    
-    用法:
-        client = IOSClient(device_id=None)
-        await client.launch_app("com.example.app")
-        await client.click("登录按钮")
-    """
-    
-    def __init__(self, device_id: Optional[str] = None):
-        """
-        初始化iOS客户端
-        
-        Args:
-            device_id: 设备ID，None则自动选择第一个设备
-        """
-        self.device_manager = IOSDeviceManager()
-        self.driver = self.device_manager.connect(device_id)
-        
-        # 操作历史（用于录制）
-        self.operation_history: List[Dict] = []
-    
-    async def snapshot(self) -> str:
-        """
-        获取页面XML结构（类似Android的snapshot）
-        
-        Returns:
-            格式化后的页面结构字符串
-        """
-        try:
-            # 获取页面源码
-            source = self.driver.page_source
-            
-            # 简单的格式化（可以后续优化）
-            return source
-        except Exception as e:
-            raise RuntimeError(f"获取页面结构失败: {e}")
-    
-    async def click(self, element_desc: str, ref: Optional[str] = None):
-        """
-        点击元素
-        
-        Args:
-            element_desc: 元素描述（自然语言）
-            ref: 元素定位器（XPath、accessibility_id等）
-            
-        Returns:
-            操作结果
-        """
-        try:
-            from selenium.webdriver.common.by import By
-            
-            # 如果提供了ref，直接使用
-            if ref:
-                if ref.startswith('//') or ref.startswith('/'):
-                    # XPath
-                    element = self.driver.find_element(By.XPATH, ref)
-                elif ref.startswith('id='):
-                    # accessibility_id
-                    element = self.driver.find_element(By.ID, ref.replace('id=', ''))
-                else:
-                    # 默认作为accessibility_id
-                    element = self.driver.find_element(By.ID, ref)
-            else:
-                # 尝试多种定位方式
-                selectors = [
-                    (By.XPATH, f"//*[@name='{element_desc}']"),
-                    (By.XPATH, f"//*[@label='{element_desc}']"),
-                    (By.XPATH, f"//*[contains(@name, '{element_desc}')]"),
-                ]
-                
-                element = None
-                for by, selector in selectors:
-                    try:
-                        element = self.driver.find_element(by, selector)
-                        break
-                    except:
-                        continue
-                
-                if not element:
-                    raise ValueError(f"未找到元素: {element_desc}")
-            
-            element.click()
-            
-            # 记录操作
-            self.operation_history.append({
-                'action': 'click',
-                'element': element_desc,
-                'ref': ref or 'auto',
-                'success': True
-            })
-            
-            return {"success": True}
-            
-        except Exception as e:
-            return {"success": False, "reason": str(e)}
-    
-    async def type_text(self, element_desc: str, text: str, ref: Optional[str] = None):
-        """
-        输入文本
-        
-        Args:
-            element_desc: 元素描述
-            text: 要输入的文本
-            ref: 元素定位器
-            
-        Returns:
-            操作结果
-        """
-        try:
-            from selenium.webdriver.common.by import By
-            
-            # 定位输入框
-            if ref:
-                if ref.startswith('//'):
-                    element = self.driver.find_element(By.XPATH, ref)
-                else:
-                    element = self.driver.find_element(By.ID, ref)
-            else:
-                # 查找第一个输入框
-                element = self.driver.find_element(By.XPATH, "//XCUIElementTypeTextField | //XCUIElementTypeSecureTextField")
-            
-            element.clear()
-            element.send_keys(text)
-            
-            # 记录操作
-            self.operation_history.append({
-                'action': 'type',
-                'element': element_desc,
-                'text': text,
-                'ref': ref or 'auto',
-                'success': True
-            })
-            
-            return {"success": True}
-            
-        except Exception as e:
-            return {"success": False, "reason": str(e)}
-    
-    async def swipe(self, direction: str):
-        """
-        滑动操作
-        
-        Args:
-            direction: 滑动方向 ('up', 'down', 'left', 'right')
-            
-        Returns:
-            操作结果
-        """
-        try:
-            size = self.driver.get_window_size()
-            width = size['width']
-            height = size['height']
-            
-            if direction == 'up':
-                self.driver.swipe(width // 2, int(height * 0.8), width // 2, int(height * 0.2))
-            elif direction == 'down':
-                self.driver.swipe(width // 2, int(height * 0.2), width // 2, int(height * 0.8))
-            elif direction == 'left':
-                self.driver.swipe(int(width * 0.8), height // 2, int(width * 0.2), height // 2)
-            elif direction == 'right':
-                self.driver.swipe(int(width * 0.2), height // 2, int(width * 0.8), height // 2)
-            else:
-                return {"success": False, "reason": f"不支持的滑动方向: {direction}"}
-            
-            return {"success": True}
-            
-        except Exception as e:
-            return {"success": False, "reason": str(e)}
-    
-    async def launch_app(self, bundle_id: str, wait_time: int = 3):
-        """
-        启动应用
-        
-        Args:
-            bundle_id: 应用Bundle ID，如 'com.example.app'
-            wait_time: 等待时间（秒）
-            
-        Returns:
-            操作结果
-        """
-        try:
-            self.driver.activate_app(bundle_id)
-            await asyncio.sleep(wait_time)
-            
-            return {"success": True}
-        except Exception as e:
-            return {"success": False, "reason": str(e)}
-    
-    def get_current_package(self) -> Optional[str]:
-        """获取当前前台应用的Bundle ID"""
-        try:
-            return self.driver.current_package
-        except:
-            return None
-

core/ios_device_manager.py

@@ -1,252 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-iOS设备连接管理 - WebDriverAgent
-
-功能：
-1. 列出所有连接的iOS设备（模拟器和真机）
-2. 连接指定设备
-3. 检查设备状态
-4. 管理WebDriverAgent服务
-
-
-"""
-import sys
-import subprocess
-import os
-import json
-from typing import List, Optional, Dict
-from pathlib import Path
-
-
-class IOSDeviceManager:
-    """
-    iOS设备连接管理器
-    
-    用法:
-        manager = IOSDeviceManager()
-        devices = manager.list_devices()
-        driver = manager.connect(device_id="iPhone 15")
-    """
-    
-    def __init__(self):
-        """初始化iOS设备管理器"""
-        self.xcrun_path = self._find_xcrun()
-        self.driver = None
-        self.current_device_id = None
-    
-    def _find_xcrun(self) -> str:
-        """
-        查找xcrun路径
-        
-        Returns:
-            xcrun可执行文件路径
-        """
-        # xcrun通常在Xcode中，检查常见路径
-        common_paths = [
-            '/usr/bin/xcrun',
-            '/usr/local/bin/xcrun',
-        ]
-        
-        for path in common_paths:
-            if Path(path).exists():
-                return path
-        
-        # 尝试直接调用xcrun（可能在PATH中）
-        try:
-            result = subprocess.run(['xcrun', '--version'], capture_output=True, timeout=2)
-            if result.returncode == 0:
-                return 'xcrun'
-        except:
-            pass
-        
-        raise FileNotFoundError(
-            "未找到xcrun，请安装Xcode Command Line Tools\n"
-            "安装命令: xcode-select --install"
-        )
-    
-    def list_devices(self) -> List[Dict[str, str]]:
-        """
-        列出所有可用的iOS设备（模拟器和真机）
-        
-        Returns:
-            设备列表，每个设备包含id、name、type等信息
-        """
-        devices = []
-        
-        try:
-            # 列出模拟器
-            result = subprocess.run(
-                [self.xcrun_path, 'simctl', 'list', 'devices', '--json'],
-                capture_output=True,
-                text=True,
-                timeout=10
-            )
-            
-            if result.returncode == 0:
-                sim_data = json.loads(result.stdout)
-                for runtime, sims in sim_data.get('devices', {}).items():
-                    for sim in sims:
-                        if sim.get('state') == 'Booted' or sim.get('isAvailable', False):
-                            devices.append({
-                                'id': sim.get('udid', ''),
-                                'name': sim.get('name', 'Unknown'),
-                                'type': 'simulator',
-                                'runtime': runtime,
-                                'state': sim.get('state', 'unknown')
-                            })
-            
-            # 列出真机（通过idevice_id，需要libimobiledevice）
-            try:
-                result = subprocess.run(
-                    ['idevice_id', '-l'],
-                    capture_output=True,
-                    text=True,
-                    timeout=5
-                )
-                if result.returncode == 0:
-                    for udid in result.stdout.strip().split('\n'):
-                        if udid.strip():
-                            devices.append({
-                                'id': udid.strip(),
-                                'name': 'iOS Device',
-                                'type': 'device',
-                                'state': 'connected'
-                            })
-            except FileNotFoundError:
-                # libimobiledevice未安装，跳过真机检测
-                pass
-            
-            return devices
-            
-        except subprocess.TimeoutExpired:
-            raise RuntimeError("获取设备列表超时")
-        except Exception as e:
-            raise RuntimeError(f"获取设备列表失败: {e}")
-    
-    def connect(self, device_id: Optional[str] = None, use_webdriveragent: bool = True) -> 'webdriver.Remote':
-        """
-        连接iOS设备
-        
-        Args:
-            device_id: 设备ID，None则自动选择第一个设备
-            use_webdriveragent: 是否使用WebDriverAgent（默认True）
-            
-        Returns:
-            WebDriver对象
-        """
-        if use_webdriveragent:
-            return self._connect_with_webdriveragent(device_id)
-        else:
-            # 使用Appium（备选方案）
-            return self._connect_with_appium(device_id)
-    
-    def _connect_with_webdriveragent(self, device_id: Optional[str] = None) -> 'webdriver.Remote':
-        """使用WebDriverAgent连接"""
-        try:
-            from appium import webdriver
-            from appium.options.ios import XCUITestOptions
-            
-            # 如果没有指定设备ID，自动选择第一个
-            if device_id is None:
-                devices = self.list_devices()
-                if len(devices) == 0:
-                    raise RuntimeError("未找到连接的设备，请连接设备后重试")
-                device_id = devices[0]['id']
-                print(f"📱 自动选择设备: {device_id}", file=sys.stderr)
-            
-            # 配置WebDriverAgent
-            options = XCUITestOptions()
-            options.platform_name = 'iOS'
-            options.device_name = device_id
-            options.automation_name = 'XCUITest'
-            
-            # WebDriverAgent默认端口
-            wda_port = 8100
-            
-            # 连接WebDriverAgent
-            self.driver = webdriver.Remote(
-                f'http://localhost:{wda_port}',
-                options=options
-            )
-            self.current_device_id = device_id
-            
-            print(f"✅ iOS设备连接成功: {device_id}", file=sys.stderr)
-            
-            return self.driver
-            
-        except ImportError:
-            raise ImportError(
-                "Appium未安装，请运行: pip install Appium-Python-Client\n"
-                "iOS自动化还需要安装WebDriverAgent"
-            )
-        except Exception as e:
-            raise RuntimeError(f"连接iOS设备失败: {e}\n"
-                             f"请确保WebDriverAgent已启动: brew install ios-deploy\n"
-                             f"然后运行: xcodebuild -project WebDriverAgent.xcodeproj -scheme WebDriverAgentRunner -destination 'id={device_id}' test")
-    
-    def _connect_with_appium(self, device_id: Optional[str] = None) -> 'webdriver.Remote':
-        """使用Appium连接（备选方案）"""
-        try:
-            from appium import webdriver
-            from appium.options.ios import XCUITestOptions
-            
-            if device_id is None:
-                devices = self.list_devices()
-                if len(devices) == 0:
-                    raise RuntimeError("未找到连接的设备")
-                device_id = devices[0]['id']
-            
-            options = XCUITestOptions()
-            options.platform_name = 'iOS'
-            options.device_name = device_id
-            options.automation_name = 'XCUITest'
-            
-            # Appium Server默认端口
-            self.driver = webdriver.Remote(
-                'http://localhost:4723',
-                options=options
-            )
-            self.current_device_id = device_id
-            
-            return self.driver
-            
-        except Exception as e:
-            raise RuntimeError(f"Appium连接失败: {e}")
-    
-    def check_device_status(self) -> Dict[str, any]:
-        """
-        检查设备状态
-        
-        Returns:
-            设备状态信息
-        """
-        if not self.driver:
-            return {'connected': False, 'reason': '设备未连接'}
-        
-        try:
-            # 获取设备信息
-            capabilities = self.driver.capabilities
-            return {
-                'connected': True,
-                'device_id': self.current_device_id,
-                'platform_version': capabilities.get('platformVersion', 'Unknown'),
-                'device_name': capabilities.get('deviceName', 'Unknown'),
-            }
-        except Exception as e:
-            return {
-                'connected': False,
-                'reason': str(e)
-            }
-    
-    def disconnect(self):
-        """断开设备连接"""
-        if self.driver:
-            try:
-                self.driver.quit()
-            except:
-                pass
-        self.driver = None
-        self.current_device_id = None
-        print("📱 iOS设备已断开连接", file=sys.stderr)
-

core/locator/__init__.py

@@ -1,10 +0,0 @@
-"""
-移动端定位器模块
-"""
-
-from .mobile_smart_locator import MobileSmartLocator
-
-__all__ = [
-    'MobileSmartLocator',
-]
-

core/locator/cursor_ai_auto_analyzer.py

@@ -1,119 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-Cursor AI 自动分析器
-
-当检测到请求文件时，自动调用Cursor AI分析截图并写入结果文件。
-这个模块可以在后台运行，监控请求文件并自动处理。
-"""
-import asyncio
-import json
-import time
-from pathlib import Path
-from typing import Dict, Optional
-import tempfile
-
-
-class CursorAIAutoAnalyzer:
-    """
-    Cursor AI 自动分析器
-    
-    功能：
-    1. 监控请求文件目录
-    2. 检测到新请求时，自动调用Cursor AI分析
-    3. 将结果写入结果文件
-    """
-    
-    def __init__(self):
-        """初始化自动分析器"""
-        self.request_dir = Path(tempfile.gettempdir()) / "mobile_screenshots" / "requests"
-        self.result_dir = Path(tempfile.gettempdir()) / "mobile_screenshots" / "results"
-        self.request_dir.mkdir(parents=True, exist_ok=True)
-        self.result_dir.mkdir(parents=True, exist_ok=True)
-        self.processed_requests = set()
-    
-    def check_requests(self) -> list[Path]:
-        """
-        检查是否有新的请求文件
-        
-        Returns:
-            新的请求文件列表
-        """
-        if not self.request_dir.exists():
-            return []
-        
-        new_requests = []
-        for request_file in self.request_dir.glob("request_*.json"):
-            if request_file not in self.processed_requests:
-                new_requests.append(request_file)
-        
-        return new_requests
-    
-    async def process_request(self, request_file: Path) -> bool:
-        """
-        处理单个请求
-        
-        Args:
-            request_file: 请求文件路径
-            
-        Returns:
-            是否成功
-        """
-        try:
-            # 读取请求文件
-            with open(request_file, 'r', encoding='utf-8') as f:
-                request_data = json.load(f)
-            
-            request_id = request_data.get('request_id')
-            screenshot_path = request_data.get('screenshot_path')
-            element_desc = request_data.get('element_desc')
-            result_file = self.result_dir / f"result_{request_id}.json"
-            
-            print(f"📝 处理请求: {request_id}")
-            print(f"   截图: {screenshot_path}")
-            print(f"   元素: {element_desc}")
-            
-            # 🎯 这里需要调用Cursor AI分析截图
-            # 由于是在Python脚本中，无法直接调用Cursor AI
-            # 所以这里返回提示信息，告诉用户需要手动调用MCP工具
-            print(f"💡 请手动调用MCP工具分析截图：")
-            print(f"   @mobile_analyze_screenshot request_id=\"{request_id}\"")
-            
-            # 标记为已处理
-            self.processed_requests.add(request_file)
-            
-            return True
-            
-        except Exception as e:
-            print(f"❌ 处理请求失败: {e}")
-            return False
-    
-    async def run(self, check_interval: float = 2.0):
-        """
-        运行自动分析器（监控模式）
-        
-        Args:
-            check_interval: 检查间隔（秒）
-        """
-        print(f"🚀 Cursor AI 自动分析器已启动")
-        print(f"   监控目录: {self.request_dir}")
-        print(f"   检查间隔: {check_interval}秒")
-        
-        while True:
-            try:
-                new_requests = self.check_requests()
-                for request_file in new_requests:
-                    await self.process_request(request_file)
-                
-                await asyncio.sleep(check_interval)
-            except KeyboardInterrupt:
-                print("\n⚠️  自动分析器已停止")
-                break
-            except Exception as e:
-                print(f"❌ 自动分析器异常: {e}")
-                await asyncio.sleep(check_interval)
-
-
-# 注意：这个自动分析器需要在Cursor AI环境中运行
-# 实际使用时，Cursor AI会通过MCP工具自动处理请求文件
-