基本介绍

文档历史版本管理用于在多人协作编辑过程中，将某一时刻的文档状态保存为“版本”，并支持版本列表展示、版本预览、版本对比以及回溯恢复。

你可以把它理解为：给协作文档加上一套“可命名的里程碑 + 可回退的时间点”。

效果截图

依赖与前置条件

历史版本功能依赖多人协作能力，请先完成：

• 多人协作接入：多人协作编辑
• 服务端部署与配置：Umo Editor Server

功能清单

• 手动创建版本（把当前文档保存为一个可命名的版本）
• 版本预览（查看某个版本的内容，不影响当前文档）
• 版本对比（对比两个版本的差异）
• 回溯恢复（将文档恢复到某个版本，并同步给协作者）
• 版本信息展示（创建人、创建时间等）
• 重要版本标记（将关键版本标为“重要”，便于筛选与识别）

使用方式

历史版本主要通过三类入口使用：

• 配置：通过 options.versions 开启/调整版本功能（见 配置项）
• 方法：对外暴露文档版本管理相关方法，用于从编辑器外部创建版本、获取版本、恢复版本、清空版本等（见 配置与方法）
• 界面：内置“历史版本面板”，提供创建、预览、对比与恢复（见 快速开始）

重要版本是什么

“重要版本”用于标记关键里程碑（例如阶段验收、对外发布、提交流程节点等）：

• 在历史版本列表中会显示“重要”标签，便于快速识别
• 可在版本条目的更多操作中切换“标为重要 / 取消重要”