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

mobile_mcp/mcp_tools/mcp_server.py

@@ -226,36 +226,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 +280,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 +327,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": {
@@ -588,18 +494,82 @@ mobile_click_by_text("设置")        # 从元素列表中找到后直接点击"
         # ==================== 导航操作 ====================
         tools.append(Tool(
             name="mobile_swipe",
-            description="👆 滑动。方向:up/down/left/right。",
+            description="👆 滑动屏幕。方向：up/down/left/right\n\n"
+                       "🎯 适用场景：\n"
+                       "- 滑动页面（列表、页面切换）\n"
+                       "- 拖动进度条/滑块（SeekBar、ProgressBar）\n"
+                       "- 滑动选择器（Picker、Slider）\n\n"
+                       "💡 左右滑动时，可指定高度坐标或百分比：\n"
+                       "- y: 指定高度坐标（像素）\n"
+                       "- y_percent: 指定高度百分比 (0-100)\n"
+                       "- 两者都未指定时，使用屏幕中心高度\n"
+                       "- 📌 拖动进度条时，使用进度条的 Y 位置（百分比或像素）\n\n"
+                       "💡 横向滑动（left/right）时，可指定滑动距离：\n"
+                       "- distance: 滑动距离（像素）\n"
+                       "- distance_percent: 滑动距离百分比 (0-100)\n"
+                       "- 两者都未指定时，使用默认距离（屏幕宽度的 60%）\n"
+                       "- 📌 拖动进度条时，distance_percent 控制拖动幅度\n\n"
+                       "💡 拖动进度条示例：\n"
+                       "- 倒退：direction='left', y_percent=91（进度条位置）, distance_percent=30\n"
+                       "- 前进：direction='right', y_percent=91, distance_percent=30\n\n"
+                       "⚠️ **推荐使用 mobile_drag_progress_bar 拖动进度条**（自动检测进度条位置，无需手动指定）",
             inputSchema={
                 "type": "object",
                 "properties": {
                     "direction": {"type": "string", "enum": ["up", "down", "left", "right"], "description": "方向"},
-                    "y": {"type": "integer", "description": "左右滑动高度(px)"},
-                    "y_percent": {"type": "number", "description": "左右滑动高度(%)"}
+                    "y": {"type": "integer", "description": "左右滑动时指定的高度坐标（像素）"},
+                    "y_percent": {"type": "number", "description": "左右滑动时指定的高度百分比 (0-100)"},
+                    "distance": {"type": "integer", "description": "横向滑动时指定的滑动距离（像素），仅用于 left/right"},
+                    "distance_percent": {"type": "number", "description": "横向滑动时指定的滑动距离百分比 (0-100)，仅用于 left/right"}
                 },
                 "required": ["direction"]
             }
         ))
         
