Super Splat项目中的撤销/重做操作导致意外旋转问题分析

在3D场景编辑工具Super Splat的开发过程中，我们遇到了一个关于撤销(Undo)和重做(Redo)功能的有趣问题。这个问题表现为在进行特定操作序列后，场景中的选择区域会出现意外的旋转变化。

问题现象描述

当用户按照以下步骤操作时会出现问题：

1. 打开一个3D场景
2. 通过输入数值来旋转场景
3. 进行矩形区域选择
4. 使用Delete键删除选定区域
5. 使用Ctrl+Z撤销删除操作
6. 再次按Ctrl+Z（此时无效果）
7. 点击界面上的撤销按钮（选择区域会短暂旋转然后恢复）
8. 点击重做按钮（选择区域变为旋转状态）

技术原因分析

经过深入分析，我们发现问题的根源在于键盘焦点管理和撤销系统的交互机制上。具体来说：

1. 焦点冲突：当用户在旋转输入框中输入数值后，键盘焦点仍然停留在该输入框上。此时系统会优先处理输入框自身的撤销逻辑，而不是场景编辑的撤销系统。

2. 撤销堆栈不一致：由于焦点问题导致的操作没有被正确记录到场景的撤销历史中，造成了撤销/重做操作时的状态不一致。

3. 旋转状态同步：在焦点切换过程中，旋转状态的同步出现了延迟或错误，导致了视觉上的短暂旋转现象。

解决方案

针对这个问题，我们采取了以下改进措施：

1. 焦点管理优化：在添加操作到撤销历史堆栈时，强制移除输入框的焦点，确保后续的撤销操作由场景编辑系统处理而非输入控件自身。

2. 事件拦截机制：添加了对默认文本撤销操作的拦截处理，防止系统级别的撤销操作干扰场景编辑的撤销流程。

3. 状态同步增强：改进了旋转状态的同步机制，确保在各种操作序列下都能保持状态的一致性。

技术实现细节

在具体实现上，我们需要注意以下几点：

1. 焦点转移时机：需要在操作被记录到撤销堆栈之前就完成焦点转移，而不是之后。

2. 撤销命令封装：将旋转操作与其他编辑操作统一封装，确保它们作为一个整体被撤销系统管理。

3. 状态快照：在关键操作点创建完整的状态快照，而不是依赖增量式的状态记录。

经验总结

这个案例给我们带来了几个重要的经验教训：

1. 在开发复杂编辑工具时，需要特别注意UI控件与核心功能之间的交互边界。

2. 撤销/重做系统的设计必须考虑所有可能的用户操作路径，特别是那些涉及焦点转移的操作序列。

3. 状态管理应该采用统一的方式，避免不同组件各自维护状态导致的不一致。

通过解决这个问题，Super Splat的场景编辑功能变得更加稳定可靠，为用户提供了更流畅的3D场景编辑体验。