Cursor rule

1---
2globs: "*.cpp,*.h,*.cs"
3---
4 
5# Unreal 插件开发规范
6 
7## 插件结构
8 
9```
10UnrealProjectAnalyzer/ (插件根目录)
11├── UnrealProjectAnalyzer.uplugin         # 插件描述文件
12├── Source/UnrealProjectAnalyzer/
13│   ├── Public/                        # 头文件
14│   ├── Private/                       # 实现文件
15│   └── UnrealProjectAnalyzer.Build.cs
16└── Content/Python/                    # Python Bridge 脚本
17```
18 
19## 模块职责
20 
21| 文件 | 职责 |
22|------|------|
23| `UnrealProjectAnalyzer.cpp/h` | 模块入口，HTTP Server 初始化 |
24| `BlueprintAnalyzer.cpp/h` | Blueprint 分析逻辑 |
25| `AssetAnalyzer.cpp/h` | Asset 引用分析逻辑 |
26| `HttpRoutes.cpp/h` | HTTP 路由注册 |
27 
28## HTTP API 设计
29 
30### Blueprint API
31 
32```
33GET /blueprint/search?pattern=xxx&class=xxx
34GET /blueprint/hierarchy?bp_path=/Game/...
35GET /blueprint/dependencies?bp_path=/Game/...
36GET /blueprint/referencers?bp_path=/Game/...
37GET /blueprint/graph?bp_path=/Game/...&graph_name=EventGraph
38GET /blueprint/details?bp_path=/Game/...
39```
40 
41### Asset API
42 
43```
44GET /asset/search?pattern=xxx&type=xxx
45GET /asset/references?asset_path=/Game/...
46GET /asset/referencers?asset_path=/Game/...
47GET /asset/metadata?asset_path=/Game/...
48```
49 
50### Analysis API
51 
52```
53GET /analysis/reference-chain?start=xxx&depth=xxx
54GET /analysis/cpp-class-usage?class=xxx
55```
56 
57## 编码规范
58 
59### 命名
60 
61- 类: `F` 前缀 (struct), `U` 前缀 (UObject), `A` 前缀 (Actor)
62- 模块类: `FUnrealProjectAnalyzerModule`
63- 布尔值: `b` 前缀 (`bIsEnabled`)
64 
65### 日志
66 
67```cpp
68UE_LOG(LogTemp, Log, TEXT("UnrealProjectAnalyzer: Message"));
69UE_LOG(LogTemp, Warning, TEXT("UnrealProjectAnalyzer: Warning"));
70UE_LOG(LogTemp, Error, TEXT("UnrealProjectAnalyzer: Error"));
71```
72 
73### HTTP 路由注册
74 
75```cpp
76Router->BindRoute(
77    FHttpPath(TEXT("/endpoint")),
78    EHttpServerRequestVerbs::VERB_GET,
79    [](const FHttpServerRequest& Request, const FHttpResultCallback& OnComplete)
80    {
81        // 处理请求
82        TUniquePtr<FHttpServerResponse> Response = FHttpServerResponse::Create(
83            TEXT("{\"key\": \"value\"}"),
84            TEXT("application/json")
85        );
86        OnComplete(MoveTemp(Response));
87        return true;
88    }
89);
90```
91 
92## Python Bridge
93 
94Python Bridge 通过 `PythonScriptPlugin` 在模块启动时自动拉起：
95 
96```cpp
97// 在 StartupModule() 中
98IPythonScriptPlugin* PythonPlugin = FModuleManager::GetModulePtr<IPythonScriptPlugin>("PythonScriptPlugin");
99PythonPlugin->ExecPythonCommand(*PythonCommand);
100```
101 
102## 依赖模块
103 
104必需的 UE 模块 (在 Build.cs 中声明)：
105- `HTTP`, `HTTPServer` - HTTP 服务
106- `Json`, `JsonUtilities` - JSON 处理
107- `UnrealEd`, `BlueprintGraph`, `Kismet` - 蓝图 API
108- `AssetRegistry` - 资产引用 API
109- `PythonScriptPlugin` - Python 集成
110 
111## 路由参数约定（重要）
112 
113- **含 `/Game/...` 的资产/蓝图路径必须使用 query 参数传递**（例如 `bp_path=/Game/...`、`asset_path=/Game/...`）
114- **不要**把 `/Game/...` 直接拼进 URL path（如 `/blueprint/{path}/hierarchy`），因为 UE `HttpServer` 的路由匹配会按 `/` 分段，容易导致无法匹配或编码/解码异常。
115