mobile-mcp-ai 2.6.12__py3-none-any.whl → 2.7.0__py3-none-any.whl

mobile_mcp/core/basic_tools_lite.py

@@ -2197,6 +2197,13 @@ class BasicMobileToolsLite:
     def wait(self, seconds: float) -> Dict:
         """等待指定时间"""
         time.sleep(seconds)
+        # 记录等待操作
+        record = {
+            'action': 'wait',
+            'timestamp': datetime.now().isoformat(),
+            'seconds': seconds,
+        }
+        self.operation_history.append(record)
         return {"success": True}
     
     # ==================== 应用管理 ====================
@@ -2353,6 +2360,15 @@ class BasicMobileToolsLite:
                     '_shadow', 'shadow_', '_divider', 'divider_', '_line', 'line_'
                 }
                 
+                # 状态栏相关关键词（这些元素对测试没有意义，直接过滤）
+                STATUS_BAR_KEYWORDS = {
+                    'status_bar', 'statusbar', 'notification_icon', 'notificationicons',
+                    'system_icons', 'statusicons', 'battery', 'wifi_', 'wifi_combo',
+                    'wifi_group', 'wifi_signal', 'wifi_in', 'wifi_out', 'signal_',
+                    'clock', 'cutout', 'networkspeed', 'speed_container',
+                    'carrier', 'operator', 'sim_', 'mobile_signal'
+                }
+                
                 # Token 优化：构建精简元素（只返回非空字段）
                 def build_compact_element(resource_id, text, content_desc, bounds, likely_click, class_name):
                     """只返回有值的字段，节省 token"""
@@ -2390,6 +2406,12 @@ class BasicMobileToolsLite:
                     if bounds == '[0,0][0,0]':
                         continue
                     
+                    # 1.5 过滤状态栏元素（对测试没有意义）
+                    if resource_id:
+                        resource_id_lower = resource_id.lower()
+                        if any(keyword in resource_id_lower for keyword in STATUS_BAR_KEYWORDS):
+                            continue
+                    
                     # 2. 检查是否是功能控件（直接保留）
                     if class_name in FUNCTIONAL_WIDGETS:
                         # 使用启发式判断可点击性（替代不准确的 clickable 属性）
@@ -3379,6 +3401,15 @@ class BasicMobileToolsLite:
         
         # 生成脚本
         safe_name = re.sub(r'[^\w\s-]', '', test_name).strip().replace(' ', '_')
