mobile-mcp-ai 2.6.12__tar.gz → 2.7.0__tar.gz

{mobile_mcp_ai-2.6.12/mobile_mcp_ai.egg-info → mobile_mcp_ai-2.7.0}/PKG-INFO

@@ -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 → mobile_mcp_ai-2.7.0}/README.md

@@ -265,6 +265,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
+```
+
 ---
 
 ## 🚀 使用示例
@@ -333,24 +361,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 → mobile_mcp_ai-2.7.0}/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_ai-2.6.12 → mobile_mcp_ai-2.7.0}/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 → mobile_mcp_ai-2.7.0/mobile_mcp_ai.egg-info}/PKG-INFO

@@ -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 → mobile_mcp_ai-2.7.0}/mobile_mcp_ai.egg-info/SOURCES.txt

@@ -15,7 +15,6 @@ setup.py
 ./core/ios_device_manager_wda.py
 ./core/mobile_client.py
 ./core/template_matcher.py
-./core/tool_selection_helper.py
 ./core/templates/close_buttons/auto_x_0112_151217.png
 ./core/templates/close_buttons/auto_x_0112_152037.png
 ./core/templates/close_buttons/auto_x_0112_152840.png
@@ -40,7 +39,6 @@ core/ios_client_wda.py
 core/ios_device_manager_wda.py
 core/mobile_client.py
 core/template_matcher.py
-core/tool_selection_helper.py
 core/templates/close_buttons/auto_x_0112_151217.png
 core/templates/close_buttons/auto_x_0112_152037.png
 core/templates/close_buttons/auto_x_0112_152840.png
@@ -51,9 +49,6 @@ core/utils/__init__.py
 core/utils/logger.py
 core/utils/operation_history_manager.py
 core/utils/smart_wait.py
-docs/EXECUTION_BEST_PRACTICES.md
-docs/STRATEGY_SUMMARY.md
-docs/TOOL_SELECTION_STRATEGY.md
 docs/iOS_SETUP_GUIDE.md
 mcp_tools/__init__.py
 mcp_tools/mcp_server.py
@@ -70,6 +65,16 @@ templates/close_buttons/auto_x_0112_152840.png
 templates/close_buttons/auto_x_0112_153256.png
 templates/close_buttons/auto_x_0112_154847.png
 templates/close_buttons/gray_x_stock_ad.png
+tests/test_mind_cloud_my_space.py
+tests/test_mind_correct.py
+tests/test_mind_improved.py
+tests/test_mind_optimized.py
+tests/test_open_mind.py
+tests/test_priority_demo.py
+tests/test_simple.py
+tests/test_举报.py
+tests/test_切换语言到English.py
+tests/test_测试.py
 utils/__init__.py
 utils/logger.py
 utils/xml_formatter.py