mobile-mcp-ai 2.5.10__py3-none-any.whl → 2.5.11__py3-none-any.whl

mobile_mcp/core/basic_tools_lite.py

@@ -31,9 +31,6 @@ class BasicMobileToolsLite:
         
         # 操作历史（用于生成 pytest 脚本）
         self.operation_history: List[Dict] = []
-        
-        # 目标应用包名（用于监测应用跳转）
-        self.target_package: Optional[str] = None
     
     def _is_ios(self) -> bool:
         """判断当前是否为 iOS 平台"""
@@ -56,157 +53,34 @@ class BasicMobileToolsLite:
         }
         self.operation_history.append(record)
     
-    def _get_current_package(self) -> Optional[str]:
-        """获取当前前台应用的包名/Bundle ID"""
-        try:
-            if self._is_ios():
-                ios_client = self._get_ios_client()
-                if ios_client and hasattr(ios_client, 'wda'):
-                    app_info = ios_client.wda.session().app_current()
-                    return app_info.get('bundleId')
-            else:
-                info = self.client.u2.app_current()
-                return info.get('package')
-        except Exception:
-            return None
-    
-    def _check_app_switched(self) -> Dict:
-        """检查是否已跳出目标应用
+    def _get_full_hierarchy(self) -> str:
+        """获取完整的 UI 层级 XML（包含 NAF 元素）
         
