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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mobile-mcp-ai
-Version: 2.6.10
+Version: 2.6.12
 Summary: 移动端自动化 MCP Server - 支持 Android/iOS，AI 功能可选（基础工具不需要 AI）
 Home-page: https://github.com/test111ddff-hash/mobile-mcp-ai
 Author: douzi
@@ -404,17 +404,24 @@ tidevice list
 
 ## 🛠️ 工具列表
 
-| 类别 | 工具 | 说明 |
-|:---:|------|------|
-| 📋 | `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_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_click_by_som` | SoM 编号点击 |
 | 👆 | `mobile_long_press_by_id` | ID 长按 |
 | 👆 | `mobile_long_press_by_text` | 文本长按 |

{mobile_mcp_ai-2.6.10 → mobile_mcp_ai-2.6.12}/README.md

@@ -333,17 +333,24 @@ tidevice list
 
 ## 🛠️ 工具列表
 
-| 类别 | 工具 | 说明 |
-|:---:|------|------|
-| 📋 | `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_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_click_by_som` | SoM 编号点击 |
 | 👆 | `mobile_long_press_by_id` | ID 长按 |
 | 👆 | `mobile_long_press_by_text` | 文本长按 |

{mobile_mcp_ai-2.6.10 → mobile_mcp_ai-2.6.12}/config.py

@@ -102,6 +102,31 @@ class Config:
         "false"
     ).lower() == "true"
     
+    # ==================== Token 优化（省钱模式）====================
+    # 启用 Token 优化（默认开启，只精简格式，不影响准确度）
+    TOKEN_OPTIMIZATION_ENABLED: bool = os.getenv(
+        "TOKEN_OPTIMIZATION_ENABLED",
+        "true"
+    ).lower() == "true"
+    
+    # list_elements 最大返回元素数量（默认 0 = 不限制，确保准确度）
+    MAX_ELEMENTS_RETURN: int = int(os.getenv("MAX_ELEMENTS_RETURN", "0"))
+    
+    # take_screenshot_with_som 最大返回元素数量（默认 0 = 不限制）
+    MAX_SOM_ELEMENTS_RETURN: int = int(os.getenv("MAX_SOM_ELEMENTS_RETURN", "0"))
+    
+    # 精简返回信息（只移除冗余提示文字，不影响数据）
+    COMPACT_RESPONSE: bool = os.getenv(
+        "COMPACT_RESPONSE",
+        "true"
+    ).lower() == "true"
+    
+    # 精简工具描述（减少每次请求的 token）
+    COMPACT_TOOL_DESCRIPTION: bool = os.getenv(
+        "COMPACT_TOOL_DESCRIPTION",
+        "true"
+    ).lower() == "true"
+    
     @classmethod
     def get_ai_platform(cls) -> Optional[str]:
         """获取优先使用的AI平台"""
@@ -137,6 +162,13 @@ class Config:
             "device": {
                 "default_device_id": cls.DEFAULT_DEVICE_ID,
                 "lock_orientation": cls.LOCK_SCREEN_ORIENTATION,
+            },
+            "token_optimization": {
+                "enabled": cls.TOKEN_OPTIMIZATION_ENABLED,
+                "max_elements": cls.MAX_ELEMENTS_RETURN,
+                "max_som_elements": cls.MAX_SOM_ELEMENTS_RETURN,
+                "compact_response": cls.COMPACT_RESPONSE,
+                "compact_tool_desc": cls.COMPACT_TOOL_DESCRIPTION,
             }
         }