+        tools.append(Tool(
+            name="mobile_drag_progress_bar",
+            description="🎯 智能拖动进度条（⭐⭐ 推荐用于拖动视频/音频进度条）\n\n"
+                       "✅ **自动检测进度条是否可见**：\n"
+                       "- 如果进度条已显示，直接拖动（无需先点击播放区域）\n"
+                       "- 如果进度条未显示，自动点击播放区域显示控制栏，再拖动\n\n"
+                       "🎯 优势：\n"
+                       "- 自动检测进度条位置，无需手动指定 y_percent\n"
+                       "- 智能判断是否需要显示控制栏\n"
+                       "- 使用 swipe 拖动，更稳定可靠\n\n"
+                       "💡 参数说明：\n"
+                       "- direction: 'left'（倒退）或 'right'（前进），默认 'right'\n"
+                       "- distance_percent: 拖动距离百分比 (0-100)，默认 30%\n"
+                       "- y_percent: 进度条位置（可选，未指定则自动检测）\n"
+                       "- y: 进度条位置坐标（可选，未指定则自动检测）\n\n"
+                       "📋 使用示例：\n"
+                       "- 前进30%：mobile_drag_progress_bar(direction='right', distance_percent=30)\n"
+                       "- 倒退30%：mobile_drag_progress_bar(direction='left', distance_percent=30)\n"
+                       "- 前进到指定位置：先点击进度条位置，或使用 mobile_swipe",
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "direction": {
+                        "type": "string",
+                        "enum": ["left", "right"],
+                        "description": "拖动方向：'left'（倒退）或 'right'（前进），默认 'right'"
+                    },
+                    "distance_percent": {
+                        "type": "number",
+                        "description": "拖动距离百分比 (0-100)，默认 30%"
+                    },
+                    "y_percent": {
+                        "type": "number",
+                        "description": "进度条的垂直位置百分比 (0-100)，可选，未指定则自动检测"
+                    },
+                    "y": {
+                        "type": "integer",
+                        "description": "进度条的垂直位置坐标（像素），可选，未指定则自动检测"
+                    }
+                },
+                "required": []
+            }
+        ))
+        
         tools.append(Tool(
             name="mobile_press_key",
             description="⌨️ 按键:home/back/enter/search。",
@@ -715,6 +685,8 @@ mobile_click_by_text("设置")        # 从元素列表中找到后直接点击"
 - 如果没有弹窗 → 直接返回"无弹窗"，不执行任何操作
 - 如果有弹窗 → 自动查找并点击关闭按钮
 
+💡 【优化】如果已通过list_elements识别到弹窗，可传入popup_detected=true跳过重复检测
+
 ✅ 适用场景：
 - 启动应用后检测并关闭可能出现的弹窗
 - 页面跳转后检测并关闭弹窗
@@ -730,7 +702,21 @@ mobile_click_by_text("设置")        # 从元素列表中找到后直接点击"
         tools.append(Tool(
             name="mobile_close_popup",
             description=desc_close_popup,
-            inputSchema={"type": "object", "properties": {}, "required": []}
+            inputSchema={
+                "type": "object",
+                "properties": {
+                    "popup_detected": {
+                        "type": "boolean",
+                        "description": "可选，如果已通过list_elements识别到弹窗，传入true可跳过重复检测"
+                    },
+                    "popup_bounds": {
+                        "type": "array",
+                        "items": {"type": "number"},
+                        "description": "可选，弹窗边界[x1, y1, x2, y2]，如果已识别到弹窗区域可传入"
+                    }
+                },
+                "required": []
+            }
         ))
         
         tools.append(Tool(
@@ -1018,7 +1004,18 @@ mobile_click_by_text("设置")        # 从元素列表中找到后直接点击"
                 result = await self.tools.swipe(
                     arguments["direction"],
                     y=arguments.get("y"),
-                    y_percent=arguments.get("y_percent")
+                    y_percent=arguments.get("y_percent"),
+                    distance=arguments.get("distance"),
+                    distance_percent=arguments.get("distance_percent")
+                )
+                return [TextContent(type="text", text=self.format_response(result))]
+            
+            elif name == "mobile_drag_progress_bar":
+                result = await self.tools.drag_progress_bar(
+                    direction=arguments.get("direction", "right"),
+                    distance_percent=arguments.get("distance_percent", 30.0),
+                    y_percent=arguments.get("y_percent"),
+                    y=arguments.get("y")
                 )
                 return [TextContent(type="text", text=self.format_response(result))]
             
@@ -1062,7 +1059,17 @@ mobile_click_by_text("设置")        # 从元素列表中找到后直接点击"
                 return [TextContent(type="text", text=self.format_response(result))]
             
             elif name == "mobile_close_popup":
-                result = self.tools.close_popup()
+                popup_detected = arguments.get("popup_detected")
+                popup_bounds = arguments.get("popup_bounds")
+                # 如果传入了popup_bounds，转换为tuple
+                if popup_bounds and isinstance(popup_bounds, list) and len(popup_bounds) == 4:
+                    popup_bounds = tuple(popup_bounds)
+                elif popup_bounds:
+                    popup_bounds = None  # 格式不正确，忽略
+                result = self.tools.close_popup(
+                    popup_detected=popup_detected,
+                    popup_bounds=popup_bounds
+                )
                 return [TextContent(type="text", text=self.format_response(result))]
             
             elif name == "mobile_assert_text":

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mobile-mcp-ai
-Version: 2.6.12
+Version: 2.7.3
 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.3.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=DPLPVoi-e-KsYAHANXKlBqCcJPBaE4lV_Qvf-zjL9Ng,219759
 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=nEb_chFF_1lN__4nMei2yPzVgzlDeYK67p-KJVta-VU,53521
 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.3.dist-info/licenses/LICENSE,sha256=HrhfyXIkWY2tGFK11kg7vPCqhgh5DcxleloqdhrpyMY,11558
+mobile_mcp_ai-2.7.3.dist-info/METADATA,sha256=60jvdRSHcL4QWPCaeiFxLunyBbT_2wkYF0UIo-Fq4v0,11505
+mobile_mcp_ai-2.7.3.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
+mobile_mcp_ai-2.7.3.dist-info/entry_points.txt,sha256=KB_FglozgPHBprSM1vFbIzGyheFuHFmGanscRdMJ_8A,68
+mobile_mcp_ai-2.7.3.dist-info/top_level.txt,sha256=lLm6YpbTv855Lbh8BIA0rPxhybIrvYUzMEk9OErHT94,11
+mobile_mcp_ai-2.7.3.dist-info/RECORD,,

{mobile_mcp_ai-2.6.12.dist-info → mobile_mcp_ai-2.7.3.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)