mobile-mcp-ai 2.6.0__py3-none-any.whl → 2.6.1__py3-none-any.whl

mobile_mcp/core/basic_tools_lite.py

@@ -2349,6 +2349,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'
@@ -2383,6 +2384,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))
@@ -2417,7 +2425,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:
@@ -2443,7 +2453,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": {
@@ -2454,7 +2473,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]
@@ -2462,6 +2481,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}"}
     
@@ -3442,6 +3469,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():

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.6.0.dist-info → mobile_mcp_ai-2.6.1.dist-info}/METADATA

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

{mobile_mcp_ai-2.6.0.dist-info → mobile_mcp_ai-2.6.1.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=7QbmeNduFm-KDuKMGMmlnC3HqzNAlKFHcNpquicakAs,179209
+mobile_mcp/core/basic_tools_lite.py,sha256=zBKruc_z-iYaa5PysC91AAB0eydt_qDFNTT7o5OuUqU,181240
 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.6.0.dist-info/licenses/LICENSE,sha256=HrhfyXIkWY2tGFK11kg7vPCqhgh5DcxleloqdhrpyMY,11558
-mobile_mcp_ai-2.6.0.dist-info/METADATA,sha256=QeGdsOiTatw7dLmpFxeWxvIXt2bG3zuIt-HXlm-9XDw,10495
-mobile_mcp_ai-2.6.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-mobile_mcp_ai-2.6.0.dist-info/entry_points.txt,sha256=KB_FglozgPHBprSM1vFbIzGyheFuHFmGanscRdMJ_8A,68
-mobile_mcp_ai-2.6.0.dist-info/top_level.txt,sha256=lLm6YpbTv855Lbh8BIA0rPxhybIrvYUzMEk9OErHT94,11
-mobile_mcp_ai-2.6.0.dist-info/RECORD,,
+mobile_mcp_ai-2.6.1.dist-info/licenses/LICENSE,sha256=HrhfyXIkWY2tGFK11kg7vPCqhgh5DcxleloqdhrpyMY,11558
+mobile_mcp_ai-2.6.1.dist-info/METADATA,sha256=oa_vxBNab-rKPX3yXVbetv6Joc-jjdh_XxgYA7vbEfY,10495
+mobile_mcp_ai-2.6.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+mobile_mcp_ai-2.6.1.dist-info/entry_points.txt,sha256=KB_FglozgPHBprSM1vFbIzGyheFuHFmGanscRdMJ_8A,68
+mobile_mcp_ai-2.6.1.dist-info/top_level.txt,sha256=lLm6YpbTv855Lbh8BIA0rPxhybIrvYUzMEk9OErHT94,11
+mobile_mcp_ai-2.6.1.dist-info/RECORD,,