XCEngine/docs/used/Editor重构3.26.md

# Editor 重构 3.26

## 当前判断

截至 2026-03-27，如果只看 editor 的 UI 架构与编辑器壳层整理，不把 `Viewport / RHI` 和 `Scene / Game` 的真实内容算进去，这一轮重构大约已经完成 **96%**。

如果把“编辑器整体可用度”一起算进去，则仍然没有结束，因为：

- `Scene` panel 仍然是空壳。
- `Game` panel 仍然是空壳。
- `Viewport` 尚未跟随 RHI 重构完成回归。

所以现在的真实状态是：

- **UI 架构已经基本收稳**
- **编辑器产品功能还没有做完**

## 已经完成的核心重构

### 1. 分层已经基本建立

当前 editor 已经形成比较稳定的职责划分：

- `UI` 负责主题、token、共享控件、popup、property-grid。
- `Actions` 负责菜单、快捷键、右键菜单、按钮动作的共享路由。
- `Commands` 负责 scene/project/entity/component 的编辑行为。
- `Layout` 负责 dock host、默认布局、布局重置与持久化。
- `Panels` 逐步退化为窗口壳层。
- `Core / Managers` 负责 editor context、selection、undo、scene、project 等共享状态。
- `ComponentEditors` 负责 inspector 中各组件的编辑器与注册体系。

这说明 editor 已经从“每个 panel 自己堆逻辑”的结构，切换到“共享层驱动”的结构。

### 2. 共享 UI 基础层已经落稳

已经把大量原先散落在 panel 内部的视觉和控件逻辑收口到 shared UI 层，包括：

- 主题和样式 token
- panel chrome
- toolbar/search/button
- popup / modal state
- empty state
- asset tile
- hierarchy tree node
- component section
- property grid / scalar / vector 编辑控件

这部分的意义是：后面再调 editor 外观，不应该回到 panel 内部逐个修补。

### 3. Action 路由已经成型

当前已形成两条主路由：

- `MainMenuActionRouter`
- `EditActionRouter`

并且 `Hierarchy / Project / Inspector / Console / MenuBar` 的主要菜单和快捷键语义已经接入共享 action/router。

当前已经做到：

- `Edit` 菜单不再只是一套写死逻辑，而是跟随 active action route 切换。
- menu / shortcut / context menu / toolbar 的动作开始共用同一套 action 定义。
- rename、popup、about、exit、reset layout 等交互已不再零散写在 panel 内部。

### 4. Commands 层已经承担主要编辑语义

当前主要编辑行为已进入 command 层：

- 新建 / 打开 / 保存场景
- 脏场景 fallback 保存
- 创建 / 删除 / 复制 / 粘贴 / duplicate / rename / reparent entity
- 创建文件夹 / 删除资源 / 打开资源 / 移动资源
- 添加 / 删除组件

同时，undo / dirty / selection reset 等关键边界，已经尽量不再散落在 panel。

### 5. Dock / Workspace / Application 壳层已收口

当前已经完成：

- `EditorWorkspace` 统一 panel 装配与生命周期调度
- `DockLayoutController` 统一 dockspace 和 layout reset
- ImGui layout 持久化到项目 `.xceditor/imgui_layout.ini`
- `Application.cpp` 中的窗口、renderer、ImGui session、layer attach/detach 已完成明显拆分

这说明 editor 顶层壳层已经不再像之前那样把 UI、layout、backend、panel 生命周期混在一起。

### 6. Inspector 的 ComponentEditor 注册体系已稳定

当前 inspector 不再直接硬编码全部组件逻辑，而是通过：

- `IComponentEditor`
- `ComponentEditorRegistry`
- 各具体 `Transform / Camera / Light` component editor

来统一：

- 组件显示
- Add Component 菜单构建
- 组件可添加性 / 可删除性判断

这部分已经是后续扩展自定义组件 inspector 的正确落点。

### 7. 回归测试基础已补齐

当前已新增 `editor_tests`，并已覆盖关键 editor 行为，包括：

- hierarchy edit route 的 copy / paste / duplicate / delete / rename request
- project edit route 的 open / back / delete
- scene dirty save + load 后的 selection / undo reset
- reparent 时的 parent 切换、cycle 拦截与 world transform 保持
- main menu 的 exit / reset layout / about popup request
- hierarchy rename helper
- project create-folder / move-asset / open-folder helper

本轮收尾继续补充后，测试会进一步覆盖：

- clean scene 下的新建场景重置行为
- clean scene 下 fallback save 的 no-op 路径
- project move-asset 的非法输入保护

## 当前仍然剩下什么

### 架构收尾项

1. 继续压缩少量 panel 本地瞬时状态  
   目标是把还能共享的 popup / router / state 再往 shared 层收一点。

2. 继续补 editor 回归测试  
   重点补 command/router 边界，而不是 UI 像素测试。

3. 为 viewport 回归保留 editor shell 接口  
   但暂时不把 RHI/renderer 接进来。

### 暂缓项

以下内容不计入当前这一轮 UI 架构收尾：

- `Scene` panel 真正内容
- `Game` panel 真正内容
- `Viewport` 渲染接入

原因不是不做，而是这些工作和 renderer / RHI 重构直接绑定，应该放到后续阶段。

## 本轮新增文档

本次已补正式架构说明：

- `docs/plan/Editor架构说明.md`

这个文档用于明确：

- 各层职责边界
- 允许依赖方向
- panel / action / command / manager / component editor 的落点规则
- event bus、undo、dirty、selection 的统一约定

## 阶段性结论

当前 editor 可以明确地说：

- **UI 架构层面已经基本重构完成**
- **剩余主要是封口、验证和后续 viewport 接入准备**

也就是说，后面不应该再回到“看到一个 panel 问题就地补一段特殊逻辑”的方式，而应该继续沿着现有分层做增量完善。