EG/IMGUI_MODULE_ANALYSIS.md

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
• core/selection.py
• scene/scene_manager_convert_tiles_mixin.py
• ui/widgets.py
• ui/icon_manager.py
• core/world.py
• core/vr_manager.py
• core/vr/testing/test_mode.py
• scene/tree_roles.py
• TransformGizmo/move_gizmo.py
• TransformGizmo/rotate_gizmo.py
• TransformGizmo/scale_gizmo.py
• requirements/requirements.txt
• requirements/clean-requirements.txt
• requirements/environment.yml
• 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