基本介绍

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

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

效果截图

依赖与前置条件

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

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

功能清单

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

使用场景

• 阶段里程碑：立项、评审通过、验收、发布等节点保存版本
• 审批流节点：提交审批前保存版本，审批通过后再保存“通过版”
• 对外交付：把交付前的状态固化为版本，便于后续追责与复盘
• 回滚救援：误改或协作冲突后快速恢复到稳定版本
• 发布对比：对比两个里程碑版本，快速定位变更点
• 多分支方案：保存多个方案版本，便于评审选择与合并
• 长周期文档：阶段性冻结版本，避免迭代过程中“找不到当时内容”
• 合规归档：对外发布前保存“归档版本”，作为长期留存依据
• 进度周报：每周固定创建版本，形成连续演进轨迹
• 大改前保护：重构/改版前先创建版本，降低风险

与其他功能协同使用

多人协作（collaboration）

• 历史版本依赖协作，建议把版本作为协作流程的“里程碑工具”：多人协作编辑
• 与服务端存储结合，可将版本信息与业务流程节点关联：Umo Editor Server

文档修订（revision）

• 修订用于过程审阅，版本用于里程碑固化：先修订定稿，再创建验收版本：文档修订
• 需要“保留审阅痕迹”的节点，可在定稿前创建版本作为留档

文档批注/评论（comments）

• 将评论作为评审记录沉淀到版本节点（可选是否包含评论）：文档批注/评论

导出（export）

• 在关键版本节点导出 PDF/Word 做归档与对外交付：文档导出

使用方式

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

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

重要版本是什么

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

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