mobile-mcp-ai 2.6.4__tar.gz → 2.6.5__tar.gz

{mobile-mcp-ai-2.6.4/mobile_mcp_ai.egg-info → mobile_mcp_ai-2.6.5}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: mobile-mcp-ai
-Version: 2.6.4
+Version: 2.6.5
 Summary: 移动端自动化 MCP Server - 支持 Android/iOS，AI 功能可选（基础工具不需要 AI）
 Home-page: https://github.com/test111ddff-hash/mobile-mcp-ai
 Author: douzi
@@ -21,13 +21,53 @@ Classifier: Topic :: Software Development :: Testing
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: uiautomator2>=2.16.0
+Requires-Dist: adbutils>=1.2.0
+Requires-Dist: Pillow>=10.0.0
+Requires-Dist: mcp>=0.9.0
+Requires-Dist: python-dotenv>=1.0.0
 Provides-Extra: ai
+Requires-Dist: dashscope>=1.10.0; extra == "ai"
+Requires-Dist: openai>=1.0.0; extra == "ai"
+Requires-Dist: anthropic>=0.3.0; extra == "ai"
 Provides-Extra: test
+Requires-Dist: pytest>=8.0.0; extra == "test"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
+Requires-Dist: allure-pytest>=2.13.0; extra == "test"
 Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Requires-Dist: build>=0.10.0; extra == "dev"
 Provides-Extra: ios
+Requires-Dist: tidevice>=0.11.0; extra == "ios"
+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: all
-License-File: LICENSE
+Requires-Dist: dashscope>=1.10.0; extra == "all"
+Requires-Dist: openai>=1.0.0; extra == "all"
+Requires-Dist: anthropic>=0.3.0; extra == "all"
+Requires-Dist: Appium-Python-Client>=3.0.0; extra == "all"
+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"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 # 📱 Mobile MCP AI
 

{mobile-mcp-ai-2.6.4 → mobile_mcp_ai-2.6.5}/core/basic_tools_lite.py

@@ -1194,7 +1194,8 @@ class BasicMobileToolsLite:
         except Exception as e:
             return {"success": False, "message": f"❌ 百分比点击失败: {e}"}
     
-    def click_by_text(self, text: str, timeout: float = 3.0, position: Optional[str] = None) -> Dict:
+    def click_by_text(self, text: str, timeout: float = 3.0, position: Optional[str] = None, 
+                       verify: Optional[str] = None) -> Dict:
         """通过文本点击 - 先查 XML 树，再精准匹配
         
         Args:
@@ -1203,6 +1204,7 @@ class BasicMobileToolsLite:
             position: 位置信息，当有多个相同文案时使用。支持：
                 - 垂直方向: "top"/"upper"/"上", "bottom"/"lower"/"下", "middle"/"center"/"中"
                 - 水平方向: "left"/"左", "right"/"右", "center"/"中"
+            verify: 可选，点击后验证的文本。如果指定，会检查该文本是否出现在页面上
         """
         try:
             if self._is_ios():
@@ -1215,7 +1217,12 @@ class BasicMobileToolsLite:
                         elem.click()
                         time.sleep(0.3)
                         self._record_click('text', text, element_desc=text, locator_attr='text')
-                        return {"success": True}
+                        # 验证逻辑
+                        if verify:
+                            return self._verify_after_click(verify, ios=True)
+                        # 返回页面文本摘要，方便确认页面变化
+                        page_texts = self._get_page_texts(10)
+                        return {"success": True, "page_texts": page_texts}
                     # 控件树找不到，提示用视觉识别
                     return {"success": False, "fallback": "vision", "msg": f"未找到'{text}'，用截图点击"}
                 else:
@@ -1248,7 +1255,12 @@ class BasicMobileToolsLite:
                         time.sleep(0.3)
                         self._record_click('text', attr_value, x_pct, y_pct, 
                                           element_desc=f"{text}({position})", locator_attr=attr_type)
-                        return {"success": True}
+                        # 验证逻辑
+                        if verify:
+                            return self._verify_after_click(verify)
+                        # 返回页面文本摘要
+                        page_texts = self._get_page_texts(10)
+                        return {"success": True, "page_texts": page_texts}
                     
                     # 没有位置参数时，使用选择器定位
                     if attr_type == 'text':
@@ -1267,7 +1279,12 @@ class BasicMobileToolsLite:
                         time.sleep(0.3)
                         self._record_click('text', attr_value, x_pct, y_pct,
                                           element_desc=text, locator_attr=attr_type)
