---
title: "评论"
description: "将 DOCX 评论导入为实时协作线程，将编辑器线程导出回 DOCX，并通过 Microsoft Word 在不重复的情况下往返处理评论。"
canonical_url: "https://tiptap.zhcndoc.com/conversion/content-types/structures-and-media/comments"
---

# 评论

将 DOCX 评论导入为实时协作线程，将编辑器线程导出回 DOCX，并通过 Microsoft Word 在不重复的情况下往返处理评论。

注释在整个转换往返过程中都受到支持。你可以导入一个包含注释的 `.docx`，在协作式 Tiptap 编辑器中实时处理这些注释，再将其导出回 `.docx`，并重新导入结果（包括在 Microsoft Word 中编辑之后），而不会出现重复。

## 支持概览

|             | 导入                         | 编辑器         | 导出      |
| ----------- | -------------------------- | ----------- | ------- |
| 评论          | 实时协作线程（或通过 REST API 提供的数据） | 读取、回复、解决、删除 | DOCX 评论 |
| 回复          | 保留，按顺序                     | 线程化         | 保留      |
| 已解决状态       | 保留                         | 切换          | 保留      |
| 作者、姓名首字母、日期 | 保留                         | 不适用         | 保留      |

## 工作原理

一个往返流程有三个阶段：

1. **导入**：`.docx` 中的每条评论都会变成一个线程，并锚定到它在 Word 中标记的同一段文本，同时保留其作者、姓名首字母、日期、回复（按顺序）以及已解决状态。
2. **编辑**：这些线程会在你的协作编辑器中实时存在：可以阅读、回复、解决或重新打开，以及删除。
3. **导出**：编辑器中的线程会作为原生 Word 评论写回到 `.docx` 中，并锚定到同一段文本。

重新导入已导出的文档时，会识别已经存在的评论并保持同步，而不是再次创建它们，即使文档在此期间曾在 Microsoft Word 中打开并编辑过。

## 导入

