# EG 本地项目模块分析（Qt 清理后）

更新时间：2026-02-28  
分析范围：`d:\IMGUI\EG` 本地文件，不包含任何远程仓库信息。

## 1. 当前结论

- 主编辑器路径已切换为 ImGui 方案，Qt/PySide 在项目代码主路径中已清理完成。
- 本地扫描结果（排除 `RenderPipelineFile` 第三方目录）：
  - `PyQt/PySide/Qt` 关键引用：`0`
  - Python 脚本数：`385`
- 当前主要技术债已从“Qt 运行时依赖”转为“旧接口命名和耦合残留”。
- 已完成基础稳定性优化：入口保护、兼容字段初始化、脚本恢复拼写错误修复。
- 已完成第一轮接口收敛：`event_handler/selection/runtime_actions/InfoPanelManager` 已改为 helper 访问模式。

## 2. 本轮 Qt 清理落点

已完成清理的关键文件：

- [core/InfoPanelManager.py](d:/IMGUI/EG/core/InfoPanelManager.py)
- [core/selection.py](d:/IMGUI/EG/core/selection.py)
- [scene/scene_manager_convert_tiles_mixin.py](d:/IMGUI/EG/scene/scene_manager_convert_tiles_mixin.py)
- [ui/widgets.py](d:/IMGUI/EG/ui/widgets.py)
- [ui/icon_manager.py](d:/IMGUI/EG/ui/icon_manager.py)
- [core/world.py](d:/IMGUI/EG/core/world.py)
- [core/vr_manager.py](d:/IMGUI/EG/core/vr_manager.py)
- [core/vr/testing/test_mode.py](d:/IMGUI/EG/core/vr/testing/test_mode.py)
- [scene/tree_roles.py](d:/IMGUI/EG/scene/tree_roles.py)
- [TransformGizmo/move_gizmo.py](d:/IMGUI/EG/TransformGizmo/move_gizmo.py)
- [TransformGizmo/rotate_gizmo.py](d:/IMGUI/EG/TransformGizmo/rotate_gizmo.py)
- [TransformGizmo/scale_gizmo.py](d:/IMGUI/EG/TransformGizmo/scale_gizmo.py)
- [requirements/requirements.txt](d:/IMGUI/EG/requirements/requirements.txt)
- [requirements/clean-requirements.txt](d:/IMGUI/EG/requirements/clean-requirements.txt)
- [requirements/environment.yml](d:/IMGUI/EG/requirements/environment.yml)
- [requirements/DEPLOYMENT_README.md](d:/IMGUI/EG/requirements/DEPLOYMENT_README.md)

## 3. 仍需优化的结构点（非 Qt 依赖问题）

- 旧接口命名残留仍较多：`interface_manager/treeWidget/gui_manager` 引用约 `92` 处。
- `main.py` 仍是脚本式入口（模块导入副作用风险仍在）。
- 场景树与 GUI 元素生命周期在多个模块分散维护，后续建议继续做单一上下文收敛。

## 4. 风险分级（Qt 清理后）

- 高风险：
  - 多处旧接口命名仍在调用链中，后续重构若不做适配层可能引发行为回归。
- 中风险：
  - 场景保存/加载与树状态同步仍跨模块分散，维护成本高。
- 低风险：
  - 文档和模板文件中仍有历史术语，易造成新成员理解偏差。

## 5. 后续建议顺序

1. 建立统一 EditorContext，收敛 `interface_manager/gui_manager` 访问入口。  
2. 将场景树操作抽象为 ImGui 专用接口，逐步移除 `treeWidget` 语义。  
3. 统一入口规范（`if __name__ == "__main__":`）并补最小回归脚本。

## 6. 全量目录与脚本清单

为后续优化分析，完整目录树与全部脚本行数/用途清单见：

- [PROJECT_FULL_CATALOG.md](d:/IMGUI/EG/PROJECT_FULL_CATALOG.md)