Cursor rule

1---
2globs: "*.py"
3---
4 
5# Python 开发规范
6 
7## 基本规则
8 
9- Python 3.11+ 语法
10- 使用 type hints
11- 异步优先 (async/await)
12- 使用 dataclass 定义数据结构
13 
14## 代码风格
15 
16- 行宽限制: 100 字符
17- 使用 ruff 进行 lint
18- 遵循 PEP 8
19 
20## 项目特定规范
21 
22### MCP 工具定义
23 
24工具函数放在 `Mcp/src/unreal_analyzer/tools/` 目录，按领域分文件：
25- `blueprint.py` - 蓝图分析
26- `asset.py` - 资产分析
27- `cpp.py` - C++ 分析
28- `cross_domain.py` - 跨域查询
29 
30工具函数规范：
31```python
32async def tool_name(param1: str, param2: int = 0) -> dict:
33    """工具描述 (会显示给 AI)。
34    
35    Args:
36        param1: 参数1说明
37        param2: 参数2说明
38    
39    Returns:
40        Dictionary containing:
41        - key1: 说明
42        - key2: 说明
43    """
44```
45 
46### 与 Unreal 插件通信
47 
48使用 `ue_client.http_client.UEPluginClient`:
49```python
50from ..ue_client import get_client
51 
52async def my_tool():
53    client = get_client()
54    return await client.get("/endpoint", {"param": "value"})
55```
56 
57### C++ 分析器
58 
59使用 `cpp_analyzer.analyzer.CppAnalyzer`:
60```python
61from ..cpp_analyzer import get_analyzer
62 
63async def my_tool():
64    analyzer = get_analyzer()
65    return await analyzer.analyze_class("AMyClass")
66```
67 
68## 依赖管理
69 
70使用 uv:
71```bash
72uv add package_name      # 添加依赖
73uv sync                   # 安装依赖
74uv run command           # 运行命令
75```
76 
77## 测试
78 
79- 测试文件放在 `Mcp/tests/` 目录
80- 使用 pytest + pytest-asyncio
81- 异步测试使用 `@pytest.mark.asyncio`
82