当导入经过 [Tiptap 访问控制](https://tiptap.zhcndoc.com/authentication.md) 验证并且目标是一个现有的协作文档时，评论会自动在该文档上注册为**实时线程**。文档打开后，它们即可立即阅读和回复，无需你额外接线。

> **实时评论线程需要 Team 套餐:**
>
> 注册实时线程会通过 [Comments REST API](https://tiptap.zhcndoc.com/comments/integrate/rest-api.md) 在 Tiptap Document Server 上创建它们，这需要 [Team 套餐](https://cloud.tiptap.dev/v2/billing) 或更高版本。导入会将你的访问令牌转发到 Document Server，因此低于 Team 套餐的账户会被拒绝，并且**不会创建实时线程**。不过导入本身仍会成功，并返回带有原始标识符的评论**数据**。将评论作为数据导入以及将评论导出为 DOCX 不受此要求影响。

从 Word 文档中保留的内容：

- **文本锚点**：线程会附加到评论在 Word 中标记的同一段文本范围。
- **作者、首字母缩写和日期**：显示在每条评论上。
- **回复**：多条评论的对话会保持顺序：先是原始评论，然后是回复。
- **已解决状态**：在 Word 中标记为已解决的线程会以已解决状态导入。

如果导入未通过协作认证，或者目标不是协作文档，则导入仍会成功，评论会作为带有原始标识符的数据返回，由你自行处理。有关集成细节，请参见 [import editor extension](https://tiptap.zhcndoc.com/conversion/import/docx/editor-extension.md) 和 [import REST API](https://tiptap.zhcndoc.com/conversion/import/docx/rest-api.md)；有关配置编辑器以渲染导入内容，请参见 [ConvertKit](https://tiptap.zhcndoc.com/conversion/import/docx/convertkit.md)。

> **实时线程需要协作:**
>
> 只有当导入经过访问控制认证并指向协作文档时，评论才会变成可编辑的实时线程。其他所有导入都会返回带有原始标识符的评论数据，并且行为与之前完全相同。

## 编辑器

导入的评论是标准的 Tiptap 协作线程。使用编辑器中的评论扩展，你可以阅读每个线程、回复、解决或重新打开它，并删除它；这些更改会在导出时得到反映。

在编辑器中实时创建的评论（不是从 DOCX 导入的）同样也是一等公民：它们会与导入的评论一起导出到 DOCX，并且不会在之后重新导入时被更改或移除。

## 导出

你的编辑器的评论线程会作为原生 Word 评论写入导出的 `.docx` 中。每个线程都会成为锚定到相应文本的评论，回复会按顺序作为线程式对话保留，已解决的线程也会作为已解决状态导出。每条评论都会携带作者和日期。有关设置，请参阅 [导出编辑器扩展](https://tiptap.zhcndoc.com/conversion/export/docx/editor-extension.md)。

评论中的文本会保留其基本格式（例如粗体、斜体、链接和换行）。评论正文旨在用于讨论文本；放在评论中的非常丰富的块级内容可能会被简化。

## 完整往返

这就是重点：你可以把文档完整地来回往返，而不会让你的评论发生偏移。

1. 将带有评论的 `.docx` 导入到协作文档中。
2. 实时阅读、回复、解决并添加评论。
3. 导出为 `.docx`。
4. 可选地在 Microsoft Word 中打开并编辑这些评论。
5. 将文档重新导入到同一个协作文档中。

在重新导入时：

- **不会重复。** 已经存在的评论会被识别并保留，不会再次创建。
- **编辑会同步。** 如果某条评论的文本发生了变化，现有线程会更新以匹配。
- **新评论只会导入一次。** 在往返过程中于 Word（或其他地方）添加的评论，会作为一条新的评论导入，并进入正确的线程。
- **删除会被清理。** 从文档中删除的评论会在下一次导入时移除。
- **已解决/重新打开状态会随文档同步。** 解决或重新打开某条评论的状态会在重新导入时体现出来。
- **你的实时评论会受到保护。** 直接在编辑器中创建的评论绝不会因重新导入而被更改或删除；只有源自 DOCX 导入的评论才会保持同步。

> **可在 Microsoft Word 中继续保留:**
>
> 每次保存文档时，Microsoft Word 都会重新组织其内部的评论记录。该往返机制正是围绕这一点设计的，因此你可以在 Word 中编辑导出的评论并重新导入，而不会产生重复项。

> **最佳实践：一个 DOCX 对应一个协作文档:**
>
> 保持导入的 `.docx` 与你将其导入的协作文档之间的一对一映射。重新导入时，会将评论与**该**文档上已经存在的线程进行协调，因此如果把多个不同的 DOCX 文件导入到同一个共享文档中，它们的评论会混在同一个界面上。这本身不应该造成问题，但为每个 DOCX 单独分配一个协作文档，可以让你协作式地迭代其评论（添加、回复、解决，以及通过 Word 来回往返），并且不会有重新导入触及来自其他文件的评论的风险。这是一个简单的安全措施，可确保迭代过程干净且可预测。

## 预期效果

- 将带有批注的 `.docx` 导入到协作文档中后，您可以获得带有作者、日期、回复和已解决状态的实时讨论串，且这些信息都会保留。
- 导出时会生成原生的 Word 批注，可在 Microsoft Word 和其他兼容 Word 的编辑器中正常打开。
- 重新导入时，批注会保持同步（添加、更新、解决、移除），而不是重复创建，即使在 Word 中编辑过之后也是如此。

## 什么不起作用

- **实时线程需要协作和 Team 方案。** 如果没有访问控制身份验证和一个目标协作文档，评论会作为数据返回，而不是创建为实时线程。创建实时线程还需要 [Team 方案](https://cloud.tiptap.dev/v2/billing) 或更高版本，因为它使用了 Document Server 的 [Comments REST API](https://tiptap.zhcndoc.com/comments/integrate/rest-api.md)。
- **无重复重新导入仅适用于由 Tiptap 导出的文档。** 其他地方生成的 `.docx` 每次导入时都会重新导入其评论；这些评论绝不会与无关的线程合并。这是有意为之：它可以防止来自不同文档的评论被彼此混淆。
- **评论锚定在文本上。** 评论绑定到它所标记的文本范围。如果该文本被删除，评论的锚点也会随之删除，这与任何文字处理软件中的行为相同。
- **评论内容用于讨论文本。** 基本的行内格式会被保留；评论中的复杂块级内容在转换时可能会被简化。