排障指南

1. 为什么审阅面板看不到修订记录？

常见原因是标记视图处于 final 或 original，此时修订记录列表会隐藏。切换到：

• final-markup 或 original-markup

即可显示修订记录列表。

2. 为什么编辑后没有产生新的修订？

请优先检查以下状态：

• revision.enabled 是否为 true（未启用时不会注册修订能力）
• 当前“记录修订”是否已开启（可通过工具栏审阅分组切换）
• revision.defaultEnabled 仅控制初始化默认状态，运行中仍可被手动关闭

3. 为什么无法接受/拒绝修订？

检查以下配置与状态：

• revision.allowAcceptReject 是否为 true
• 文档是否处于只读（document.readOnly === true）
• 编辑器是否可编辑（例如协作/演示模式导致不可编辑）

5. 为什么修订人为空？

请确保为每个客户端设置了 options.user.id 与 options.user.name。

6. 为什么导出后仍然带着修订标记？

• 修订标记属于正文内容的一部分：默认保存/导出（HTML、JSON、DOCX 等）会携带修订标记。
• final / original 仅是“显示隐藏”，不会自动移除修订标记。
• 导出 Word 时，可在工具栏弹框中取消勾选“导出修订”，也可以通过 exportDocx({ exportRevisions: false }) 关闭修订导出。

如果你要导出“真正的最终稿”（不包含修订标记），建议导出前先完成定稿：

editorRef.value.acceptAllRevisions()

7. 为什么导出的 Word 修订显示不完整？

• 当前 Word 导出可直接承接文本修订，并支持部分常见节点级修订；更复杂的节点修订可能会被降级为普通内容。
• 不同办公软件对修订标记的显示兼容性存在差异；如需核对修订结果，建议优先使用 Microsoft Word 打开导出的 docx 文件。