mobile-mcp-ai 2.6.0__tar.gz → 2.6.2__tar.gz

{mobile_mcp_ai-2.6.0/mobile_mcp_ai.egg-info → mobile_mcp_ai-2.6.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mobile-mcp-ai
-Version: 2.6.0
+Version: 2.6.2
 Summary: 移动端自动化 MCP Server - 支持 Android/iOS，AI 功能可选（基础工具不需要 AI）
 Home-page: https://github.com/test111ddff-hash/mobile-mcp-ai
 Author: douzi

{mobile_mcp_ai-2.6.0 → mobile_mcp_ai-2.6.2}/core/basic_tools_lite.py

@@ -794,11 +794,19 @@ class BasicMobileToolsLite:
                         
                         is_container = any(kw in class_name for kw in ['Layout', 'View', 'Dialog', 'Card', 'Frame'])
                         area_ratio = p_area / screen_area if screen_area > 0 else 0
-                        is_not_fullscreen = (p_width < screen_width * 0.99 or p_height < screen_height * 0.95)
-                        # 放宽面积范围：5% - 95%
-                        is_reasonable_size = 0.05 < area_ratio < 0.95
                         
-                        if is_container and is_not_fullscreen and is_reasonable_size and py1 > 30:
+                        # 弹窗特征判断（更严格，排除主要内容区域）：
+                        # 1. 不是全屏（宽度和高度都要小于屏幕的95%）
+                        is_not_fullscreen = (p_width < screen_width * 0.95 and p_height < screen_height * 0.95)
+                        # 2. 面积范围：10% - 70%（排除主要内容区域，通常占80%+）
+                        is_reasonable_size = 0.10 < area_ratio < 0.70
+                        # 3. 不在屏幕左边缘（排除从x=0开始的主要内容容器）
+                        is_not_at_left_edge = px1 > screen_width * 0.05
+                        # 4. 高度不能占据屏幕的大部分（排除主要内容区域）
+                        height_ratio = p_height / screen_height if screen_height > 0 else 0
+                        is_not_main_content = height_ratio < 0.85
+                        
+                        if is_container and is_not_fullscreen and is_reasonable_size and is_not_at_left_edge and is_not_main_content and py1 > 30:
                             if popup_bounds is None or p_area > (popup_bounds[2] - popup_bounds[0]) * (popup_bounds[3] - popup_bounds[1]):
                                 popup_bounds = (px1, py1, px2, py2)
                     
@@ -1200,8 +1208,16 @@ class BasicMobileToolsLite:
         except Exception as e:
             return {"success": False, "message": f"❌ 百分比点击失败: {e}"}
     
-    def click_by_text(self, text: str, timeout: float = 3.0) -> Dict:
-        """通过文本点击 - 先查 XML 树，再精准匹配"""
+    def click_by_text(self, text: str, timeout: float = 3.0, position: Optional[str] = None) -> Dict:
+        """通过文本点击 - 先查 XML 树，再精准匹配
+        
+        Args:
+            text: 元素的文本内容
+            timeout: 超时时间
+            position: 位置信息，当有多个相同文案时使用。支持：
+                - 垂直方向: "top"/"upper"/"上", "bottom"/"lower"/"下", "middle"/"center"/"中"
+                - 水平方向: "left"/"左", "right"/"右", "center"/"中"
+        """
         try:
             if self._is_ios():
                 ios_client = self._get_ios_client()
@@ -1217,14 +1233,24 @@ class BasicMobileToolsLite:
                     return {"success": False, "message": f"❌ 文本不存在: {text}"}
             else:
                 # 🔍 先查 XML 树，找到元素及其属性
-                found_elem = self._find_element_in_tree(text)
+                found_elem = self._find_element_in_tree(text, position=position)
                 
                 if found_elem:
                     attr_type = found_elem['attr_type']
                     attr_value = found_elem['attr_value']
                     bounds = found_elem.get('bounds')
                     
-                    # 根据找到的属性类型，使用对应的选择器
+                    # 如果有位置参数，直接使用坐标点击（避免 u2 选择器匹配到错误的元素）
+                    if position and bounds:
+                        x = (bounds[0] + bounds[2]) // 2
+                        y = (bounds[1] + bounds[3]) // 2
+                        self.client.u2.click(x, y)
+                        time.sleep(0.3)
+                        position_info = f" ({position})" if position else ""
+                        self._record_operation('click', element=text, x=x, y=y, ref=f"coords:{x},{y}")
+                        return {"success": True, "message": f"✅ 点击成功(坐标定位): '{text}'{position_info} @ ({x},{y})"}
+                    
+                    # 没有位置参数时，使用选择器定位
                     if attr_type == 'text':
                         elem = self.client.u2(text=attr_value)
                     elif attr_type == 'textContains':
@@ -1239,8 +1265,9 @@ class BasicMobileToolsLite:
                     if elem and elem.exists(timeout=1):
                         elem.click()
                         time.sleep(0.3)
+                        position_info = f" ({position})" if position else ""
                         self._record_operation('click', element=text, ref=f"{attr_type}:{attr_value}")
-                        return {"success": True, "message": f"✅ 点击成功({attr_type}): '{text}'"}
+                        return {"success": True, "message": f"✅ 点击成功({attr_type}): '{text}'{position_info}"}
                     
                     # 如果选择器失败，用坐标兜底
                     if bounds:
@@ -1248,24 +1275,37 @@ class BasicMobileToolsLite:
                         y = (bounds[1] + bounds[3]) // 2
                         self.client.u2.click(x, y)
                         time.sleep(0.3)
+                        position_info = f" ({position})" if position else ""
                         self._record_operation('click', element=text, x=x, y=y, ref=f"coords:{x},{y}")
-                        return {"success": True, "message": f"✅ 点击成功(坐标兜底): '{text}' @ ({x},{y})"}
+                        return {"success": True, "message": f"✅ 点击成功(坐标兜底): '{text}'{position_info} @ ({x},{y})"}
                 
                 return {"success": False, "message": f"❌ 文本不存在: {text}"}
         except Exception as e:
             return {"success": False, "message": f"❌ 点击失败: {e}"}
     
-    def _find_element_in_tree(self, text: str) -> Optional[Dict]:
-        """在 XML 树中查找包含指定文本的元素"""
+    def _find_element_in_tree(self, text: str, position: Optional[str] = None) -> Optional[Dict]:
+        """在 XML 树中查找包含指定文本的元素，优先返回可点击的元素
+        
+        Args:
+            text: 要查找的文本
+            position: 位置信息，用于在有多个相同文案时筛选
+        """
         try:
             xml = self.client.u2.dump_hierarchy(compressed=False)
             import xml.etree.ElementTree as ET
             root = ET.fromstring(xml)
             
+            # 获取屏幕尺寸
+            screen_width, screen_height = self.client.u2.window_size()
+            
+            # 存储所有匹配的元素（包括不可点击的）
+            matched_elements = []
+            
             for elem in root.iter():
                 elem_text = elem.attrib.get('text', '')
                 elem_desc = elem.attrib.get('content-desc', '')
                 bounds_str = elem.attrib.get('bounds', '')
+                clickable = elem.attrib.get('clickable', 'false').lower() == 'true'
                 
                 # 解析 bounds
                 bounds = None
@@ -1275,24 +1315,108 @@ class BasicMobileToolsLite:
                     if len(match) == 4:
                         bounds = [int(x) for x in match]
                 
+                # 判断是否匹配
+                is_match = False
+                attr_type = None
+                attr_value = None
+                
                 # 精确匹配 text
                 if elem_text == text:
-                    return {'attr_type': 'text', 'attr_value': text, 'bounds': bounds}
-                
+                    is_match = True
+                    attr_type = 'text'
+                    attr_value = text
                 # 精确匹配 content-desc
-                if elem_desc == text:
-                    return {'attr_type': 'description', 'attr_value': text, 'bounds': bounds}
-                
+                elif elem_desc == text:
+                    is_match = True
+                    attr_type = 'description'
+                    attr_value = text
                 # 模糊匹配 text
-                if text in elem_text:
-                    return {'attr_type': 'textContains', 'attr_value': text, 'bounds': bounds}
-                
+                elif text in elem_text:
+                    is_match = True
+                    attr_type = 'textContains'
+                    attr_value = text
                 # 模糊匹配 content-desc
-                if text in elem_desc:
-                    return {'attr_type': 'descriptionContains', 'attr_value': text, 'bounds': bounds}
+                elif text in elem_desc:
+                    is_match = True
+                    attr_type = 'descriptionContains'
+                    attr_value = text
+                
+                if is_match and bounds:
+                    # 计算元素的中心点坐标
+                    center_x = (bounds[0] + bounds[2]) / 2
+                    center_y = (bounds[1] + bounds[3]) / 2
+                    
+                    matched_elements.append({
+                        'attr_type': attr_type,
+                        'attr_value': attr_value,
+                        'bounds': bounds,
+                        'clickable': clickable,
+                        'center_x': center_x,
+                        'center_y': center_y
+                    })
+            
+            if not matched_elements:
+                return None
+            
+            # 如果有位置信息，根据位置筛选
+            if position and len(matched_elements) > 1:
+                position_lower = position.lower()
+                
+                # 根据位置信息排序
+                if position_lower in ['top', 'upper', '上', '上方']:
+                    # 选择 y 坐标最小的（最上面的）
+                    matched_elements = sorted(matched_elements, key=lambda x: x['center_y'])
+                elif position_lower in ['bottom', 'lower', '下', '下方', '底部']:
+                    # 选择 y 坐标最大的（最下面的）
+                    matched_elements = sorted(matched_elements, key=lambda x: x['center_y'], reverse=True)
+                elif position_lower in ['left', '左', '左侧']:
+                    # 选择 x 坐标最小的（最左边的）
+                    matched_elements = sorted(matched_elements, key=lambda x: x['center_x'])
+                elif position_lower in ['right', '右', '右侧']:
+                    # 选择 x 坐标最大的（最右边的）
+                    matched_elements = sorted(matched_elements, key=lambda x: x['center_x'], reverse=True)
+                elif position_lower in ['middle', 'center', '中', '中间']:
+                    # 选择最接近屏幕中心的
+                    screen_mid_x = screen_width / 2
+                    screen_mid_y = screen_height / 2
+                    matched_elements = sorted(
+                        matched_elements,
+                        key=lambda x: abs(x['center_x'] - screen_mid_x) + abs(x['center_y'] - screen_mid_y)
+                    )
+            
+            # 如果有位置信息，优先返回排序后的第一个元素（最符合位置要求的）
+            # 如果没有位置信息，优先返回可点击的元素
+            if position and matched_elements:
+                # 有位置信息时，直接返回排序后的第一个（最符合位置要求的）
+                first_match = matched_elements[0]
+                return {
+                    'attr_type': first_match['attr_type'],
+                    'attr_value': first_match['attr_value'],
+                    'bounds': first_match['bounds']
+                }
+            
+            # 没有位置信息时，优先返回可点击的元素
+            for match in matched_elements:
+                if match['clickable']:
+                    return {
+                        'attr_type': match['attr_type'],
+                        'attr_value': match['attr_value'],
+                        'bounds': match['bounds']
+                    }
+            
+            # 如果没有可点击的元素，直接返回第一个匹配元素的 bounds（使用坐标点击）
+            if matched_elements:
+                first_match = matched_elements[0]
+                return {
+                    'attr_type': first_match['attr_type'],
+                    'attr_value': first_match['attr_value'],
+                    'bounds': first_match['bounds']
+                }
             
             return None
-        except Exception:
+        except Exception as e:
+            import traceback
+            traceback.print_exc()
             return None
     
     def click_by_id(self, resource_id: str, index: int = 0) -> Dict:
@@ -2526,19 +2650,24 @@ class BasicMobileToolsLite:
                     area = width * height
                     screen_area = screen_width * screen_height
                     
-                    # 弹窗容器特征：
-                    # 1. 面积在屏幕的 10%-90% 之间（非全屏）
-                    # 2. 宽度或高度不等于屏幕尺寸
+                    # 弹窗容器特征（更严格，排除主要内容区域）：
+                    # 1. 面积在屏幕的 10%-70% 之间（排除主要内容区域，通常占80%+）
+                    # 2. 宽度和高度都要小于屏幕的95%（不是全屏）
                     # 3. 是容器类型（Layout/View/Dialog）
+                    # 4. 不在屏幕左边缘（排除从x=0开始的主要内容容器）
+                    # 5. 高度不能占据屏幕的大部分（排除主要内容区域）
                     is_container = any(kw in class_name for kw in ['Layout', 'View', 'Dialog', 'Card', 'Container'])
                     area_ratio = area / screen_area
-                    is_not_fullscreen = (width < screen_width * 0.98 or height < screen_height * 0.98)
-                    is_reasonable_size = 0.08 < area_ratio < 0.9
+                    is_not_fullscreen = (width < screen_width * 0.95 and height < screen_height * 0.95)
+                    is_reasonable_size = 0.10 < area_ratio < 0.70
+                    is_not_at_left_edge = x1 > screen_width * 0.05
+                    height_ratio = height / screen_height if screen_height > 0 else 0
+                    is_not_main_content = height_ratio < 0.85
                     
                     # 排除状态栏区域（y1 通常很小）
                     is_below_statusbar = y1 > 50
                     
-                    if is_container and is_not_fullscreen and is_reasonable_size and is_below_statusbar:
+                    if is_container and is_not_fullscreen and is_reasonable_size and is_not_at_left_edge and is_not_main_content and is_below_statusbar:
                         popup_containers.append({
                             'bounds': (x1, y1, x2, y2),
                             'bounds_str': bounds_str,
@@ -2970,8 +3099,8 @@ class BasicMobileToolsLite:
             f"生成时间: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}",
             "",
             "定位策略（按优先级）：",
-            "1. ID 定位 - 最稳定，跨设备兼容",
-            "2. 文本定位 - 稳定，跨设备兼容",
+            "1. 文本定位 - 最稳定，跨设备兼容",
+            "2. ID 定位 - 稳定，跨设备兼容",
             "3. 百分比定位 - 跨分辨率兼容（坐标自动转换）",
             f'"""',
             "import time",
@@ -3086,21 +3215,21 @@ class BasicMobileToolsLite:
                 is_coords_ref = ref.startswith('coords_') or ref.startswith('coords:')
                 is_percent_ref = ref.startswith('percent_')
                 
-                # 优先级：ID > 文本 > 百分比 > 坐标（兜底）
-                if ref and (':id/' in ref or ref.startswith('com.')):
-                    # 1️⃣ 使用 resource-id（最稳定）
-                    script_lines.append(f"    # 步骤{step_num}: 点击元素 (ID定位，最稳定)")
-                    script_lines.append(f"    safe_click(d, d(resourceId='{ref}'))")
-                elif ref and not is_coords_ref and not is_percent_ref and ':' not in ref:
-                    # 2️⃣ 使用文本（稳定）- 排除 "text:xxx" 等带冒号的格式
-                    script_lines.append(f"    # 步骤{step_num}: 点击文本 '{ref}' (文本定位)")
+                # 优先级：文本 > ID > 百分比 > 坐标（兜底）
+                if ref and not is_coords_ref and not is_percent_ref and ':' not in ref:
+                    # 1️⃣ 使用文本（最稳定，优先）- 排除 "text:xxx" 等带冒号的格式
+                    script_lines.append(f"    # 步骤{step_num}: 点击文本 '{ref}' (文本定位，最稳定)")
                     script_lines.append(f"    safe_click(d, d(text='{ref}'))")
                 elif ref and ':' in ref and not is_coords_ref and not is_percent_ref:
-                    # 2️⃣-b 使用文本（Android 的 text:xxx 或 description:xxx 格式）
+                    # 1️⃣-b 使用文本（Android 的 text:xxx 或 description:xxx 格式）
                     # 提取冒号后面的实际文本值
                     actual_text = ref.split(':', 1)[1] if ':' in ref else ref
-                    script_lines.append(f"    # 步骤{step_num}: 点击文本 '{actual_text}' (文本定位)")
+                    script_lines.append(f"    # 步骤{step_num}: 点击文本 '{actual_text}' (文本定位，最稳定)")
                     script_lines.append(f"    safe_click(d, d(text='{actual_text}'))")
+                elif ref and (':id/' in ref or ref.startswith('com.')):
+                    # 2️⃣ 使用 resource-id（稳定）
+                    script_lines.append(f"    # 步骤{step_num}: 点击元素 (ID定位)")
+                    script_lines.append(f"    safe_click(d, d(resourceId='{ref}'))")
                 elif has_percent:
                     # 3️⃣ 使用百分比（跨分辨率兼容）
                     x_pct = op['x_percent']
@@ -3166,19 +3295,20 @@ class BasicMobileToolsLite:
                 is_coords_ref = ref.startswith('coords_') or ref.startswith('coords:')
                 is_percent_ref = ref.startswith('percent_')
                 
-                # 优先级：ID > 文本 > 百分比 > 坐标
-                if ref and (':id/' in ref or ref.startswith('com.')):
-                    # 使用 resource-id
-                    script_lines.append(f"    # 步骤{step_num}: 长按元素 (ID定位，最稳定)")
-                    script_lines.append(f"    d(resourceId='{ref}').long_click(duration={duration})")
-                elif ref and not is_coords_ref and not is_percent_ref and ':' not in ref:
-                    # 使用文本
-                    script_lines.append(f"    # 步骤{step_num}: 长按文本 '{ref}' (文本定位)")
+                # 优先级：文本 > ID > 百分比 > 坐标
+                if ref and not is_coords_ref and not is_percent_ref and ':' not in ref:
+                    # 1️⃣ 使用文本（最稳定，优先）
+                    script_lines.append(f"    # 步骤{step_num}: 长按文本 '{ref}' (文本定位，最稳定)")
                     script_lines.append(f"    d(text='{ref}').long_click(duration={duration})")
                 elif ref and ':' in ref and not is_coords_ref and not is_percent_ref:
+                    # 1️⃣-b 使用文本（Android 的 text:xxx 或 description:xxx 格式）
                     actual_text = ref.split(':', 1)[1] if ':' in ref else ref
-                    script_lines.append(f"    # 步骤{step_num}: 长按文本 '{actual_text}' (文本定位)")
+                    script_lines.append(f"    # 步骤{step_num}: 长按文本 '{actual_text}' (文本定位，最稳定)")
                     script_lines.append(f"    d(text='{actual_text}').long_click(duration={duration})")
+                elif ref and (':id/' in ref or ref.startswith('com.')):
+                    # 2️⃣ 使用 resource-id（稳定）
+                    script_lines.append(f"    # 步骤{step_num}: 长按元素 (ID定位)")
+                    script_lines.append(f"    d(resourceId='{ref}').long_click(duration={duration})")
                 elif has_percent:
                     # 使用百分比
                     x_pct = op['x_percent']

{mobile_mcp_ai-2.6.0 → mobile_mcp_ai-2.6.2}/mcp_tools/mcp_server.py

@@ -206,7 +206,7 @@ class MobileMCPServer:
             name="mobile_list_elements",
             description="📋 列出页面所有可交互元素\n\n"
                        "⚠️ 【重要】点击元素前必须先调用此工具！\n"
-                       "如果元素在控件树中存在，使用 click_by_id 或 click_by_text 定位。\n"
+                       "如果元素在控件树中存在，使用 click_by_text 或 click_by_id 定位。\n"
                        "只有当此工具返回空或找不到目标元素时，才使用截图+坐标方式。\n\n"
                        "📌 控件树定位优势：\n"
                        "- 实时检测元素是否存在\n"
@@ -313,14 +313,21 @@ class MobileMCPServer:
         # ==================== 点击操作 ====================
         tools.append(Tool(
             name="mobile_click_by_text",
-            description="👆 通过文本点击元素（推荐）\n\n"
+            description="👆 通过文本点击元素（最推荐）\n\n"
+                       "✅ 最稳定的定位方式，跨设备兼容\n"
                        "✅ 实时检测元素是否存在，元素不存在会报错\n"
                        "✅ 不会误点击到其他位置\n"
-                       "📋 使用前先调用 mobile_list_elements 确认元素文本",
+                       "📋 使用前先调用 mobile_list_elements 确认元素文本\n"
+                       "💡 定位优先级：文本 > ID > 百分比 > 坐标\n\n"
+                       "📍 当页面有多个相同文案时，可使用 position 参数指定位置：\n"
+                       "   - 垂直方向: \"top\"/\"upper\"/\"上\", \"bottom\"/\"lower\"/\"下\", \"middle\"/\"center\"/\"中\"\n"
+                       "   - 水平方向: \"left\"/\"左\", \"right\"/\"右\", \"center\"/\"中\"\n"
+                       "   例如：点击\"底部\"的\"微剧\"tab，使用 position=\"bottom\"",
             inputSchema={
                 "type": "object",
                 "properties": {
-                    "text": {"type": "string", "description": "元素的文本内容（精确匹配）"}
+                    "text": {"type": "string", "description": "元素的文本内容（精确匹配）"},
+                    "position": {"type": "string", "description": "位置信息（可选）。当有多个相同文案时使用，支持：top/bottom/left/right/middle 或 上/下/左/右/中"}
                 },
                 "required": ["text"]
             }
@@ -328,11 +335,12 @@ class MobileMCPServer:
         
         tools.append(Tool(
             name="mobile_click_by_id",
-            description="👆 通过 resource-id 点击元素（最推荐）\n\n"
-                       "✅ 最稳定的定位方式\n"
+            description="👆 通过 resource-id 点击元素（推荐）\n\n"
+                       "✅ 稳定的定位方式\n"
                        "✅ 实时检测元素是否存在，元素不存在会报错\n"
                        "📋 使用前先调用 mobile_list_elements 获取元素 ID\n"
-                       "💡 当有多个相同 ID 的元素时，用 index 指定第几个（从 0 开始）",
+                       "💡 当有多个相同 ID 的元素时，用 index 指定第几个（从 0 开始）\n"
+                       "💡 定位优先级：文本 > ID > 百分比 > 坐标",
             inputSchema={
                 "type": "object",
                 "properties": {
@@ -346,7 +354,7 @@ class MobileMCPServer:
         tools.append(Tool(
             name="mobile_click_at_coords",
             description="👆 点击指定坐标（兜底方案）\n\n"
-                       "⚠️ 【重要】优先使用 mobile_click_by_id 或 mobile_click_by_text！\n"
+                       "⚠️ 【重要】优先使用 mobile_click_by_text 或 mobile_click_by_id！\n"
                        "仅在 mobile_list_elements 无法获取元素时使用此工具。\n\n"
                        "⚠️ 【时序限制】截图分析期间页面可能变化：\n"
                        "- 坐标是基于截图时刻的，点击时页面可能已不同\n"
@@ -447,7 +455,7 @@ class MobileMCPServer:
         
         tools.append(Tool(
             name="mobile_long_press_at_coords",
-            description="👆 长按指定坐标（⚠️ 兜底方案，优先用 ID/文本定位！）\n\n"
+            description="👆 长按指定坐标（⚠️ 兜底方案，优先用文本/ID定位！）\n\n"
                        "🎯 仅在以下场景使用：\n"
                        "- 游戏（Unity/Cocos）无法获取元素\n"
                        "- mobile_list_elements 返回空\n"
@@ -610,22 +618,25 @@ class MobileMCPServer:
             name="mobile_find_close_button",
             description="""🔍 智能查找关闭按钮（只找不点，返回位置）
 
-从元素树中找最可能的关闭按钮，返回坐标和百分比位置。
+⚡ 【推荐首选】遇到弹窗时优先调用此工具！无需先截图。
+
+从元素树中找最可能的关闭按钮，返回坐标和推荐的点击命令。
 
 🎯 识别策略（优先级）：
-1. 文本匹配：×、X、关闭、取消、跳过 等
-2. 描述匹配：content-desc 包含 close/关闭
-3. 小尺寸 clickable 元素（右上角优先）
+1. 文本匹配：×、X、关闭、取消、跳过 等（得分100）
+2. resource-id 匹配：包含 close/dismiss/skip（得分95）
+3. content-desc 匹配：包含 close/关闭（得分90）
+4. 小尺寸 clickable 元素（右上角优先，得分70+）
 
 ✅ 返回内容：
 - 坐标 (x, y) 和百分比 (x%, y%)
-- 推荐的点击命令：mobile_click_by_percent(x%, y%)
-- 多个候选位置（供确认）
+- resource-id（如果有）
+- 推荐的点击命令（优先 click_by_text，其次 click_by_id，最后 click_by_percent）
 
 💡 使用流程：
-1. 调用此工具找到关闭按钮位置
-2. 确认位置正确后，用 mobile_click_by_percent 点击
-3. 百分比点击兼容不同分辨率手机""",
+1. 直接调用此工具（无需先截图/列元素）
+2. 根据返回的 click_command 执行点击
+3. 如果返回 success=false，才需要截图分析""",
             inputSchema={"type": "object", "properties": {}, "required": []}
         ))
         
@@ -677,7 +688,7 @@ class MobileMCPServer:
             name="mobile_clear_operation_history",
             description="🗑️ 清空操作历史记录。\n\n"
                        "⚠️ 开始新的测试录制前必须调用！\n"
-                       "📋 录制流程：清空历史 → 执行操作（优先用ID/文本定位）→ 生成脚本",
+                       "📋 录制流程：清空历史 → 执行操作（优先用文本/ID定位）→ 生成脚本",
             inputSchema={"type": "object", "properties": {}, "required": []}
         ))
         
@@ -686,15 +697,15 @@ class MobileMCPServer:
             description="📝 生成 pytest 测试脚本。基于操作历史自动生成。\n\n"
                        "⚠️ 【重要】录制操作时请优先使用稳定定位：\n"
                        "1️⃣ 先调用 mobile_list_elements 获取元素列表\n"
-                       "2️⃣ 优先用 mobile_click_by_id（最稳定，跨设备兼容）\n"
-                       "3️⃣ 其次用 mobile_click_by_text（稳定）\n"
+                       "2️⃣ 优先用 mobile_click_by_text（最稳定，跨设备兼容）\n"
+                       "3️⃣ 其次用 mobile_click_by_id（稳定）\n"
                        "4️⃣ 最后才用坐标点击（会自动转百分比，跨分辨率兼容）\n\n"
                        "使用流程：\n"
                        "1. 清空历史 mobile_clear_operation_history\n"
-                       "2. 执行操作（优先用 ID/文本定位）\n"
+                       "2. 执行操作（优先用文本/ID定位）\n"
                        "3. 调用此工具生成脚本\n"
                        "4. 脚本保存到 tests/ 目录\n\n"
-                       "💡 定位优先级：ID > 文本 > 百分比 > 坐标",
+                       "💡 定位优先级：文本 > ID > 百分比 > 坐标",
             inputSchema={
                 "type": "object",
                 "properties": {
@@ -711,24 +722,26 @@ class MobileMCPServer:
             name="mobile_close_ad",
             description="""🚫 【推荐】智能关闭广告弹窗
 
-专门用于关闭广告弹窗，按优先级自动尝试多种方式：
+⚡ 直接调用即可，无需先截图！会自动按优先级尝试：
 
-1️⃣ **控件树查找**（最可靠）
-   - 自动查找"关闭"、"跳过"、"×"等关闭按钮
+1️⃣ **控件树查找**（最可靠，优先）
+   - 自动查找 resource-id 包含 close/dismiss
+   - 查找文本"关闭"、"跳过"、"×"等
    - 找到直接点击，实时可靠
 
 2️⃣ **模板匹配**（次优）
    - 用 OpenCV 匹配已保存的 X 按钮模板
-   - 需要积累模板库，模板越多成功率越高
+   - 模板越多成功率越高
 
 3️⃣ **返回截图供 AI 分析**（兜底）
-   - 如果前两步失败，返回截图
+   - 前两步都失败才截图
    - AI 分析后用 mobile_click_by_percent 点击
-   - 点击成功后用 mobile_template_add 添加模板（自动学习）
+   - 点击成功后用 mobile_template_add 添加模板
 
-💡 使用流程：
-1. 遇到广告弹窗 → 调用此工具
+💡 正确流程：
+1. 遇到广告弹窗 → 直接调用此工具
 2. 如果成功 → 完成
+3. 只有失败时才需要截图分析
 3. 如果失败 → 看截图找 X → 点击 → 添加模板""",
             inputSchema={
                 "type": "object",
@@ -858,7 +871,10 @@ class MobileMCPServer:
                 return [TextContent(type="text", text=self.format_response(result))]
             
             elif name == "mobile_click_by_text":
-                result = self.tools.click_by_text(arguments["text"])
+                result = self.tools.click_by_text(
+                    arguments["text"],
+                    position=arguments.get("position")
+                )
                 return [TextContent(type="text", text=self.format_response(result))]
             
             elif name == "mobile_click_by_id":

{mobile_mcp_ai-2.6.0 → mobile_mcp_ai-2.6.2/mobile_mcp_ai.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mobile-mcp-ai
-Version: 2.6.0
+Version: 2.6.2
 Summary: 移动端自动化 MCP Server - 支持 Android/iOS，AI 功能可选（基础工具不需要 AI）
 Home-page: https://github.com/test111ddff-hash/mobile-mcp-ai
 Author: douzi

{mobile_mcp_ai-2.6.0 → mobile_mcp_ai-2.6.2}/setup.py

@@ -25,7 +25,7 @@ if requirements_file.exists():
 
 setup(
     name="mobile-mcp-ai",
-    version="2.6.0",  # list_elements 增加文本过滤，保留有文本的元素
+    version="2.6.2",  # find_close_button 增加 resource-id 匹配 + list_elements 文本过滤
     author="douzi",
     author_email="1492994674@qq.com",
     description="移动端自动化 MCP Server - 支持 Android/iOS，AI 功能可选（基础工具不需要 AI）",