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

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

@@ -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 → mobile_mcp_ai-2.7.3}/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` | 文本长按 |