Cursor rule

1---
2description: "开发流程和优先级指南"
3---
4 
5# 开发流程指南
6 
7## 当前版本：v0.3.1
8 
9核心功能已完成，当前处于优化和稳定阶段。
10 
11### 已完成功能
12 
13- ✅ C++ 源码分析（tree-sitter）
14- ✅ Blueprint 内省 API
15- ✅ Asset 引用查询
16- ✅ 跨域引用链追踪
17- ✅ 软引用追踪（Blueprint CDO）
18- ✅ Mermaid 图表输出
19- ✅ 工具集精简（22 → 8）
20 
21### 当前优化方向
22 
231. **性能优化**：大型项目搜索速度
242. **准确性提升**：引用链完整性
253. **用户体验**：错误提示和文档
26 
27## 关键文件
28 
29### MCP Server (Python)
30 
31- [server.py](mdc:Mcp/src/unreal_analyzer/server.py) - 入口
32- [unified.py](mdc:Mcp/src/unreal_analyzer/tools/unified.py) - 核心工具
33- [cross_domain.py](mdc:Mcp/src/unreal_analyzer/tools/cross_domain.py) - 跨域工具
34- [blueprint.py](mdc:Mcp/src/unreal_analyzer/tools/blueprint.py) - 蓝图工具
35- [cpp.py](mdc:Mcp/src/unreal_analyzer/tools/cpp.py) - C++ 工具
36- [analyzer.py](mdc:Mcp/src/unreal_analyzer/cpp_analyzer/analyzer.py) - C++ 分析器
37 
38### Unreal Plugin (C++)
39 
40- [UnrealAnalyzerHttpRoutes.cpp](mdc:Source/UnrealProjectAnalyzer/Private/UnrealAnalyzerHttpRoutes.cpp) - HTTP API 路由
41- [UnrealProjectAnalyzer.cpp](mdc:Source/UnrealProjectAnalyzer/Private/UnrealProjectAnalyzer.cpp) - 插件入口
42 
43## 开发命令
44 
45### Python MCP Server
46 
47```bash
48cd unreal-project-analyzer
49 
50# 安装依赖
51uv sync
52 
53# 运行测试
54uv run pytest
55 
56# 运行 MCP Server
57uv run unreal-analyzer
58 
59# Lint
60uv run ruff check .
61uv run ruff format .
62```
63 
64### Unreal 插件
65 
661. 复制本仓库目录到 UE 项目的 `Plugins/` 目录
672. 确保目录名为 `UnrealProjectAnalyzer/`（与 `UnrealProjectAnalyzer.uplugin` 一致）
683. 用 UE 编辑器打开项目，编译插件
694. 启用插件
70 
71## 测试指南
72 
73### 单元测试
74 
75```bash
76uv run pytest Mcp/tests/test_cpp_analyzer.py -v
77```
78 
79### 集成测试 (需要 UE 插件运行)
80 
81```bash
82# 确保 UE 编辑器已启动且插件已启用
83# 确保 HTTP API 在 localhost:8080 可用
84
85uv run pytest Mcp/tests/test_integration.py -v
86```
87 
88### Lyra 项目验证
89 
901. 下载 Lyra 示例项目
912. 安装 UnrealProjectAnalyzer 插件
923. 配置 MCP Server 连接
934. 测试典型查询:
94   - "分析 B_Hero_ShooterMannequin 的继承链"
95   - "GA_Hero_Dash 的触发路径是什么"
96   - "SK_Mannequin 被哪些资产引用"
97 
98## Git 工作流
99 
100- `main` 分支保持稳定
101- 功能开发使用 feature 分支
102- PR 需要通过测试
103 
104## 调试技巧
105 
106### MCP Server 调试
107 
108```python
109# 在 server.py 中添加日志
110import logging
111logging.basicConfig(level=logging.DEBUG)
112```
113 
114### Unreal 插件调试
115 
116```cpp
117// 在代码中添加断点日志
118UE_LOG(LogTemp, Warning, TEXT("DEBUG: variable = %s"), *Variable);
119```
120 
121### 查看 HTTP 请求
122 
123```bash
124# 直接测试 UE 插件 API
125curl http://localhost:8080/health
126curl http://localhost:8080/blueprint/search?pattern=BP_Player
127curl http://localhost:8080/blueprint/soft-references?bp_path=/Game/BP_Player
128```
129 
130## 工具设计原则
131 
132参考 [mcp-tools-design.mdc](mdc:.cursor/rules/mcp-tools-design.mdc)
133 
134核心原则：
1351. **最小信息熵**：删除冗余参数，合并语义相同的参数
1362. **统一命名**：`domain`, `scope`, `direction`, `format`
1373. **合理默认值**：大多数情况下使用默认值即可
138