mobile-mcp-ai 2.1.2__py3-none-any.whl → 2.5.8__py3-none-any.whl

mobile_mcp_ai-2.5.8.dist-info/licenses/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

mobile_mcp_ai-2.5.8.dist-info/top_level.txt

@@ -0,0 +1 @@
+mobile_mcp

core/ai/__init__.py

@@ -1,11 +0,0 @@
-"""
-移动端AI工具模块
-"""
-
-from .test_generator import MobileTestGenerator, MobileTestStep
-
-__all__ = [
-    'MobileTestGenerator',
-    'MobileTestStep',
-]
-

core/ai/ai_analyzer.py

@@ -1,197 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-AI分析器 - 智能兜底，分析候选元素
-"""
-import sys
-import json
-from typing import Dict, List, Optional
-from .ai_config import ai_config
-
-
-class AIAnalyzer:
-    """AI分析器 - 用于智能兜底"""
-    
-    def __init__(self):
-        """初始化AI分析器"""
-        self.config = ai_config
-    
-    async def analyze_candidates(self, query: str, candidates: List[Dict], context: str = "") -> Optional[Dict]:
-        """
-        分析候选元素，选择最佳匹配
-        
-        Args:
-            query: 用户查询
-            candidates: 候选元素列表
-            context: 上下文信息（可选）
-        
-        Returns:
-            最佳匹配的元素信息
-        """
-        if not self.config.is_configured():
-            print("  ⚠️  AI未配置，跳过AI分析", file=sys.stderr)
-            return None
-        
-        if not candidates:
-            print("  ⚠️  没有候选元素，跳过AI分析", file=sys.stderr)
-            return None
-        
-        try:
-            import httpx
-            
-            # 构建提示词
-            prompt = self._build_prompt(query, candidates, context)
-            
-            print(f"  🤖 调用AI分析（模型: {self.config.model}）...", file=sys.stderr)
-            
-            # 调用通义千问API
-            async with httpx.AsyncClient(timeout=self.config.timeout) as client:
-                response = await client.post(
-                    f"{self.config.api_base}/chat/completions",
-                    headers={
-                        "Authorization": f"Bearer {self.config.api_key}",
-                        "Content-Type": "application/json"
-                    },
-                    json={
-                        "model": self.config.model,
-                        "messages": [
-                            {
-                                "role": "system",
-                                "content": "你是一个专业的移动端UI元素分析助手。请根据用户查询和候选元素，选择最匹配的元素，并返回JSON格式的结果。"
-                            },
-                            {
-                                "role": "user",
-                                "content": prompt
-                            }
-                        ],
-                        "temperature": 0.1,  # 低温度，更确定性
-                        "response_format": {"type": "json_object"}  # 强制返回JSON
-                    }
-                )
-            
-            if response.status_code != 200:
-                print(f"  ❌ AI调用失败: HTTP {response.status_code}", file=sys.stderr)
-                print(f"     {response.text}", file=sys.stderr)
-                return None
-            
-            result = response.json()
-            ai_response = result['choices'][0]['message']['content']
-            
-            # 解析AI返回的JSON
-            ai_result = json.loads(ai_response)
-            
-            if not ai_result.get('selected_index'):
-                print(f"  ⚠️  AI未能选择元素", file=sys.stderr)
-                return None
-            
-            selected_index = ai_result['selected_index'] - 1  # 转换为0-based索引
-            
-            if selected_index < 0 or selected_index >= len(candidates):
-                print(f"  ⚠️  AI返回的索引无效: {selected_index + 1}", file=sys.stderr)
-                return None
-            
-            selected = candidates[selected_index]
-            confidence = ai_result.get('confidence', 85)
-            reason = ai_result.get('reason', '未提供原因')
-            
-            print(f"  ✅ AI选择: 候选{selected_index + 1}/{len(candidates)}", file=sys.stderr)
-            print(f"     元素: {selected.get('text') or selected.get('content_desc') or selected.get('class_name')}", file=sys.stderr)
-            print(f"     置信度: {confidence}%", file=sys.stderr)
-            print(f"     理由: {reason}", file=sys.stderr)
-            
-            return {
-                'element': selected.get('text') or selected.get('content_desc') or query,
-                'ref': self._get_ref(selected),
-                'confidence': confidence,
-                'method': 'ai_analysis',
-                'reason': reason
-            }
-            
-        except Exception as e:
-            print(f"  ❌ AI分析异常: {e}", file=sys.stderr)
-            import traceback
-            traceback.print_exc()
-            return None
-    
-    def _build_prompt(self, query: str, candidates: List[Dict], context: str) -> str:
-        """构建AI提示词"""
-        # 格式化候选元素
-        candidates_text = []
-        for i, elem in enumerate(candidates, 1):
-            text = elem.get('text', '')
-            desc = elem.get('content_desc', '')
-            resource_id = elem.get('resource_id', '')
-            class_name = elem.get('class_name', '')
-            bounds = elem.get('bounds', '')
-            clickable = elem.get('clickable', False)
-            focusable = elem.get('focusable', False)
-            
-            # 计算位置
-            position = "未知"
-            if bounds:
-                try:
-                    # bounds格式: "[x1,y1][x2,y2]"
-                    coords = bounds.replace('[', '').replace(']', ',').split(',')
-                    y1 = int(coords[1])
-                    if y1 < 400:
-                        position = "顶部"
-                    elif y1 < 800:
-                        position = "中部"
-                    else:
-                        position = "底部"
-                except:
-                    pass
-            
-            parts = [f"候选{i}:"]
-            if text:
-                parts.append(f"文本=\"{text[:50]}\"")
-            if desc:
-                parts.append(f"描述=\"{desc[:50]}\"")
-            if resource_id:
-                parts.append(f"ID={resource_id}")
-            parts.append(f"类型={class_name}")
-            parts.append(f"位置={position}")
-            if clickable:
-                parts.append("可点击")
-            if focusable:
-                parts.append("可聚焦")
-            
-            candidates_text.append(" | ".join(parts))
-        
-        prompt = f"""
-用户查询: "{query}"
-
-页面上有以下候选元素:
-{chr(10).join(candidates_text)}
-
-{f"上下文信息: {context}" if context else ""}
-
-请分析哪个元素最匹配用户查询，并返回JSON格式:
-{{
-    "selected_index": <1到{len(candidates)}的数字>,
-    "confidence": <置信度0-100>,
-    "reason": "<选择理由>"
-}}
-
-分析要点:
-1. 优先匹配文本/描述的语义
-2. 考虑元素类型是否合理（如输入框应该是EditText）
-3. 考虑元素位置（如"顶部按钮"、"底部输入框"）
-4. 考虑用户意图（如"点击"需要可点击元素）
-"""
-        return prompt
-    
-    def _get_ref(self, element: Dict) -> str:
-        """获取元素引用"""
-        # 优先级: resource_id > content_desc > text > bounds
-        return (
-            element.get('resource_id') or
-            element.get('content_desc') or
-            element.get('text') or
-            element.get('bounds', '')
-        )
-
-
-# 全局实例
-ai_analyzer = AIAnalyzer()
-

core/ai/ai_config.py

@@ -1,116 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-AI配置模块 - 从根目录.env读取配置
-支持通义千问API
-"""
-import os
-from pathlib import Path
-from typing import Optional
-
-
-class AIConfig:
-    """AI配置类"""
-    
-    def __init__(self):
-        """初始化配置"""
-        self._load_env()
-    
-    def _load_env(self):
-        """从根目录.env加载配置"""
-        # 查找根目录.env文件
-        # 当前路径: backend/mobile_mcp/core/ai/ai_config.py
-        # 项目根目录: douzi-ai/
-        current_file = Path(__file__)
-        # 向上5层: ai/ -> core/ -> mobile_mcp/ -> backend/ -> douzi-ai/
-        project_root = current_file.parent.parent.parent.parent.parent
-        env_file = project_root / '.env'
-        
-        # 如果项目根目录没有，尝试backend目录
-        if not env_file.exists():
-            backend_root = current_file.parent.parent.parent.parent
-            env_file = backend_root / '.env'
-        
-        if not env_file.exists():
-            print(f"⚠️  未找到.env文件: {env_file}")
-            return
-        
-        # 读取.env文件
-        with open(env_file, 'r', encoding='utf-8') as f:
-            for line in f:
-                line = line.strip()
-                if not line or line.startswith('#'):
-                    continue
-                
-                # 解析键值对
-                if '=' in line:
-                    key, value = line.split('=', 1)
-                    key = key.strip()
-                    value = value.strip().strip('"').strip("'")
-                    
-                    # 设置环境变量（如果尚未设置）
-                    if key not in os.environ:
-                        os.environ[key] = value
-    
-    @property
-    def api_key(self) -> Optional[str]:
-        """获取API密钥"""
-        # 优先级：QWEN_API_KEY > OPENAI_API_KEY
-        return (
-            os.getenv('QWEN_API_KEY') or 
-            os.getenv('DASHSCOPE_API_KEY') or
-            os.getenv('OPENAI_API_KEY')
-        )
-    
-    @property
-    def api_base(self) -> Optional[str]:
-        """获取API基础URL"""
-        return (
-            os.getenv('QWEN_API_BASE') or 
-            os.getenv('OPENAI_API_BASE') or
-            'https://dashscope.aliyuncs.com/compatible-mode/v1'  # 通义千问默认地址
-        )
-    
-    @property
-    def model(self) -> str:
-        """获取模型名称"""
-        return (
-            os.getenv('QWEN_MODEL') or 
-            os.getenv('OPENAI_MODEL') or
-            'qwen-plus'  # 通义千问默认模型
-        )
-    
-    @property
-    def timeout(self) -> int:
-        """获取超时时间（秒）"""
-        return int(os.getenv('AI_TIMEOUT', '30'))
-    
-    def is_configured(self) -> bool:
-        """检查是否已配置"""
-        return bool(self.api_key)
-    
-    def __repr__(self):
-        """字符串表示"""
-        return (
-            f"AIConfig(\n"
-            f"  api_base={self.api_base}\n"
-            f"  model={self.model}\n"
-            f"  api_key={'***' + self.api_key[-4:] if self.api_key else 'None'}\n"
-            f"  timeout={self.timeout}s\n"
-            f")"
-        )
-
-
-# 全局配置实例
-ai_config = AIConfig()
-
-
-if __name__ == '__main__':
-    # 测试配置
-    print("=" * 60)
-    print("AI配置测试")
-    print("=" * 60)
-    print(ai_config)
-    print()
-    print(f"是否已配置: {ai_config.is_configured()}")
-