-                        return {"success": True}
+                        # 验证逻辑
+                        if verify:
+                            return self._verify_after_click(verify)
+                        # 返回页面文本摘要
+                        page_texts = self._get_page_texts(10)
+                        return {"success": True, "page_texts": page_texts}
                     
                     # 选择器失败，用坐标兜底
                     if bounds:
@@ -1277,13 +1294,58 @@ class BasicMobileToolsLite:
                         time.sleep(0.3)
                         self._record_click('percent', f"{x_pct}%,{y_pct}%", x_pct, y_pct,
                                           element_desc=text)
-                        return {"success": True}
+                        # 验证逻辑
+                        if verify:
+                            return self._verify_after_click(verify)
+                        # 返回页面文本摘要
+                        page_texts = self._get_page_texts(10)
+                        return {"success": True, "page_texts": page_texts}
                 
                 # 控件树找不到，提示用视觉识别
                 return {"success": False, "fallback": "vision", "msg": f"未找到'{text}'，用截图点击"}
         except Exception as e:
             return {"success": False, "msg": str(e)}
     
+    def _verify_after_click(self, verify_text: str, ios: bool = False, timeout: float = 2.0) -> Dict:
+        """点击后验证期望文本是否出现
+        
+        Args:
+            verify_text: 期望出现的文本
+            ios: 是否是 iOS 设备
+            timeout: 验证超时时间
+        
+        Returns:
+            {"success": True, "verified": True/False, "hint": "..."}
+        """
+        time.sleep(0.5)  # 等待页面更新
+        
+        try:
+            if ios:
+                ios_client = self._get_ios_client()
+                if ios_client and hasattr(ios_client, 'wda'):
+                    exists = ios_client.wda(name=verify_text).exists or \
+                             ios_client.wda(label=verify_text).exists
+                else:
+                    exists = False
+            else:
+                # Android: 检查文本或包含文本
+                exists = self.client.u2(text=verify_text).exists(timeout=timeout) or \
+                         self.client.u2(textContains=verify_text).exists(timeout=0.5) or \
+                         self.client.u2(description=verify_text).exists(timeout=0.5)
+            
+            if exists:
+                return {"success": True, "verified": True}
+            else:
+                # 验证失败，提示可以截图确认
+                return {
+                    "success": True,  # 点击本身成功
+                    "verified": False,
+                    "expect": verify_text,
+                    "hint": "验证失败，可截图确认"
+                }
+        except Exception as e:
+            return {"success": True, "verified": False, "hint": f"验证异常: {e}"}
+    
     def _find_element_in_tree(self, text: str, position: Optional[str] = None) -> Optional[Dict]:
         """在 XML 树中查找包含指定文本的元素，优先返回可点击的元素
         
@@ -2387,6 +2449,52 @@ class BasicMobileToolsLite:
         except Exception as e:
             return [{"error": f"获取元素失败: {e}"}]
     
+    def _get_page_texts(self, max_count: int = 15) -> List[str]:
+        """获取页面关键文本列表（用于点击后快速确认页面变化）
+        
+        Args:
+            max_count: 最多返回的文本数量
+            
+        Returns:
+            页面上的关键文本列表（去重）
+        """
+        try:
+            if self._is_ios():
+                ios_client = self._get_ios_client()
+                if ios_client and hasattr(ios_client, 'wda'):
+                    # iOS: 获取所有 StaticText 的文本
+                    elements = ios_client.wda(type='XCUIElementTypeStaticText').find_elements()
+                    texts = set()
+                    for elem in elements[:50]:  # 限制扫描数量
+                        try:
+                            name = elem.name or elem.label
+                            if name and len(name) > 1 and len(name) < 50:
+                                texts.add(name)
+                        except:
+                            pass
+                    return list(texts)[:max_count]
+                return []
+            else:
+                # Android: 快速扫描 XML 获取文本
+                xml_string = self.client.u2.dump_hierarchy(compressed=True)
+                import xml.etree.ElementTree as ET
+                root = ET.fromstring(xml_string)
+                
+                texts = set()
+                for elem in root.iter():
+                    text = elem.get('text', '').strip()
+                    desc = elem.get('content-desc', '').strip()
+                    # 只收集有意义的文本（长度2-30，非纯数字）
+                    for t in [text, desc]:
+                        if t and 2 <= len(t) <= 30 and not t.isdigit():
+                            texts.add(t)
+                    if len(texts) >= max_count * 2:  # 收集足够后停止
+                        break
+                
+                return list(texts)[:max_count]
+        except Exception:
+            return []
+    
     def _has_business_id(self, resource_id: str) -> bool:
         """
         判断resource_id是否是业务相关的ID