-        Returns:
-            {
-                'switched': bool,  # 是否跳转
-                'current_package': str,  # 当前应用包名
-                'target_package': str,  # 目标应用包名
-                'message': str  # 提示信息
-            }
+        优先使用 ADB 直接 dump，比 uiautomator2.dump_hierarchy 更完整
         """
-        if not self.target_package:
-            return {
-                'switched': False,
-                'current_package': None,
-                'target_package': None,
-                'message': '⚠️ 未设置目标应用，无法监测应用跳转'
-            }
-        
-        current = self._get_current_package()
-        if not current:
-            return {
-                'switched': False,
-                'current_package': None,
-                'target_package': self.target_package,
-                'message': '⚠️ 无法获取当前应用包名'
-            }
-        
-        if current != self.target_package:
-            return {
-                'switched': True,
-                'current_package': current,
-                'target_package': self.target_package,
-                'message': f'⚠️ 应用已跳转！当前应用: {current}，目标应用: {self.target_package}'
-            }
+        import sys
         
-        return {
-            'switched': False,
-            'current_package': current,
-            'target_package': self.target_package,
-            'message': f'✅ 仍在目标应用: {current}'
-        }
-    
-    def _return_to_target_app(self) -> Dict:
-        """返回到目标应用
-        
-        策略：
-        1. 先按返回键（可能关闭弹窗或返回上一页）
-        2. 如果还在其他应用，启动目标应用
-        3. 验证是否成功返回
-        
-        Returns:
-            {
-                'success': bool,
-                'message': str,
-                'method': str  # 使用的返回方法
-            }
-        """
-        if not self.target_package:
-            return {
-                'success': False,
-                'message': '❌ 未设置目标应用，无法返回',
-                'method': None
-            }
+        if self._is_ios():
+            # iOS 使用 page_source
+            ios_client = self._get_ios_client()
+            if ios_client and hasattr(ios_client, 'wda'):
+                return ios_client.wda.source()
+            return ""
         
+        # Android: 优先使用 ADB 直接 dump
         try:
-            # 先检查当前应用
-            current = self._get_current_package()
-            if not current:
-                return {
-                    'success': False,
-                    'message': '❌ 无法获取当前应用包名',
-                    'method': None
-                }
-            
-            # 如果已经在目标应用，不需要返回
-            if current == self.target_package:
-                return {
-                    'success': True,
-                    'message': f'✅ 已在目标应用: {self.target_package}',
-                    'method': 'already_in_target'
-                }
-            
-            # 策略1: 先按返回键（可能关闭弹窗或返回）
-            if self._is_ios():
-                ios_client = self._get_ios_client()
-                if ios_client and hasattr(ios_client, 'wda'):
-                    # iOS 返回键
-                    ios_client.wda.press('home')  # iOS 先按 home
-                    time.sleep(0.5)
-                    # 然后启动目标应用
-                    ios_client.wda.app_activate(self.target_package)
-                else:
-                    return {
-                        'success': False,
-                        'message': '❌ iOS 客户端未初始化',
-                        'method': None
-                    }
-            else:
-                # Android: 先按返回键
-                self.client.u2.press('back')
-                time.sleep(0.5)
-                
-                # 检查是否已返回
-                current = self._get_current_package()
-                if current == self.target_package:
-                    return {
-                        'success': True,
-                        'message': f'✅ 已返回目标应用: {self.target_package}（通过返回键）',
-                        'method': 'back_key'
-                    }
-                
-                # 如果还在其他应用，启动目标应用
-                self.client.u2.app_start(self.target_package)
-                time.sleep(1)
-            
-            # 验证是否成功返回
-            current = self._get_current_package()
-            if current == self.target_package:
-                return {
-                    'success': True,
-                    'message': f'✅ 已返回目标应用: {self.target_package}',
-                    'method': 'app_start'
-                }
-            else:
-                return {
-                    'success': False,
-                    'message': f'❌ 返回失败：当前应用仍为 {current}，期望 {self.target_package}',
-                    'method': 'app_start'
-                }
+            # 方法1: ADB dump（获取最完整的 UI 树，包括 NAF 元素）
+            self.client.u2.shell('uiautomator dump /sdcard/ui_dump.xml')
+            result = self.client.u2.shell('cat /sdcard/ui_dump.xml')
+            if result and isinstance(result, str) and result.strip().startswith('<?xml'):
+                xml_string = result.strip()
+                self.client.u2.shell('rm /sdcard/ui_dump.xml')
+                return xml_string
         except Exception as e:
-            return {
-                'success': False,
-                'message': f'❌ 返回目标应用失败: {e}',
-                'method': None
-            }
-    
+            print(f"  ⚠️  ADB dump 失败: {e}", file=sys.stderr)
+        
+        # 方法2: 回退到 uiautomator2
+        return self.client.u2.dump_hierarchy(compressed=False)
     
     # ==================== 截图 ====================
     
@@ -507,7 +381,7 @@ class BasicMobileToolsLite:
             if show_popup_hints and not self._is_ios():
                 try:
                     import xml.etree.ElementTree as ET
-                    xml_string = self.client.u2.dump_hierarchy(compressed=False)
+                    xml_string = self._get_full_hierarchy()
                     root = ET.fromstring(xml_string)
                     
                     # 检测弹窗区域
@@ -684,7 +558,7 @@ class BasicMobileToolsLite:
             else:
                 try:
                     import xml.etree.ElementTree as ET
-                    xml_string = self.client.u2.dump_hierarchy(compressed=False)
+                    xml_string = self._get_full_hierarchy()
                     root = ET.fromstring(xml_string)
                     
                     for elem in root.iter():
@@ -1089,41 +963,25 @@ class BasicMobileToolsLite:
                 ref=f"coords_{x}_{y}"
             )
             
-            # 🎯 关键步骤：检查应用是否跳转，如果跳转则自动返回目标应用
-            app_check = self._check_app_switched()
-            return_result = None
-            
-            if app_check['switched']:
-                # 应用已跳转，尝试返回目标应用
-                return_result = self._return_to_target_app()
-            
-            # 构建返回消息
             if converted:
                 if conversion_type == "crop_offset":
-                    msg = f"✅ 点击成功: ({x}, {y})\n" \
-                          f"   🔍 局部截图坐标转换: ({original_x},{original_y}) + 偏移({crop_offset_x},{crop_offset_y}) → ({x},{y})"
+                    return {
+                        "success": True,
+                        "message": f"✅ 点击成功: ({x}, {y})\n"
+                                  f"   🔍 局部截图坐标转换: ({original_x},{original_y}) + 偏移({crop_offset_x},{crop_offset_y}) → ({x},{y})"
+                    }
                 else:
-                    msg = f"✅ 点击成功: ({x}, {y})\n" \
-                          f"   📐 坐标已转换: ({original_x},{original_y}) → ({x},{y})\n" \
-                          f"   🖼️ 图片尺寸: {image_width}x{image_height} → 屏幕: {screen_width}x{screen_height}"
+                    return {
+                        "success": True,
+                        "message": f"✅ 点击成功: ({x}, {y})\n"
+                                  f"   📐 坐标已转换: ({original_x},{original_y}) → ({x},{y})\n"
+                                  f"   🖼️ 图片尺寸: {image_width}x{image_height} → 屏幕: {screen_width}x{screen_height}"
+                    }
             else:
-                msg = f"✅ 点击成功: ({x}, {y}) [相对位置: {x_percent}%, {y_percent}%]"
-            
-            # 如果检测到应用跳转，添加警告和返回结果
-            if app_check['switched']:
-                msg += f"\n{app_check['message']}"
-                if return_result:
-                    if return_result['success']:
-                        msg += f"\n{return_result['message']}"
-                    else:
-                        msg += f"\n❌ 自动返回失败: {return_result['message']}"
-            
-            return {
-                "success": True,
-                "message": msg,
-                "app_check": app_check,
-                "return_to_app": return_result
-            }
+                return {
+                    "success": True,
+                    "message": f"✅ 点击成功: ({x}, {y}) [相对位置: {x_percent}%, {y_percent}%]"
+                }
         except Exception as e:
             return {"success": False, "message": f"❌ 点击失败: {e}"}
     
@@ -1256,9 +1114,9 @@ class BasicMobileToolsLite:
             return {"success": False, "message": f"❌ 点击失败: {e}"}
     
     def _find_element_in_tree(self, text: str) -> Optional[Dict]:
-        """在 XML 树中查找包含指定文本的元素"""
+        """在 XML 树中查找包含指定文本的元素（使用完整 UI 层级）"""
         try:
-            xml = self.client.u2.dump_hierarchy(compressed=False)
+            xml = self._get_full_hierarchy()
             import xml.etree.ElementTree as ET
             root = ET.fromstring(xml)
             
@@ -1652,28 +1510,7 @@ class BasicMobileToolsLite:
                         elem.set_text(text)
                         time.sleep(0.3)
                         self._record_operation('input', element=resource_id, ref=resource_id, text=text)
-                        
-                        # 🎯 关键步骤：检查应用是否跳转，如果跳转则自动返回目标应用
-                        app_check = self._check_app_switched()
-                        return_result = None
-                        if app_check['switched']:
-                            return_result = self._return_to_target_app()
-                        
-                        msg = f"✅ 输入成功: '{text}'"
-                        if app_check['switched']:
-                            msg += f"\n{app_check['message']}"
-                            if return_result:
-                                if return_result['success']:
-                                    msg += f"\n{return_result['message']}"
-                                else:
-                                    msg += f"\n❌ 自动返回失败: {return_result['message']}"
-                        
-                        return {
-                            "success": True,
-                            "message": msg,
-                            "app_check": app_check,
-                            "return_to_app": return_result
-                        }
+                        return {"success": True, "message": f"✅ 输入成功: '{text}'"}
                     return {"success": False, "message": f"❌ 输入框不存在: {resource_id}"}
             else:
                 elements = self.client.u2(resourceId=resource_id)
@@ -1687,28 +1524,7 @@ class BasicMobileToolsLite:
                         elements.set_text(text)
                         time.sleep(0.3)
                         self._record_operation('input', element=resource_id, ref=resource_id, text=text)
-                        
-                        # 🎯 关键步骤：检查应用是否跳转，如果跳转则自动返回目标应用
-                        app_check = self._check_app_switched()
-                        return_result = None
-                        if app_check['switched']:
-                            return_result = self._return_to_target_app()
-                        
-                        msg = f"✅ 输入成功: '{text}'"
-                        if app_check['switched']:
-                            msg += f"\n{app_check['message']}"
-                            if return_result:
-                                if return_result['success']:
-                                    msg += f"\n{return_result['message']}"
-                                else:
-                                    msg += f"\n❌ 自动返回失败: {return_result['message']}"
-                        
-                        return {
-                            "success": True,
-                            "message": msg,
-                            "app_check": app_check,
-                            "return_to_app": return_result
-                        }
+                        return {"success": True, "message": f"✅ 输入成功: '{text}'"}
                     
                     # 多个相同 ID（<=5个），尝试智能选择
                     if count <= 5:
@@ -1721,56 +1537,14 @@ class BasicMobileToolsLite:
                                     elem.set_text(text)
                                     time.sleep(0.3)
                                     self._record_operation('input', element=resource_id, ref=resource_id, text=text)
-                                    
-                                    # 🎯 关键步骤：检查应用是否跳转，如果跳转则自动返回目标应用
-                                    app_check = self._check_app_switched()
-                                    return_result = None
-                                    if app_check['switched']:
-                                        return_result = self._return_to_target_app()
-                                    
-                                    msg = f"✅ 输入成功: '{text}'"
-                                    if app_check['switched']:
-                                        msg += f"\n{app_check['message']}"
-                                        if return_result:
-                                            if return_result['success']:
-                                                msg += f"\n{return_result['message']}"
-                                            else:
-                                                msg += f"\n❌ 自动返回失败: {return_result['message']}"
-                                    
-                                    return {
-                                        "success": True,
-                                        "message": msg,
-                                        "app_check": app_check,
-                                        "return_to_app": return_result
-                                    }
+                                    return {"success": True, "message": f"✅ 输入成功: '{text}'"}
                             except:
                                 continue
                         # 没找到可编辑的，用第一个
                         elements[0].set_text(text)
                         time.sleep(0.3)
                         self._record_operation('input', element=resource_id, ref=resource_id, text=text)
-                        
-                        # 🎯 关键步骤：检查应用是否跳转，如果跳转则自动返回目标应用
-                        app_check = self._check_app_switched()
-                        return_result = None
-                        if app_check['switched']:
-                            return_result = self._return_to_target_app()
-                        
-                        msg = f"✅ 输入成功: '{text}'"
-                        if app_check['switched']:
-                            msg += f"\n{app_check['message']}"
-                            if return_result:
-                                if return_result['success']:
-                                    msg += f"\n{return_result['message']}"
-                                else:
-                                    msg += f"\n❌ 自动返回失败: {return_result['message']}"
-                        
-                        return {
-                            "success": True,
-                            "message": msg,
-                            "app_check": app_check,
-                            "return_to_app": return_result
-                        }
+                        return {"success": True, "message": f"✅ 输入成功: '{text}'"}
                 
                 # ID 不可靠（不存在或太多），改用 EditText 类型定位
                 edit_texts = self.client.u2(className='android.widget.EditText')
@@ -1780,28 +1554,7 @@ class BasicMobileToolsLite:
                         edit_texts.set_text(text)
                         time.sleep(0.3)
                         self._record_operation('input', element='EditText', ref='EditText', text=text)
-                        
-                        # 🎯 关键步骤：检查应用是否跳转，如果跳转则自动返回目标应用
-                        app_check = self._check_app_switched()
-                        return_result = None
-                        if app_check['switched']:
-                            return_result = self._return_to_target_app()
-                        
-                        msg = f"✅ 输入成功: '{text}' (通过 EditText 定位)"
-                        if app_check['switched']:
-                            msg += f"\n{app_check['message']}"
-                            if return_result:
-                                if return_result['success']:
-                                    msg += f"\n{return_result['message']}"
-                                else:
-                                    msg += f"\n❌ 自动返回失败: {return_result['message']}"
-                        
-                        return {
-                            "success": True,
-                            "message": msg,
-                            "app_check": app_check,
-                            "return_to_app": return_result
-                        }
+                        return {"success": True, "message": f"✅ 输入成功: '{text}' (通过 EditText 定位)"}
                     
                     # 多个 EditText，选择最靠上的
                     best_elem = None
@@ -1820,28 +1573,7 @@ class BasicMobileToolsLite:
                         best_elem.set_text(text)
                         time.sleep(0.3)
                         self._record_operation('input', element='EditText', ref='EditText', text=text)
-                        
-                        # 🎯 关键步骤：检查应用是否跳转，如果跳转则自动返回目标应用
-                        app_check = self._check_app_switched()
-                        return_result = None
-                        if app_check['switched']:
-                            return_result = self._return_to_target_app()
-                        
-                        msg = f"✅ 输入成功: '{text}' (通过 EditText 定位，选择最顶部的)"
-                        if app_check['switched']:
-                            msg += f"\n{app_check['message']}"
-                            if return_result:
-                                if return_result['success']:
-                                    msg += f"\n{return_result['message']}"
-                                else:
-                                    msg += f"\n❌ 自动返回失败: {return_result['message']}"
-                        
-                        return {
-                            "success": True,
-                            "message": msg,
-                            "app_check": app_check,
-                            "return_to_app": return_result
-                        }
+                        return {"success": True, "message": f"✅ 输入成功: '{text}' (通过 EditText 定位，选择最顶部的)"}
                 
                 return {"success": False, "message": f"❌ 输入框不存在: {resource_id}"}
                     
@@ -1893,29 +1625,7 @@ class BasicMobileToolsLite:
                 text=text
             )
             
-            # 🎯 关键步骤：检查应用是否跳转，如果跳转则自动返回目标应用
-            app_check = self._check_app_switched()
-            return_result = None
-            
-            if app_check['switched']:
-                # 应用已跳转，尝试返回目标应用
-                return_result = self._return_to_target_app()
-            
-            msg = f"✅ 输入成功: ({x}, {y}) [相对位置: {x_percent}%, {y_percent}%] -> '{text}'"
-            if app_check['switched']:
-                msg += f"\n{app_check['message']}"
-                if return_result:
-                    if return_result['success']:
-                        msg += f"\n{return_result['message']}"
-                    else:
-                        msg += f"\n❌ 自动返回失败: {return_result['message']}"
-            
-            return {
-                "success": True,
-                "message": msg,
-                "app_check": app_check,
-                "return_to_app": return_result
-            }
+            return {"success": True, "message": f"✅ 输入成功: ({x}, {y}) [相对位置: {x_percent}%, {y_percent}%] -> '{text}'"}
         except Exception as e:
             return {"success": False, "message": f"❌ 输入失败: {e}"}
     
@@ -1982,14 +1692,6 @@ class BasicMobileToolsLite:
                 record_info['y_percent'] = y_percent
             self._record_operation('swipe', **record_info)
             
-            # 🎯 关键步骤：检查应用是否跳转，如果跳转则自动返回目标应用
-            app_check = self._check_app_switched()
-            return_result = None
-            
-            if app_check['switched']:
-                # 应用已跳转，尝试返回目标应用
-                return_result = self._return_to_target_app()
-            
             # 构建返回消息
             msg = f"✅ 滑动成功: {direction}"
             if direction in ['left', 'right']:
@@ -1998,21 +1700,7 @@ class BasicMobileToolsLite:
                 elif y is not None:
                     msg += f" (高度: {y}px)"
             
-            # 如果检测到应用跳转，添加警告和返回结果
-            if app_check['switched']:
-                msg += f"\n{app_check['message']}"
-                if return_result:
-                    if return_result['success']:
-                        msg += f"\n{return_result['message']}"
-                    else:
-                        msg += f"\n❌ 自动返回失败: {return_result['message']}"
-            
-            return {
-                "success": True,
-                "message": msg,
-                "app_check": app_check,
-                "return_to_app": return_result
-            }
+            return {"success": True, "message": msg}
         except Exception as e:
             return {"success": False, "message": f"❌ 滑动失败: {e}"}
     
@@ -2068,22 +1756,11 @@ class BasicMobileToolsLite:
             
             await asyncio.sleep(2)
             
-            # 记录目标应用包名（用于后续监测应用跳转）
-            self.target_package = package_name
-            
-            # 验证是否成功启动到目标应用
-            current = self._get_current_package()
-            if current and current != package_name:
-                return {
-                    "success": False,
-                    "message": f"❌ 启动失败：当前应用为 {current}，期望 {package_name}"
-                }
-            
             self._record_operation('launch_app', package_name=package_name)
             
             return {
                 "success": True,
-                "message": f"✅ 已启动: {package_name}\n💡 建议等待 2-3 秒让页面加载\n📱 已设置应用状态监测"
+                "message": f"✅ 已启动: {package_name}\n💡 建议等待 2-3 秒让页面加载"
             }
         except Exception as e:
             return {"success": False, "message": f"❌ 启动失败: {e}"}
@@ -2181,15 +1858,12 @@ class BasicMobileToolsLite:
                     return ios_client.list_elements()
                 return [{"error": "iOS 暂不支持元素列表，建议使用截图"}]
             else:
-                xml_string = self.client.u2.dump_hierarchy(compressed=False)
+                xml_string = self._get_full_hierarchy()
                 elements = self.client.xml_parser.parse(xml_string)
                 
                 result = []
                 for elem in elements:
-                    # 获取文本内容（去除首尾空格）
-                    text = elem.get('text', '').strip()
-                    # 保留：可点击、可focus或有文本的元素
-                    if elem.get('clickable') or elem.get('focusable') or text:
+                    if elem.get('clickable') or elem.get('focusable'):
                         result.append({
                             'resource_id': elem.get('resource_id', ''),
                             'text': elem.get('text', ''),
@@ -2220,8 +1894,8 @@ class BasicMobileToolsLite:
             screen_width = self.client.u2.info.get('displayWidth', 720)
             screen_height = self.client.u2.info.get('displayHeight', 1280)
             
-            # 获取元素列表
-            xml_string = self.client.u2.dump_hierarchy(compressed=False)
+            # 获取元素列表（使用完整 UI 层级）
+            xml_string = self._get_full_hierarchy()
             import xml.etree.ElementTree as ET
             root = ET.fromstring(xml_string)
             
@@ -2232,6 +1906,7 @@ class BasicMobileToolsLite:
             for elem in root.iter():
                 text = elem.attrib.get('text', '')
                 content_desc = elem.attrib.get('content-desc', '')
+                resource_id = elem.attrib.get('resource-id', '')
                 bounds_str = elem.attrib.get('bounds', '')
                 class_name = elem.attrib.get('class', '')
                 clickable = elem.attrib.get('clickable', 'false') == 'true'
@@ -2266,6 +1941,13 @@ class BasicMobileToolsLite:
                     score = 90
                     reason = f"描述='{content_desc}'"
                 
+                # 策略2.5：resource-id 包含关闭关键词（如 close_icon, ad_close 等）
+                elif resource_id and any(kw in resource_id.lower() for kw in ['close', 'dismiss', 'skip', 'cancel']):
+                    score = 95
+                    # 提取简短的 id 名
+                    short_id = resource_id.split('/')[-1] if '/' in resource_id else resource_id
+                    reason = f"resource-id='{short_id}'"
+                
                 # 策略3：小尺寸的 clickable 元素（可能是 X 图标）
                 elif clickable:
                     min_size = max(20, int(screen_width * 0.03))
@@ -2300,7 +1982,9 @@ class BasicMobileToolsLite:
                         'center_y': center_y,
                         'x_percent': x_percent,
                         'y_percent': y_percent,
-                        'size': f"{width}x{height}"
+                        'size': f"{width}x{height}",
+                        'resource_id': resource_id,
+                        'text': text
                     })
             
             if not candidates:
@@ -2326,7 +2010,16 @@ class BasicMobileToolsLite:
             candidates.sort(key=lambda x: x['score'], reverse=True)
             best = candidates[0]
             
-            return {
+            # 生成推荐的点击命令（优先使用 resource-id）
+            if best.get('resource_id'):
+                short_id = best['resource_id'].split('/')[-1] if '/' in best['resource_id'] else best['resource_id']
+                click_cmd = f"mobile_click_by_id('{best['resource_id']}')"
+            elif best.get('text') and best['text'] in ['×', 'X', 'x', '关闭', '取消', '跳过', '知道了']:
+                click_cmd = f"mobile_click_by_text('{best['text']}')"
+            else:
+                click_cmd = f"mobile_click_by_percent({best['x_percent']}, {best['y_percent']})"
+            
+            result = {
                 "success": True,
                 "message": f"✅ 找到可能的关闭按钮",
                 "best_candidate": {
@@ -2337,7 +2030,7 @@ class BasicMobileToolsLite:
                     "size": best['size'],
                     "score": best['score']
                 },
-                "click_command": f"mobile_click_by_percent({best['x_percent']}, {best['y_percent']})",
+                "click_command": click_cmd,
                 "other_candidates": [
                     {"reason": c['reason'], "percent": f"({c['x_percent']}%, {c['y_percent']}%)", "score": c['score']}
                     for c in candidates[1:4]
@@ -2345,6 +2038,14 @@ class BasicMobileToolsLite:
                 "screen_size": {"width": screen_width, "height": screen_height}
             }
             
+            # 如果有 resource-id，额外提供
+            if best.get('resource_id'):
+                result["best_candidate"]["resource_id"] = best['resource_id']
+            if best.get('text'):
+                result["best_candidate"]["text"] = best['text']
+            
+            return result
+            
         except Exception as e:
             return {"success": False, "message": f"❌ 查找关闭按钮失败: {e}"}
     
@@ -2374,8 +2075,8 @@ class BasicMobileToolsLite:
             screen_width = self.client.u2.info.get('displayWidth', 720)
             screen_height = self.client.u2.info.get('displayHeight', 1280)
             
-            # 获取原始 XML
-            xml_string = self.client.u2.dump_hierarchy(compressed=False)
+            # 获取原始 XML（使用完整 UI 层级）
+            xml_string = self._get_full_hierarchy()
             
             # 关闭按钮的文本特征
             close_texts = ['×', 'X', 'x', '关闭', '取消', 'close', 'Close', 'CLOSE', '跳过', '知道了']
@@ -2604,33 +2305,13 @@ class BasicMobileToolsLite:
                             self.client.u2.click(try_x, try_y)
                             time.sleep(0.3)
                     
-                    # 🎯 关键步骤：检查应用是否跳转，如果跳转说明弹窗去除失败，需要返回目标应用
-                    app_check = self._check_app_switched()
-                    return_result = None
-                    
-                    if app_check['switched']:
-                        # 应用已跳转，说明弹窗去除失败，尝试返回目标应用
-                        return_result = self._return_to_target_app()
-                    
                     # 尝试后截图，让 AI 判断是否成功
                     screenshot_result = self.take_screenshot("尝试关闭后")
-                    
-                    msg = f"✅ 已尝试点击常见关闭按钮位置"
-                    if app_check['switched']:
-                        msg += f"\n⚠️ 应用已跳转，说明弹窗去除失败"
-                        if return_result:
-                            if return_result['success']:
-                                msg += f"\n{return_result['message']}"
-                            else:
-                                msg += f"\n❌ 自动返回失败: {return_result['message']}"
-                    
                     return {
                         "success": True,
-                        "message": msg,
+                        "message": f"✅ 已尝试点击常见关闭按钮位置",
                         "tried_positions": [p[2] for p in try_positions],
                         "screenshot": screenshot_result.get("screenshot_path", ""),
-                        "app_check": app_check,
-                        "return_to_app": return_result,
                         "tip": "请查看截图确认弹窗是否已关闭。如果还在，可手动分析截图找到关闭按钮位置。"
                     }
                 
@@ -2663,14 +2344,6 @@ class BasicMobileToolsLite:
             self.client.u2.click(best['center_x'], best['center_y'])
             time.sleep(0.5)
             
-            # 🎯 关键步骤：检查应用是否跳转，如果跳转说明弹窗去除失败，需要返回目标应用
-            app_check = self._check_app_switched()
-            return_result = None
-            
-            if app_check['switched']:
-                # 应用已跳转，说明弹窗去除失败，尝试返回目标应用
-                return_result = self._return_to_target_app()
-            
             # 点击后截图，让 AI 判断是否成功
             screenshot_result = self.take_screenshot("关闭弹窗后")
             
@@ -2686,21 +2359,11 @@ class BasicMobileToolsLite:
                 ref=f"close_popup_{best['position']}"
             )
             
-            # 构建返回消息
-            msg = f"✅ 已点击关闭按钮 ({best['position']}): ({best['center_x']}, {best['center_y']})"
-            if app_check['switched']:
-                msg += f"\n⚠️ 应用已跳转，说明弹窗去除失败"
-                if return_result:
-                    if return_result['success']:
-                        msg += f"\n{return_result['message']}"
-                    else:
-                        msg += f"\n❌ 自动返回失败: {return_result['message']}"
-            
             # 返回候选按钮列表，让 AI 看截图判断
             # 如果弹窗还在，AI 可以选择点击其他候选按钮
             return {
                 "success": True,
-                "message": msg,
+                "message": f"✅ 已点击关闭按钮 ({best['position']}): ({best['center_x']}, {best['center_y']})",
                 "clicked": {
                     "position": best['position'],
                     "match_type": best['match_type'],
@@ -2710,8 +2373,6 @@ class BasicMobileToolsLite:
                 "screenshot": screenshot_result.get("screenshot_path", ""),
                 "popup_detected": popup_bounds is not None,
                 "popup_bounds": f"[{popup_bounds[0]},{popup_bounds[1]}][{popup_bounds[2]},{popup_bounds[3]}]" if popup_bounds else None,
-                "app_check": app_check,
-                "return_to_app": return_result,
                 "other_candidates": [
                     {
                         "position": c['position'], 
@@ -2721,7 +2382,7 @@ class BasicMobileToolsLite:
                     }
                     for c in close_candidates[1:4]  # 返回其他3个候选，AI 可以选择
                 ],
-                "tip": "请查看截图判断弹窗是否已关闭。如果弹窗还在，可以尝试点击 other_candidates 中的其他位置"
+                "tip": "请查看截图判断弹窗是否已关闭。如果弹窗还在，可以尝试点击 other_candidates 中的其他位置；如果误点跳转了，请按返回键"
             }
             
         except Exception as e:
@@ -3286,8 +2947,8 @@ class BasicMobileToolsLite:
         try:
             import xml.etree.ElementTree as ET
             
-            # ========== 第1步：控件树查找关闭按钮 ==========
-            xml_string = self.client.u2.dump_hierarchy(compressed=False)
+            # ========== 第1步：控件树查找关闭按钮（使用完整 UI 层级）==========
+            xml_string = self._get_full_hierarchy()
             root = ET.fromstring(xml_string)
             
             # 关闭按钮的常见特征
@@ -3325,6 +2986,16 @@ class BasicMobileToolsLite:
                         reason = f"文本含'{kw}'"
                         break
                 
+                # resource-id 匹配（如 close_icon, ad_close 等）
+                if resource_id:
+                    res_id_lower = resource_id.lower()
+                    for kw in ['close', 'dismiss', 'skip', 'cancel']:
+                        if kw in res_id_lower:
+                            score += 9
+                            short_id = resource_id.split('/')[-1] if '/' in resource_id else resource_id
+                            reason = f"resource-id='{short_id}'"
+                            break
+                
                 # content-desc 匹配
                 for kw in close_content_desc:
                     if kw.lower() in content_desc.lower():
@@ -3374,35 +3045,15 @@ class BasicMobileToolsLite:
                     pre_result = self.take_screenshot(description="关闭前", compress=False)
                     pre_screenshot = pre_result.get("screenshot_path")
                 
-                # 点击（click_at_coords 内部已包含应用状态检查和自动返回）
-                click_result = self.click_at_coords(cx, cy)
+                # 点击
+                self.click_at_coords(cx, cy)
                 time.sleep(0.5)
                 
-                # 🎯 再次检查应用状态（确保弹窗去除没有导致应用跳转）
-                app_check = self._check_app_switched()
-                return_result = None
-                
-                if app_check['switched']:
-                    # 应用已跳转，说明弹窗去除失败，尝试返回目标应用
-                    return_result = self._return_to_target_app()
-                
                 result["success"] = True
                 result["method"] = "控件树"
-                msg = f"✅ 通过控件树找到关闭按钮并点击\n" \
-                      f"   位置: ({cx}, {cy})\n" \
-                      f"   原因: {best['reason']}"
-                
-                if app_check['switched']:
-                    msg += f"\n⚠️ 应用已跳转，说明弹窗去除失败"
-                    if return_result:
-                        if return_result['success']:
-                            msg += f"\n{return_result['message']}"
-                        else:
-                            msg += f"\n❌ 自动返回失败: {return_result['message']}"
-                
-                result["message"] = msg
-                result["app_check"] = app_check
-                result["return_to_app"] = return_result
+                result["message"] = f"✅ 通过控件树找到关闭按钮并点击\n" \
+                                   f"   位置: ({cx}, {cy})\n" \
+                                   f"   原因: {best['reason']}"
                 
                 # 自动学习：检查这个 X 是否已在模板库，不在就添加
                 if auto_learn and pre_screenshot:
@@ -3432,36 +3083,16 @@ class BasicMobileToolsLite:
                         x_pct = best["percent"]["x"]
                         y_pct = best["percent"]["y"]
                         
-                        # 点击（click_by_percent 内部已包含应用状态检查和自动返回）
-                        click_result = self.click_by_percent(x_pct, y_pct)
+                        # 点击
+                        self.click_by_percent(x_pct, y_pct)
                         time.sleep(0.5)
                         
-                        # 🎯 再次检查应用状态（确保弹窗去除没有导致应用跳转）
-                        app_check = self._check_app_switched()
-                        return_result = None
-                        
-                        if app_check['switched']:
-                            # 应用已跳转，说明弹窗去除失败，尝试返回目标应用
-                            return_result = self._return_to_target_app()
-                        
                         result["success"] = True
                         result["method"] = "模板匹配"
-                        msg = f"✅ 通过模板匹配找到关闭按钮并点击\n" \
-                              f"   模板: {best.get('template', 'unknown')}\n" \
-                              f"   置信度: {best.get('confidence', 'N/A')}%\n" \
-                              f"   位置: ({x_pct:.1f}%, {y_pct:.1f}%)"
-                        
-                        if app_check['switched']:
-                            msg += f"\n⚠️ 应用已跳转，说明弹窗去除失败"
-                            if return_result:
-                                if return_result['success']:
-                                    msg += f"\n{return_result['message']}"
-                                else:
-                                    msg += f"\n❌ 自动返回失败: {return_result['message']}"
-                        
-                        result["message"] = msg
-                        result["app_check"] = app_check
-                        result["return_to_app"] = return_result
+                        result["message"] = f"✅ 通过模板匹配找到关闭按钮并点击\n" \
+                                           f"   模板: {best.get('template', 'unknown')}\n" \
+                                           f"   置信度: {best.get('confidence', 'N/A')}%\n" \
+                                           f"   位置: ({x_pct:.1f}%, {y_pct:.1f}%)"
                         return result
                     
             except ImportError:

mobile_mcp/mcp_tools/mcp_server.py

@@ -610,22 +610,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_id，其次 click_by_text，最后 click_by_percent）
 
 💡 使用流程：
-1. 调用此工具找到关闭按钮位置
-2. 确认位置正确后，用 mobile_click_by_percent 点击
-3. 百分比点击兼容不同分辨率手机""",
+1. 直接调用此工具（无需先截图/列元素）
+2. 根据返回的 click_command 执行点击
+3. 如果返回 success=false，才需要截图分析""",
             inputSchema={"type": "object", "properties": {}, "required": []}
         ))
         
@@ -711,24 +714,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",

{mobile_mcp_ai-2.5.10.dist-info → mobile_mcp_ai-2.5.11.dist-info}/METADATA

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

{mobile_mcp_ai-2.5.10.dist-info → mobile_mcp_ai-2.5.11.dist-info}/RECORD

@@ -1,7 +1,7 @@
 mobile_mcp/__init__.py,sha256=sQJZTL_sxQFzmcS7jOtS2AHCfUySz40vhX96N6u1qy4,816
 mobile_mcp/config.py,sha256=yaFLAV4bc2wX0GQPtZDo7OYF9E88tXV-av41fQsJwK4,4480
 mobile_mcp/core/__init__.py,sha256=ndMy-cLAIsQDG5op7gM_AIplycqZSZPWEkec1pEhvEY,170
-mobile_mcp/core/basic_tools_lite.py,sha256=YwOSRYRyYo0etA_4XbeDLGIlMNIquWAWOC8ROcPog4E,173551
+mobile_mcp/core/basic_tools_lite.py,sha256=kVmfiaNyO33SFf9ijvK9tO4ltPOI4A8D1ANho6DqNNI,156767
 mobile_mcp/core/device_manager.py,sha256=xG5DoeNFs45pl-FTEhEWblqVwxtFK-FmVEGlNL6EqRI,8798
 mobile_mcp/core/dynamic_config.py,sha256=Ja1n1pfb0HspGByqk2_A472mYVniKmGtNEWyjUjmgK8,9811
 mobile_mcp/core/ios_client_wda.py,sha256=Nq9WxevhTWpVpolM-Ymp-b0nUQV3tXLFszmJHbDC4wA,18770
@@ -19,14 +19,14 @@ mobile_mcp/core/utils/logger.py,sha256=XXQAHUwT1jc70pq_tYFmL6f_nKrFlYm3hcgl-5RYR
 mobile_mcp/core/utils/operation_history_manager.py,sha256=gi8S8HJAMqvkUrY7_-kVbko3Xt7c4GAUziEujRd-N-Y,4792
 mobile_mcp/core/utils/smart_wait.py,sha256=N5wKTUYrNWPruBILqrAjpvtso8Z3GRWCfMIR_aZxPLg,8649
 mobile_mcp/mcp_tools/__init__.py,sha256=xkro8Rwqv_55YlVyhh-3DgRFSsLE3h1r31VIb3bpM6E,143
-mobile_mcp/mcp_tools/mcp_server.py,sha256=fr42BjulYQCBreWoLx5lkWEZjT60Df6RCo_kyXMOHfI,49868
+mobile_mcp/mcp_tools/mcp_server.py,sha256=T6H3jAEfxQzGeQgiTg9ROn2GpgonARrrlFWrzVfxmKU,50135
 mobile_mcp/utils/__init__.py,sha256=8EH0i7UGtx1y_j_GEgdN-cZdWn2sRtZSEOLlNF9HRnY,158
 mobile_mcp/utils/logger.py,sha256=Sqq2Nr0Y4p03erqcrbYKVPCGiFaNGHMcE_JwCkeOfU4,3626
 mobile_mcp/utils/xml_formatter.py,sha256=uwTRb3vLbqhT8O-udzWT7s7LsV-DyDUz2DkofD3hXOE,4556
 mobile_mcp/utils/xml_parser.py,sha256=QhL8CWbdmNDzmBLjtx6mEnjHgMFZzJeHpCL15qfXSpI,3926
-mobile_mcp_ai-2.5.10.dist-info/licenses/LICENSE,sha256=HrhfyXIkWY2tGFK11kg7vPCqhgh5DcxleloqdhrpyMY,11558
-mobile_mcp_ai-2.5.10.dist-info/METADATA,sha256=NsXkw6Ys3YGOXDt7qA82-F9EOuYQDtawMFvzclzDpVk,10496
-mobile_mcp_ai-2.5.10.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-mobile_mcp_ai-2.5.10.dist-info/entry_points.txt,sha256=KB_FglozgPHBprSM1vFbIzGyheFuHFmGanscRdMJ_8A,68
-mobile_mcp_ai-2.5.10.dist-info/top_level.txt,sha256=lLm6YpbTv855Lbh8BIA0rPxhybIrvYUzMEk9OErHT94,11
-mobile_mcp_ai-2.5.10.dist-info/RECORD,,
+mobile_mcp_ai-2.5.11.dist-info/licenses/LICENSE,sha256=HrhfyXIkWY2tGFK11kg7vPCqhgh5DcxleloqdhrpyMY,11558
+mobile_mcp_ai-2.5.11.dist-info/METADATA,sha256=0iJCScP_ZkC5ZBZFTJ7ZPJJr4N0h9gwuTanhc81CIkM,10496
+mobile_mcp_ai-2.5.11.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+mobile_mcp_ai-2.5.11.dist-info/entry_points.txt,sha256=KB_FglozgPHBprSM1vFbIzGyheFuHFmGanscRdMJ_8A,68
+mobile_mcp_ai-2.5.11.dist-info/top_level.txt,sha256=lLm6YpbTv855Lbh8BIA0rPxhybIrvYUzMEk9OErHT94,11
+mobile_mcp_ai-2.5.11.dist-info/RECORD,,