+        # 确保 safe_name 不为空，否则使用默认名称
+        if not safe_name:
+            safe_name = 'generated_case'
+        
+        # 提前处理文件名，确保文档字符串中的文件名正确
+        if not filename.endswith('.py'):
+            filename = f"{filename}.py"
+        if not filename.startswith('test_'):
+            filename = f"test_{filename}"
         
         script_lines = [
             "#!/usr/bin/env python3",
@@ -3393,8 +3424,8 @@ class BasicMobileToolsLite:
             "3. 百分比定位 - 跨分辨率兼容（坐标自动转换）",
             "",
             "运行方式：",
-            "  pytest {filename} -v        # 使用 pytest 运行",
-            "  python {filename}           # 直接运行",
+            f"  pytest {filename} -v        # 使用 pytest 运行",
+            f"  python {filename}           # 直接运行",
             f'"""',
             "import time",
             "import pytest",
@@ -3655,6 +3686,12 @@ class BasicMobileToolsLite:
                 script_lines.append(f"    d.press('{key}')")
                 script_lines.append("    time.sleep(0.5)")
                 script_lines.append("    ")
+            
+            elif action == 'wait':
+                seconds = op.get('seconds', 1)
+                script_lines.append(f"    # 步骤{step_num}: 等待 {seconds} 秒")
+                script_lines.append(f"    time.sleep({seconds})")
+                script_lines.append("    ")
         
         script_lines.extend([
             "    print('✅ 测试完成')",
@@ -3678,12 +3715,6 @@ class BasicMobileToolsLite:
         output_dir = Path("tests")
         output_dir.mkdir(exist_ok=True)
         
-        # 确保文件名符合 pytest 规范（以 test_ 开头）
-        if not filename.endswith('.py'):
-            filename = f"{filename}.py"
-        if not filename.startswith('test_'):
-            filename = f"test_{filename}"
-        
         file_path = output_dir / filename
         file_path.write_text(script, encoding='utf-8')
         

mobile_mcp/mcp_tools/mcp_server.py

@@ -204,6 +204,115 @@ class MobileMCPServer:
         
         return "android"
     
+    def _open_new_chat(self, message: str = "继续执行飞书用例", delay: float = 5) -> dict:
+        """
+        打开新Chat窗口并发送消息
+        
+        原理：用后台线程延迟执行键盘操作，避免打断当前AI响应
+        跨平台统一用 pyautogui + pyperclip，配合系统API激活窗口
+        """
+        import threading
+        import platform
+        
+        def delayed_action():
+            import time
+            time.sleep(delay)  # 等待当前响应结束
+            
+            try:
+                system = platform.system()
+                
+                if system == "Darwin":  # ========== macOS: 纯 AppleScript（无需额外安装）==========
+                    import subprocess
+                    
+                    # AppleScript: 激活Cursor → Cmd+L聚焦Chat → Cmd+N新建 → 粘贴 → 回车
+                    script = f'''
+                    -- 设置剪贴板（支持中文）
+                    set the clipboard to "{message}"
+                    
+                    -- 激活 Cursor
+                    tell application "Cursor" to activate
+                    delay 0.5
+                    
+                    tell application "System Events"
+                        tell process "Cursor"
+                            -- Cmd+L 聚焦 Chat
+                            keystroke "l" using command down
+                            delay 0.5
+                            -- Cmd+N 新建对话
+                            keystroke "n" using command down
+                            delay 1
+                            -- Cmd+V 粘贴
+                            keystroke "v" using command down
+                            delay 0.3
+                            -- Enter 发送
+                            key code 36
+                        end tell
+                    end tell
+                    '''
+                    result = subprocess.run(['osascript', '-e', script], capture_output=True, text=True)
+                    if result.returncode == 0:
+                        print(f"[open_new_chat] macOS成功: {message}", file=sys.stderr)
+                    else:
+                        print(f"[open_new_chat] AppleScript错误: {result.stderr}", file=sys.stderr)
+                    
+                elif system == "Windows":  # ========== Windows: 需要 pip install pyautogui pyperclip ==========
+                    import pyautogui
+                    import pyperclip
+                    
+                    # 尝试激活 Cursor 窗口
+                    try:
+                        import pygetwindow as gw
+                        windows = gw.getWindowsWithTitle('Cursor')
+                        if windows:
+                            windows[0].activate()
+                            time.sleep(0.5)
+                    except ImportError:
+                        pass
+                    
+                    pyautogui.PAUSE = 0.3
+                    
+                    # Ctrl+L 聚焦 Chat → Ctrl+N 新建
+                    pyautogui.hotkey('ctrl', 'l')
+                    time.sleep(0.5)
+                    pyautogui.hotkey('ctrl', 'n')
+                    time.sleep(1)
+                    
+                    # 粘贴消息
+                    pyperclip.copy(message)
+                    pyautogui.hotkey('ctrl', 'v')
+                    time.sleep(0.3)
+                    pyautogui.press('enter')
+                    
+                    print(f"[open_new_chat] Windows成功: {message}", file=sys.stderr)
+                    
+                else:  # Linux: 写信号文件
+                    from pathlib import Path
+                    signal_file = Path(__file__).parent.parent / ".new_chat_signal"
+                    signal_file.write_text(message)
+                    print(f"[open_new_chat] Linux: 已写入信号文件", file=sys.stderr)
+                    
+            except ImportError as e:
+                # Windows 缺少依赖时写信号文件
+                from pathlib import Path
+                signal_file = Path(__file__).parent.parent / ".new_chat_signal"
+                signal_file.write_text(message)
+                print(f"[open_new_chat] Windows缺少依赖，请运行: pip install pyautogui pyperclip", file=sys.stderr)
+                    
+            except Exception as e:
+                # 写错误日志
+                import sys
+                print(f"[open_new_chat] 错误: {e}", file=sys.stderr)
+        
+        # 后台线程执行，不阻塞MCP响应
+        thread = threading.Thread(target=delayed_action, daemon=True)
+        thread.start()
+        
+        return {
+            "success": True,
+            "message": f"⏰ {delay}秒后将打开新Chat并发送: {message}",
+            "tip": "请不要手动操作，等待自动执行"
+        }
+    
     def get_tools(self):
         """注册 MCP 工具"""
         tools = []
@@ -226,36 +335,7 @@ class MobileMCPServer:
         
         tools.append(Tool(
             name="mobile_list_elements",
-            description="""📋 列出页面所有可交互元素（⭐⭐ 第一优先级！）
-
-⚠️ 【核心原则】优先使用控件树定位，截图仅作为兜底方案
-
-🎯 使用场景（优先使用）：
-1. ✅ 首次进入页面时：获取所有可交互元素
-2. ✅ 查找特定元素时：检查元素是否存在
-3. ✅ 验证操作结果时：确认元素是否出现/消失
-4. ✅ 需要精确点击时：获取元素的 resource_id 或 text
-
-📌 控件树定位优势：
-- ⚡ 速度快：直接获取 XML，无需截图和图像处理（快 5-20 倍）
-- 🎯 准确：获取完整的元素属性（resource_id、text、bounds、clickable 等）
-- 💾 高效：不生成图片文件，节省存储和传输
-- 🔄 可复用：一次获取的元素列表可用于多次操作
-
-⚡ 推荐流程：
-1. 调用 mobile_list_elements() 获取元素列表
-2. 从元素列表中找到目标元素（通过 text 或 resource_id）
-3. 使用 mobile_click_by_text() 或 mobile_click_by_id() 点击
-4. 仅在控件树找不到元素时，才使用 mobile_screenshot_with_som()
-
-❌ 错误用法：
-- 每次都先截图，不先调用 list_elements
-- 重复调用 list_elements，不复用已获取的元素列表
-
-✅ 正确用法：
-elements = mobile_list_elements()  # 一次获取
-mobile_click_by_text("设置")        # 直接点击
-mobile_click_by_text("退出登录")    # 复用元素列表""",
+            description=desc_list_elements,
             inputSchema={"type": "object", "properties": {}, "required": []}
         ))
         
@@ -309,49 +389,8 @@ mobile_click_by_text("退出登录")    # 复用元素列表""",
         
         tools.append(Tool(
             name="mobile_screenshot_with_som",
-            description="""📸🏷️ Set-of-Mark 截图（⚠️ 兜底方案，非首选）
-
-⚠️ 【重要】仅在控件树定位失败时使用！
-
-🎯 使用场景（兜底方案）：
-1. ⚠️ 控件树定位失败：
-   - mobile_list_elements() 返回空或找不到目标元素
-   - 元素不在控件树中（如游戏、Unity 应用）
-2. ✅ 需要视觉确认：
-   - 首次进入新页面，需要了解整体布局
-   - 操作后需要视觉确认页面变化
-   - 需要给用户展示页面状态
-
-⚡ 推荐流程（优先使用控件树）：
-1. 先调用 mobile_list_elements() 获取元素列表
-2. 如果找到目标元素 → 使用 mobile_click_by_text() 或 mobile_click_by_id()
-3. 如果找不到 → 才调用 mobile_screenshot_with_som()
-4. 从截图分析找到元素编号 → 使用 mobile_click_by_som(编号)
-
-❌ 错误用法：
-- 每次都先截图，不先调用 list_elements
-- 在控件树能找到元素时也使用截图
-
-✅ 正确用法：
-elements = mobile_list_elements()  # 先尝试控件树
-if not find_target(elements):
-    screenshot = mobile_screenshot_with_som()  # 控件树失败才截图
-    mobile_click_by_som(index)
-
-💡 弹窗检测：
-- check_popup=True: 明确弹窗场景时使用（如调用 mobile_close_popup 前）
-- check_popup=False: 普通截图，不检测弹窗（默认）""",
-            inputSchema={
-                "type": "object",
-                "properties": {
-                    "check_popup": {
-                        "type": "boolean",
-                        "description": "是否检测弹窗，默认 False。仅在明确弹窗场景时设置为 True",
-                        "default": False
-                    }
-                },
-                "required": []
-            }
+            description=desc_som,
+            inputSchema={"type": "object", "properties": {}, "required": []}
         ))
         
         tools.append(Tool(
@@ -397,31 +436,7 @@ if not find_target(elements):
         
         tools.append(Tool(
             name="mobile_click_by_text",
-            description="""👆 通过文本点击元素（⭐⭐ 第一优先级点击方式）
-
-✅ 最稳定的定位方式，跨设备兼容
-✅ 实时检测元素是否存在，元素不存在会报错
-✅ 不会误点击到其他位置
-
-⚡ 使用流程（必须）：
-1. 先调用 mobile_list_elements() 获取元素列表
-2. 从元素列表中找到目标元素的 text
-3. 调用 mobile_click_by_text("文本") 点击
-
-💡 定位优先级：文本 > ID > 百分比 > 坐标
-
-📍 当页面有多个相同文案时，可使用 position 参数指定位置：
-   - 垂直方向: "top"/"upper"/"上", "bottom"/"lower"/"下", "middle"/"center"/"中"
-   - 水平方向: "left"/"左", "right"/"右", "center"/"中"
-   例如：点击"底部"的"微剧"tab，使用 position="bottom"
-
-❌ 错误用法：
-- 不先调用 list_elements，直接猜测文本点击
-- 在控件树能找到元素时使用截图+坐标点击
-
-✅ 正确用法：
-elements = mobile_list_elements()  # 先获取元素列表
-mobile_click_by_text("设置")        # 从元素列表中找到后直接点击""",
+            description=desc_click_text,
             inputSchema={
                 "type": "object",
                 "properties": {
@@ -881,6 +896,20 @@ mobile_click_by_text("设置")        # 从元素列表中找到后直接点击"
             }
         ))
         
+        # ==================== Cursor自动化 ====================
+        tools.append(Tool(
+            name="mobile_open_new_chat",
+            description="🔄 打开新Chat继续执行。执行完10个用例后调用，会延迟5秒后按Cmd+T打开新会话并输入继续命令。",
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "message": {"type": "string", "description": "新会话中要发送的消息", "default": "继续执行飞书用例"},
+                    "delay": {"type": "number", "description": "延迟秒数（等待当前响应结束）", "default": 5}
+                },
+                "required": []
+            }
+        ))
+        
         return tools
     
     async def handle_tool_call(self, name: str, arguments: dict):
@@ -1145,6 +1174,13 @@ mobile_click_by_text("设置")        # 从元素列表中找到后直接点击"
                     result = {"success": False, "error": "请提供 x_percent/y_percent 或 screenshot_path/x/y/width/height"}
                 return [TextContent(type="text", text=self.format_response(result))]
             
+            # Cursor自动化：打开新Chat
+            elif name == "mobile_open_new_chat":
+                message = arguments.get("message", "继续执行飞书用例")
+                delay = arguments.get("delay", 5)
+                result = self._open_new_chat(message, delay)
+                return [TextContent(type="text", text=self.format_response(result))]
+            
             else:
                 return [TextContent(type="text", text=f"❌ 未知工具: {name}")]
         

{mobile_mcp_ai-2.6.12.dist-info → mobile_mcp_ai-2.7.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mobile-mcp-ai
-Version: 2.6.12
+Version: 2.7.0
 Summary: 移动端自动化 MCP Server - 支持 Android/iOS，AI 功能可选（基础工具不需要 AI）
 Home-page: https://github.com/test111ddff-hash/mobile-mcp-ai
 Author: douzi
@@ -46,6 +46,10 @@ Requires-Dist: facebook-wda>=1.4.0; extra == "ios"
 Provides-Extra: h5
 Requires-Dist: Appium-Python-Client>=3.0.0; extra == "h5"
 Requires-Dist: selenium>=4.0.0; extra == "h5"
+Provides-Extra: windows
+Requires-Dist: pyautogui>=0.9.0; extra == "windows"
+Requires-Dist: pyperclip>=1.8.0; extra == "windows"
+Requires-Dist: pygetwindow>=0.0.9; extra == "windows"
 Provides-Extra: all
 Requires-Dist: dashscope>=1.10.0; extra == "all"
 Requires-Dist: openai>=1.0.0; extra == "all"
@@ -55,6 +59,9 @@ Requires-Dist: selenium>=4.0.0; extra == "all"
 Requires-Dist: pytest>=8.0.0; extra == "all"
 Requires-Dist: pytest-asyncio>=0.21.0; extra == "all"
 Requires-Dist: allure-pytest>=2.13.0; extra == "all"
+Requires-Dist: pyautogui>=0.9.0; extra == "all"
+Requires-Dist: pyperclip>=1.8.0; extra == "all"
+Requires-Dist: pygetwindow>=0.0.9; extra == "all"
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -336,6 +343,34 @@ tidevice list
 
 保存后**重启 Cursor**。
 
+### 批量执行用例（飞书集成）
+
+如果你需要从飞书多维表格批量执行用例，`mobile_open_new_chat` 功能会自动打开新会话继续执行。
+
+**macOS 用户：** 需要开启辅助功能权限
+
+| 步骤 | 操作 |
+|:---:|------|
+| 1 | 打开「系统设置」 |
+| 2 | 点击「隐私与安全性」 |
+| 3 | 点击「辅助功能」 |
+| 4 | 点击 + 号，添加 **Cursor.app** |
+| 5 | 确保开关已打开 ✅ |
+
+> ⚠️ 没有此权限，无法自动打开新会话继续执行
+
+**Windows 用户：** 需要安装额外依赖
+
+```bash
+pip install mobile-mcp-ai[windows]
+```
+
+或手动安装：
+
+```bash
+pip install pyautogui pyperclip pygetwindow
+```
+
 ---
 
 ## 🚀 使用示例
@@ -404,24 +439,17 @@ tidevice list
 
 ## 🛠️ 工具列表
 
-| 类别 | 工具 | 说明 | 优先级 |
-|:---:|------|------|:---:|
-| 📋 | `mobile_list_elements` | 列出页面元素 | ⭐⭐⭐ 第一优先级 |
-| 👆 | `mobile_click_by_text` | 文本点击 | ⭐⭐⭐ 第一优先级 |
-| 👆 | `mobile_click_by_id` | ID 点击 | ⭐⭐⭐ 第一优先级 |
-| 📸 | `mobile_screenshot_with_som` | Set-of-Mark 截图（智能标注） | ⚠️ 兜底方案 |
-| 📸 | `mobile_take_screenshot` | 截图 | ⚠️ 兜底方案 |
-| 📸 | `mobile_screenshot_with_grid` | 带网格坐标的截图 | ⚠️ 兜底方案 |
-| 👆 | `mobile_click_by_som` | SoM 编号点击 | ⚠️ 兜底方案 |
-| 👆 | `mobile_click_by_percent` | 百分比点击 | ⚠️ 最后兜底 |
-| 👆 | `mobile_click_at_coords` | 坐标点击 | ⚠️ 最后兜底 |
-| 📐 | `mobile_get_screen_size` | 屏幕尺寸 | 辅助工具 |
-
-> 💡 **工具选择策略**：优先使用控件树定位（`list_elements` + `click_by_text/id`），截图仅作为兜底方案。
-> 
-> 📖 详细指南：
-> - [工具选择策略指南](docs/TOOL_SELECTION_STRATEGY.md) - 详细的工具选择策略和决策树
-> - [用例执行最佳实践](docs/EXECUTION_BEST_PRACTICES.md) - 用例执行流程和优化建议
+| 类别 | 工具 | 说明 |
+|:---:|------|------|
+| 📋 | `mobile_list_elements` | 列出页面元素 |
+| 📸 | `mobile_take_screenshot` | 截图 |
+| 📸 | `mobile_screenshot_with_som` | Set-of-Mark 截图（智能标注） |
+| 📸 | `mobile_screenshot_with_grid` | 带网格坐标的截图 |
+| 📐 | `mobile_get_screen_size` | 屏幕尺寸 |
+| 👆 | `mobile_click_by_text` | 文本点击 |
+| 👆 | `mobile_click_by_id` | ID 点击 |
+| 👆 | `mobile_click_at_coords` | 坐标点击 |
+| 👆 | `mobile_click_by_percent` | 百分比点击 |
 | 👆 | `mobile_click_by_som` | SoM 编号点击 |
 | 👆 | `mobile_long_press_by_id` | ID 长按 |
 | 👆 | `mobile_long_press_by_text` | 文本长按 |

{mobile_mcp_ai-2.6.12.dist-info → mobile_mcp_ai-2.7.0.dist-info}/RECORD

@@ -1,14 +1,13 @@
 mobile_mcp/__init__.py,sha256=sQJZTL_sxQFzmcS7jOtS2AHCfUySz40vhX96N6u1qy4,816
 mobile_mcp/config.py,sha256=-xSl9vahp3EFAA97P1ahcnQC-HHAFvccGHpnFAXeKHU,5841
 mobile_mcp/core/__init__.py,sha256=ndMy-cLAIsQDG5op7gM_AIplycqZSZPWEkec1pEhvEY,170
-mobile_mcp/core/basic_tools_lite.py,sha256=WXOXY-yr97HRQ2TCWgKrTYGWV8ZvvrwpCuhxNiv_mbw,192203
+mobile_mcp/core/basic_tools_lite.py,sha256=8l0zxzFBB-41c_uVcS-5Z4slzawNGa7yu1GglYAkhME,193754
 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
 mobile_mcp/core/ios_device_manager_wda.py,sha256=A44glqI-24un7qST-E3w6BQD8mV92YVUbxy4rLlTScY,11264
 mobile_mcp/core/mobile_client.py,sha256=AaBntQSW2loAw7xL3j_IABNzrJO_Uukf9-F1z1xl6xE,63672
 mobile_mcp/core/template_matcher.py,sha256=tv8RU6zdeDobqphaP4Y8sicb1esg3gcQlZae1tNyitM,14559
-mobile_mcp/core/tool_selection_helper.py,sha256=k5_E4oK_fGg4n6qembvudt6Fw-QXq7_SLJDt4FO3cHc,5764
 mobile_mcp/core/templates/close_buttons/auto_x_0112_151217.png,sha256=s7tBVaYLBApNSEXjwi5kX8GXwUqgbNyNVEhXYjN9nd4,27373
 mobile_mcp/core/templates/close_buttons/auto_x_0112_152037.png,sha256=s7tBVaYLBApNSEXjwi5kX8GXwUqgbNyNVEhXYjN9nd4,27373
 mobile_mcp/core/templates/close_buttons/auto_x_0112_152840.png,sha256=s7tBVaYLBApNSEXjwi5kX8GXwUqgbNyNVEhXYjN9nd4,27373
@@ -20,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=GAbNZfCkCCsVPZL4s8c0EyDyk7F3otmvos-ZQsdeVoY,51300
+mobile_mcp/mcp_tools/mcp_server.py,sha256=nY_4jrdn4siJtm2HvettTv5bTN0rq9iJvwqBMlI7sMc,53175
 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.6.12.dist-info/licenses/LICENSE,sha256=HrhfyXIkWY2tGFK11kg7vPCqhgh5DcxleloqdhrpyMY,11558
-mobile_mcp_ai-2.6.12.dist-info/METADATA,sha256=U5l7Vu6A-giC5RiEOq30bgjr3lpuZhge9UhiFFewLXw,11166
-mobile_mcp_ai-2.6.12.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-mobile_mcp_ai-2.6.12.dist-info/entry_points.txt,sha256=KB_FglozgPHBprSM1vFbIzGyheFuHFmGanscRdMJ_8A,68
-mobile_mcp_ai-2.6.12.dist-info/top_level.txt,sha256=lLm6YpbTv855Lbh8BIA0rPxhybIrvYUzMEk9OErHT94,11
-mobile_mcp_ai-2.6.12.dist-info/RECORD,,
+mobile_mcp_ai-2.7.0.dist-info/licenses/LICENSE,sha256=HrhfyXIkWY2tGFK11kg7vPCqhgh5DcxleloqdhrpyMY,11558
+mobile_mcp_ai-2.7.0.dist-info/METADATA,sha256=-yl4iprOIClkYPv7YmyRLrDF9QBlRvhkro86tuqYr6U,11505
+mobile_mcp_ai-2.7.0.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
+mobile_mcp_ai-2.7.0.dist-info/entry_points.txt,sha256=KB_FglozgPHBprSM1vFbIzGyheFuHFmGanscRdMJ_8A,68
+mobile_mcp_ai-2.7.0.dist-info/top_level.txt,sha256=lLm6YpbTv855Lbh8BIA0rPxhybIrvYUzMEk9OErHT94,11
+mobile_mcp_ai-2.7.0.dist-info/RECORD,,

{mobile_mcp_ai-2.6.12.dist-info → mobile_mcp_ai-2.7.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.1)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

mobile_mcp/core/tool_selection_helper.py

@@ -1,168 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-工具选择辅助函数 - 帮助 AI 选择正确的工具
-
-这个模块提供工具选择建议，帮助 AI 在执行用例时遵循最佳实践。
-"""
-
-from typing import Dict, List, Optional, Tuple
-
-
-class ToolSelectionHelper:
-    """工具选择辅助类"""
-    
-    @staticmethod
-    def should_use_list_elements(scenario: str) -> Tuple[bool, str]:
-        """判断是否应该使用 mobile_list_elements()
-        
-        Args:
-            scenario: 使用场景描述
-            
-        Returns:
-            (should_use, reason) 元组
-        """
-        scenarios_should_use = [
-            "查找元素", "定位元素", "点击元素", "查找按钮", "查找文本",
-            "检查元素", "验证元素", "确认元素", "获取元素",
-            "进入页面", "新页面", "页面加载",
-        ]
-        
-        scenario_lower = scenario.lower()
-        for keyword in scenarios_should_use:
-            if keyword in scenario_lower:
-                return True, f"场景'{scenario}'应该优先使用 mobile_list_elements() 获取元素列表"
-        
-        return False, ""
-    
-    @staticmethod
-    def should_use_screenshot(scenario: str) -> Tuple[bool, str]:
-        """判断是否应该使用截图
-        
-        Args:
-            scenario: 使用场景描述
-            
-        Returns:
-            (should_use, reason) 元组
-        """
-        scenarios_should_use = [
-            "视觉确认", "查看页面", "页面截图", "展示页面",
-            "控件树找不到", "元素不存在", "游戏", "Unity",
-        ]
-        
-        scenario_lower = scenario.lower()
-        for keyword in scenarios_should_use:
-            if keyword in scenario_lower:
-                return True, f"场景'{scenario}'可以使用截图作为兜底方案"
-        
-        return False, ""
-    
-    @staticmethod
-    def get_tool_selection_advice(action: str, elements: Optional[List[Dict]] = None) -> str:
-        """获取工具选择建议
-        
-        Args:
-            action: 要执行的操作（如"点击设置按钮"）
-            elements: 已有的元素列表（如果有）
-            
-        Returns:
-            工具选择建议文本
-        """
-        advice = []
-        
-        # 如果还没有元素列表，建议先获取
-        if not elements:
-            advice.append("💡 建议：先调用 mobile_list_elements() 获取元素列表")
-            advice.append("   然后使用 mobile_click_by_text() 或 mobile_click_by_id() 点击")
-            advice.append("   仅在控件树找不到元素时，才使用 mobile_screenshot_with_som()")
-        else:
-            advice.append("✅ 已有元素列表，可以直接使用 mobile_click_by_text() 或 mobile_click_by_id()")
-            advice.append("   无需再次调用 mobile_list_elements() 或截图")
-        
-        return "\n".join(advice)
-    
-    @staticmethod
-    def find_element_in_list(elements: List[Dict], 
-                             text: Optional[str] = None,
-                             resource_id: Optional[str] = None,
-                             content_desc: Optional[str] = None) -> Optional[Dict]:
-        """在元素列表中查找元素
-        
-        Args:
-            elements: 元素列表
-            text: 要查找的文本
-            resource_id: 要查找的 resource_id
-            content_desc: 要查找的 content_desc
-            
-        Returns:
-            找到的元素，如果未找到返回 None
-        """
-        for elem in elements:
-            if text and elem.get("text") == text:
-                return elem
-            if resource_id and elem.get("resource_id") == resource_id:
-                return elem
-            if content_desc and elem.get("content_desc") == content_desc:
-                return elem
-        
-        return None
-    
-    @staticmethod
-    def suggest_click_method(elements: List[Dict], target_text: str) -> Dict:
-        """建议点击方法
-        
-        Args:
-            elements: 元素列表
-            target_text: 目标文本
-            
-        Returns:
-            建议信息字典
-        """
-        # 查找元素
-        target_elem = ToolSelectionHelper.find_element_in_list(elements, text=target_text)
-        
-        if target_elem:
-            # 元素存在，建议使用文本点击
-            return {
-                "found": True,
-                "method": "mobile_click_by_text",
-                "params": {"text": target_text},
-                "reason": f"元素'{target_text}'在控件树中找到，建议使用 mobile_click_by_text('{target_text}')"
-            }
-        else:
-            # 元素不存在，建议使用截图
-            return {
-                "found": False,
-                "method": "mobile_screenshot_with_som",
-                "params": {},
-                "reason": f"元素'{target_text}'在控件树中未找到，建议使用 mobile_screenshot_with_som() 作为兜底方案"
-            }
-
-
-# 导出辅助函数
-def should_use_list_elements_first(action: str) -> bool:
-    """判断是否应该优先使用 list_elements
-    
-    Args:
-        action: 要执行的操作描述
-        
-    Returns:
-        是否应该优先使用 list_elements
-    """
-    helper = ToolSelectionHelper()
-    should_use, _ = helper.should_use_list_elements(action)
-    return should_use
-
-
-def get_click_suggestion(elements: List[Dict], target_text: str) -> Dict:
-    """获取点击建议
-    
-    Args:
-        elements: 元素列表
-        target_text: 目标文本
-        
-    Returns:
-        点击建议字典
-    """
-    helper = ToolSelectionHelper()
-    return helper.suggest_click_method(elements, target_text)