{mobile-mcp-ai-2.6.4 → mobile_mcp_ai-2.6.5}/mcp_tools/mcp_server.py

@@ -213,16 +213,16 @@ class MobileMCPServer:
         
         # ==================== 元素定位（优先使用）====================
         if compact:
-            desc_list_elements = "📋 列出页面可交互元素。点击前先调用此工具获取 text/id 定位。"
+            desc_list_elements = "📋 【首选】列出页面元素(token低)。返回text/id用于点击，替代截图确认页面状态。"
         else:
-            desc_list_elements = ("📋 列出页面所有可交互元素\n\n"
-                       "⚠️ 【重要】点击元素前必须先调用此工具！\n"
-                       "如果元素在控件树中存在，使用 click_by_text 或 click_by_id 定位。\n"
-                       "只有当此工具返回空或找不到目标元素时，才使用截图+坐标方式。\n\n"
-                       "📌 控件树定位优势：\n"
-                       "- 实时检测元素是否存在\n"
-                       "- 元素消失时会报错，不会误点击\n"
-                       "- 跨设备兼容性好")
+            desc_list_elements = ("📋 【⭐首选工具】列出页面所有可交互元素\n\n"
+                       "🚀 Token 优化：返回文本数据(~500 tokens)，远小于截图(~2000 tokens)！\n\n"
+                       "✅ 推荐使用场景：\n"
+                       "- 点击前确认元素存在\n"
+                       "- 点击后确认页面变化（替代截图确认）\n"
+                       "- 获取 text/id 用于 click_by_text/click_by_id\n\n"
+                       "❌ 不要用截图确认页面，用此工具！\n"
+                       "📌 只有需要看视觉布局时才用截图")
         
         tools.append(Tool(
             name="mobile_list_elements",
@@ -232,16 +232,15 @@ class MobileMCPServer:
         
         # ==================== 截图（视觉兜底）====================
         if compact:
-            desc_screenshot = "📸 截图。推荐用 mobile_screenshot_with_som 代替（带元素编号）。"
+            desc_screenshot = "📸 截图(token高~2000)。优先用list_elements(~500)确认页面状态。"
         else:
-            desc_screenshot = ("📸 截图查看屏幕内容\n\n"
-                       "⚠️ 【推荐使用 mobile_screenshot_with_som 代替！】\n"
-                       "SoM 截图会给元素标号，AI 可以直接说'点击几号'，更精准！\n\n"
-                       "🎯 本工具仅用于：\n"
-                       "- 快速确认页面状态（不需要点击时）\n"
-                       "- 操作后确认结果\n"
-                       "- compress=false 时可获取原始分辨率截图（用于添加模板）\n\n"
-                       "💡 如需点击元素，请用 mobile_screenshot_with_som + mobile_click_by_som")
+            desc_screenshot = ("📸 截图查看屏幕内容（⚠️ Token 消耗高 ~2000）\n\n"
+                       "❌ 【不推荐】确认页面状态请用 list_elements（Token 仅 ~500）！\n\n"
+                       "✅ 仅在以下场景使用：\n"
+                       "- 需要看视觉布局/图片内容\n"
+                       "- 元素无 text/id，只能靠位置点击\n"
+                       "- 调试问题需要可视化\n\n"
+                       "💡 compress=false 可获取原图（用于添加模板）")
         
         tools.append(Tool(
             name="mobile_take_screenshot",
@@ -266,20 +265,18 @@ class MobileMCPServer:
         ))
         
         if compact:
-            desc_som = "📸 SoM截图（推荐）。给元素标编号，用 click_by_som(编号) 点击。"
+            desc_som = "📸 SoM截图(token高)。元素有text时优先用list_elements+click_by_text。"
         else:
-            desc_som = ("📸🏷️ Set-of-Mark 截图（⭐⭐ 强烈推荐！默认截图方式）\n\n"
-                       "【智能标注】给每个可点击元素画框+编号，检测弹窗时额外标注可能的X按钮位置（黄色）。\n"
-                       "AI 看图直接说'点击 3 号'，调用 mobile_click_by_som(3) 即可！\n\n"
-                       "🎯 优势：\n"
-                       "- 元素有编号，精准点击不会误触\n"
-                       "- 自动检测弹窗，标注可能的关闭按钮位置\n"
-                       "- 适用于所有页面和所有操作\n\n"
-                       "⚡ 推荐流程：\n"
-                       "1. 任何需要操作的场景，都先调用此工具\n"
-                       "2. 看标注图，找到目标元素编号\n"
-                       "3. 调用 mobile_click_by_som(编号) 精准点击\n"
-                       "4. 🔴【必须】点击后再次截图确认操作是否成功！")
+            desc_som = ("📸🏷️ Set-of-Mark 截图（⚠️ Token 消耗高 ~2000）\n\n"
+                       "【智能标注】给每个可点击元素画框+编号\n\n"
+                       "❌ 【不推荐常规使用】：\n"
+                       "- 如果元素有 text，用 list_elements + click_by_text 更省 token\n"
+                       "- 确认页面状态用 list_elements，不要截图确认！\n\n"
+                       "✅ 仅在以下场景使用：\n"
+                       "- 元素无 text/id，只能看图点击\n"
+                       "- 需要视觉布局信息\n"
+                       "- 首次探索未知页面\n\n"
+                       "💡 点击后用 list_elements 确认，不要再截图！")
         
         tools.append(Tool(
             name="mobile_screenshot_with_som",
@@ -314,18 +311,19 @@ class MobileMCPServer:
         
         # ==================== 点击操作 ====================
         if compact:
-            desc_click_text = "👆 通过文本点击（最推荐）。position 可选 top/bottom/left/right。"
+            desc_click_text = "👆 文本点击（推荐）。verify可验证点击结果，无需截图确认。position可选top/bottom/left/right。"
         else:
-            desc_click_text = ("👆 通过文本点击元素（最推荐）\n\n"
+            desc_click_text = ("👆 通过文本点击元素（⭐ 最推荐）\n\n"
                        "✅ 最稳定的定位方式，跨设备兼容\n"
-                       "✅ 实时检测元素是否存在，元素不存在会报错\n"
-                       "✅ 不会误点击到其他位置\n"
-                       "📋 使用前先调用 mobile_list_elements 确认元素文本\n"
-                       "💡 定位优先级：文本 > ID > 百分比 > 坐标\n\n"
-                       "📍 当页面有多个相同文案时，可使用 position 参数指定位置：\n"
-                       "   - 垂直方向: \"top\"/\"upper\"/\"上\", \"bottom\"/\"lower\"/\"下\", \"middle\"/\"center\"/\"中\"\n"
-                       "   - 水平方向: \"left\"/\"左\", \"right\"/\"右\", \"center\"/\"中\"\n"
-                       "   例如：点击\"底部\"的\"微剧\"tab，使用 position=\"bottom\"")
+                       "✅ 元素不存在会报错，不会误点击\n\n"
+                       "🚀 Token 优化流程：\n"
+                       "1. list_elements 确认元素存在\n"
+                       "2. click_by_text 点击\n"
+                       "3. list_elements 确认页面变化（❌不要截图确认！）\n\n"
+                       "📍 position 参数：多个相同文案时指定位置\n"
+                       "   - top/bottom/left/right/center\n\n"
+                       "🔍 verify 参数：点击后自动验证文本是否出现\n"
+                       "   - 设置后无需额外调用 list_elements 确认")
         
         tools.append(Tool(
             name="mobile_click_by_text",
@@ -334,21 +332,21 @@ class MobileMCPServer:
                 "type": "object",
                 "properties": {
                     "text": {"type": "string", "description": "元素文本"},
-                    "position": {"type": "string", "description": "位置：top/bottom/left/right"}
+                    "position": {"type": "string", "description": "位置：top/bottom/left/right"},
+                    "verify": {"type": "string", "description": "点击后验证的文本（可选）"}
                 },
                 "required": ["text"]
             }
         ))
         
         if compact:
-            desc_click_id = "👆 通过 resource-id 点击。index 指定第几个（从 0 开始）。"
+            desc_click_id = "👆 通过resource-id点击。index指定第几个(从0开始)。点击后用list_elements确认。"
         else:
             desc_click_id = ("👆 通过 resource-id 点击元素（推荐）\n\n"
-                       "✅ 稳定的定位方式\n"
-                       "✅ 实时检测元素是否存在，元素不存在会报错\n"
-                       "📋 使用前先调用 mobile_list_elements 获取元素 ID\n"
-                       "💡 当有多个相同 ID 的元素时，用 index 指定第几个（从 0 开始）\n"
-                       "💡 定位优先级：文本 > ID > 百分比 > 坐标")
+                       "✅ 稳定的定位方式，元素不存在会报错\n"
+                       "📋 使用前 list_elements 获取元素 ID\n"
+                       "📋 点击后 list_elements 确认（❌不要截图确认！）\n"
+                       "💡 多个相同 ID 时用 index 指定第几个（从 0 开始）")
         
         tools.append(Tool(
             name="mobile_click_by_id",
@@ -364,17 +362,13 @@ class MobileMCPServer:
         ))
         
         if compact:
-            desc_click_coords = "👆 点击坐标（兜底）。优先用 click_by_text/id。"
+            desc_click_coords = "👆 坐标点击(兜底)。优先用click_by_text/id，点击后用list_elements确认。"
         else:
-            desc_click_coords = ("👆 点击指定坐标（兜底方案）\n\n"
-                       "⚠️ 【重要】优先使用 mobile_click_by_text 或 mobile_click_by_id！\n"
-                       "仅在 mobile_list_elements 无法获取元素时使用此工具。\n\n"
-                       "⚠️ 【时序限制】截图分析期间页面可能变化：\n"
-                       "- 坐标是基于截图时刻的，点击时页面可能已不同\n"
-                       "- 如果误点击，调用 mobile_press_key(back) 返回\n"
-                       "- 对于定时弹窗（如广告），建议等待其自动消失\n\n"
-                       "📐 坐标转换：截图返回的 image_width/height 等参数直接传入即可\n\n"
-                       "🔴 【必须】点击后必须再次截图确认操作是否成功！")
+            desc_click_coords = ("👆 点击指定坐标（⚠️ 兜底方案）\n\n"
+                       "❌ 优先使用 click_by_text 或 click_by_id！\n"
+                       "仅在 list_elements 无法获取元素时使用。\n\n"
+                       "📐 坐标转换：截图返回的参数直接传入即可\n"
+                       "📋 点击后用 list_elements 确认（❌不要截图确认！）")
         
         tools.append(Tool(
             name="mobile_click_at_coords",
@@ -863,7 +857,8 @@ class MobileMCPServer:
             elif name == "mobile_click_by_text":
                 result = self.tools.click_by_text(
                     arguments["text"],
-                    position=arguments.get("position")
+                    position=arguments.get("position"),
+                    verify=arguments.get("verify")
                 )
                 return [TextContent(type="text", text=self.format_response(result))]
             

{mobile-mcp-ai-2.6.4 → mobile_mcp_ai-2.6.5/mobile_mcp_ai.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: mobile-mcp-ai
-Version: 2.6.4
+Version: 2.6.5
 Summary: 移动端自动化 MCP Server - 支持 Android/iOS，AI 功能可选（基础工具不需要 AI）
 Home-page: https://github.com/test111ddff-hash/mobile-mcp-ai
 Author: douzi
@@ -21,13 +21,53 @@ Classifier: Topic :: Software Development :: Testing
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: uiautomator2>=2.16.0
+Requires-Dist: adbutils>=1.2.0
+Requires-Dist: Pillow>=10.0.0
+Requires-Dist: mcp>=0.9.0
+Requires-Dist: python-dotenv>=1.0.0
 Provides-Extra: ai
+Requires-Dist: dashscope>=1.10.0; extra == "ai"
+Requires-Dist: openai>=1.0.0; extra == "ai"
+Requires-Dist: anthropic>=0.3.0; extra == "ai"
 Provides-Extra: test
+Requires-Dist: pytest>=8.0.0; extra == "test"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "test"
+Requires-Dist: allure-pytest>=2.13.0; extra == "test"
 Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Requires-Dist: build>=0.10.0; extra == "dev"
 Provides-Extra: ios
+Requires-Dist: tidevice>=0.11.0; extra == "ios"
+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: all
-License-File: LICENSE
+Requires-Dist: dashscope>=1.10.0; extra == "all"
+Requires-Dist: openai>=1.0.0; extra == "all"
+Requires-Dist: anthropic>=0.3.0; extra == "all"
+Requires-Dist: Appium-Python-Client>=3.0.0; extra == "all"
+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"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license-file
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 # 📱 Mobile MCP AI
 

{mobile-mcp-ai-2.6.4 → mobile_mcp_ai-2.6.5}/mobile_mcp_ai.egg-info/SOURCES.txt

@@ -1,6 +1,8 @@
 LICENSE
 MANIFEST.in
 README.md
+__init__.py
+config.py
 requirements.txt
 setup.py
 ./__init__.py
@@ -29,13 +31,27 @@ setup.py
 ./utils/logger.py
 ./utils/xml_formatter.py
 ./utils/xml_parser.py
+core/__init__.py
+core/basic_tools_lite.py
+core/device_manager.py
+core/dynamic_config.py
+core/ios_client_wda.py
+core/ios_device_manager_wda.py
+core/mobile_client.py
+core/template_matcher.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
 core/templates/close_buttons/auto_x_0112_153256.png
 core/templates/close_buttons/auto_x_0112_154847.png
 core/templates/close_buttons/gray_x_stock_ad.png
+core/utils/__init__.py
+core/utils/logger.py
+core/utils/operation_history_manager.py
+core/utils/smart_wait.py
 docs/iOS_SETUP_GUIDE.md
+mcp_tools/__init__.py
+mcp_tools/mcp_server.py
 mobile_mcp_ai.egg-info/PKG-INFO
 mobile_mcp_ai.egg-info/SOURCES.txt
 mobile_mcp_ai.egg-info/dependency_links.txt
@@ -48,4 +64,18 @@ templates/close_buttons/auto_x_0112_152037.png
 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
+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
+utils/xml_parser.py

{mobile-mcp-ai-2.6.4 → mobile_mcp_ai-2.6.5}/setup.py

@@ -25,7 +25,7 @@ if requirements_file.exists():
 
 setup(
     name="mobile-mcp-ai",
-    version="2.6.4",  # Token 优化 - 减少约60% token消耗，启发式clickable判断
+    version="2.6.5",  # 代码优化更新
     author="douzi",
     author_email="1492994674@qq.com",
     description="移动端自动化 MCP Server - 支持 Android/iOS，AI 功能可选（基础工具不需要 AI）",

mobile_mcp_ai-2.6.5/tests/test_mind_cloud_my_space.py

@@ -0,0 +1,80 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+测试用例: Mind云文档我的空间
+生成时间: 2025-12-17 11:00:00
+"""
+import time
+import uiautomator2 as u2
+
+PACKAGE_NAME = "com.im30.mind"
+
+# 广告关闭按钮关键词（可自定义）
+AD_CLOSE_KEYWORDS = ['关闭', '跳过', 'Skip', 'Close', '×', 'X', '我知道了', '稍后再说']
+
+
+def smart_wait(d, timeout=10):
+    """智能等待页面稳定"""
+    d.implicitly_wait(timeout)
+    time.sleep(0.5)  # 额外等待动画
+
+
+def close_ad_if_exists(d):
+    """尝试关闭广告弹窗"""
+    for keyword in AD_CLOSE_KEYWORDS:
+        elem = d(textContains=keyword)
+        if elem.exists(timeout=0.5):
+            try:
+                elem.click()
+                print(f'  📢 关闭广告: {keyword}')
+                time.sleep(0.5)
+                return True
+            except:
+                pass
+    return False
+
+
+def safe_click(d, selector, timeout=5):
+    """安全点击（带等待和重试）"""
+    try:
+        if selector.exists(timeout=timeout):
+            selector.click()
+            return True
+        return False
+    except Exception as e:
+        print(f'  ⚠️ 点击失败: {e}')
+        return False
+
+
+def test_main():
+    # 连接设备
+    d = u2.connect()
+    d.implicitly_wait(10)  # 设置全局等待
+    
+    # 启动应用
+    d.app_start(PACKAGE_NAME)
+    smart_wait(d)
+    
+    # 尝试关闭启动广告
+    close_ad_if_exists(d)
+    
+    # 步骤1: 点击文本 'Mind'
+    safe_click(d, d(text='Mind'))
+    smart_wait(d)
+    close_ad_if_exists(d)  # 检查广告
+    
+    # 步骤2: 点击坐标 (756, 2277)
+    d.click(756, 2277)
+    smart_wait(d)
+    close_ad_if_exists(d)  # 检查广告
+    
+    # 步骤3: 点击坐标 (815, 285)
+    d.click(815, 285)
+    smart_wait(d)
+    close_ad_if_exists(d)  # 检查广告
+    
+    print('✅ 测试完成')
+
+
+if __name__ == '__main__':
+    test_main()