Excalidraw 历史记录持久化方案探讨

Excalidraw 作为一款优秀的开源白板工具，其撤销/重做功能是用户体验的重要组成部分。本文将深入探讨如何实现 Excalidraw 历史记录的持久化存储与恢复。

历史记录机制解析

Excalidraw 内部使用 delta（增量）方式记录用户操作历史。这种设计意味着：

1. 撤销栈(undoStack)和重做栈(redoStack)存储的是操作差异而非完整状态
2. 每次操作都会生成对应的历史记录条目
3. 系统通过应用/反应用这些差异来实现撤销重做功能

当前技术限制

目前 Excalidraw 官方尚未提供直接的历史记录初始化或持久化API。在开发环境中，可以通过访问 window.h.history 对象来获取和修改历史记录栈，但这在生产环境中不可用。

潜在解决方案

1. 官方API扩展方案

最理想的解决方案是等待官方提供以下API：

• 获取当前历史记录状态的方法
• 初始化历史记录的方法
• 历史记录变更事件监听

2. 临时解决方案

对于急需此功能的开发者，可以考虑：

1. 修改源码：直接修改 Excalidraw 源码，暴露历史记录相关接口
2. 状态快照：虽然不完美，但可以保存完整场景状态，在恢复时重新生成操作历史
3. 自定义历史管理：在应用层实现自己的历史记录管理，与Excalidraw同步

应用场景分析

历史记录持久化在以下场景中尤为重要：

1. 多标签/多缓冲应用：如提问者提到的多缓冲编辑器
2. 离线优先应用：确保用户在网络不稳定时不会丢失操作历史
3. 协作应用：需要同步不同客户端的操作历史

实现建议

对于桌面应用开发者（如使用Tauri）：

1. 可以结合文件系统存储实现历史记录持久化
2. 需要处理历史记录与场景状态的同步问题
3. 应考虑历史记录压缩策略以避免存储过大

未来展望

随着Excalidraw的持续发展，历史记录管理API很可能会成为官方功能的一部分。在此之前，开发者需要权衡各种解决方案的利弊，选择最适合自己项目的方式。

对于需要立即实现的开发者，建议关注Excalidraw的GitHub仓库，及时获取API更新信息，同时可以考虑向官方提交功能请求，推动此功能的标准化实现。