# 在编辑器中协作 (/zh/editor/collaborate)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 1215 · updated: 2026-09-23 -->
Related: [如何使用编辑器](/zh/editor/tutorial.md), [创建和编辑页面](/zh/editor/pages.md), [发布更改](/zh/editor/publish.md), [审阅更改](/zh/editor/review.md), [询问智能体](/zh/editor/agent.md), [编辑器的 AI 与发布设置](/zh/editor/settings.md)

你可以通过对页面发表评论、提出建议或同时协同编辑，来与团队一起处理页面。

<div id="comments">
  ## 评论 [#评论]
</div>

<Info>
  所有[角色](/zh/dashboard/roles)都可以评论、回复和解决线程。
</Info>

评论让你可以针对特定文本留下反馈，而无需修改内容。

**评论永远不会进入你的仓库。** 它们仅存在于编辑器中，不会包含在已发布的站点里，也不会提交到 Git。如果你的分支有打开的 pull request，Mintlify 会在其描述中添加未解决线程的摘要，并附上指向每条评论的链接。该摘要会随线程的变化而更新。

若要添加评论，请选中文本并点击工具栏中的 <Icon icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M12 20.5C19.1328 20.5 22 16.4706 22 11.5C22 6.52944 20.1328 2.5 12 2.5C4.13281 2.5 2 6.52944 2 11.5C2 13.5712 2.37034 15.4791 3.37161 17C4.63281 19 3.99253 20.8333 3 21.5C4.61547 21.5 5.70211 20.9858 6.39239 20.4766C6.88252 20.115 7.50688 19.9364 8.0984 20.0815C9.20689 20.3533 10.4991 20.5 12 20.5Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M12.1248 11.5H11.9998M16.125 11.5H16M8.125 11.5H8M12.2498 11.5C12.2498 11.6381 12.1379 11.75 11.9998 11.75C11.8618 11.75 11.7498 11.6381 11.7498 11.5C11.7498 11.3619 11.8618 11.25 11.9998 11.25C12.1379 11.25 12.2498 11.3619 12.2498 11.5ZM16.25 11.5C16.25 11.6381 16.1381 11.75 16 11.75C15.8619 11.75 15.75 11.6381 15.75 11.5C15.75 11.3619 15.8619 11.25 16 11.25C16.1381 11.25 16.25 11.3619 16.25 11.5ZM8.25 11.5C8.25 11.6381 8.13807 11.75 8 11.75C7.86193 11.75 7.75 11.6381 7.75 11.5C7.75 11.3619 7.86193 11.25 8 11.25C8.13807 11.25 8.25 11.3619 8.25 11.5Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> **Comment** 图标，或按 <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>M</kbd>（macOS）或 <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>M</kbd>（Windows）。

<Frame>
  <img src="/_assets/5f3a7d200ec813d19b910c5e46c4b6748fc574909296ae1929b652275925fbc8" alt="编辑器中所选文本上方浮动工具栏里的评论按钮。" className="dark:hidden" />

  <img src="/_assets/ebcb9c5b53a3a0a99e26de42e148addddfa55c4eb0079ce2259788e8fd216d6d" alt="编辑器中所选文本上方浮动工具栏里的评论按钮。" className="hidden dark:block" />
</Frame>

在评论中输入 `@` 即可提及同事。对方必须是你所在组织的成员，并且已经接受邀请。在评论中提及同事时，对方会收到电子邮件通知。你可以在仪表板的[通知](/zh/dashboard/notifications)页面管理接收哪些评论和建议邮件。

评论线程在可视化模式和 source 模式下都可见。在 source 模式下，你可以阅读、回复和解决已有的线程，但要发起新评论则需要进入可视化模式。

若要查看当前页面上的所有线程：

1. 点击页面右上角的 <Icon icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M12 12.002H12.5M19 12.002H19.5M5 12.002H5.5M12 13.002C12.5523 13.002 13 12.5542 13 12.002C13 11.4497 12.5523 11.002 12 11.002C11.4477 11.002 11 11.4497 11 12.002C11 12.5542 11.4477 13.002 12 13.002ZM19 13.002C19.5523 13.002 20 12.5542 20 12.002C20 11.4497 19.5523 11.002 19 11.002C18.4477 11.002 18 11.4497 18 12.002C18 12.5542 18.4477 13.002 19 13.002ZM5 13.002C5.55228 13.002 6 12.5542 6 12.002C6 11.4497 5.55228 11.002 5 11.002C4.44772 11.002 4 11.4497 4 12.002C4 12.5542 4.44772 13.002 5 13.002Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> **More options**。
2. 点击 **Comments**。

对评论添加回应可以在不回复的情况下表示已读。将鼠标悬停在评论上，点击 **Add reaction** 按钮，然后选择一个表情符号。对他人的评论做出回应时会通知该评论的作者。

若要编辑或删除你自己写的评论，请在该评论上点击 **More actions**。你只能编辑和删除自己的评论。删除线程中的第一条评论会删除整个线程。

<div id="suggestions">
  ## 建议 [#建议]
</div>

建议会在保留当前内容的前提下提出更改，便于同事接受或拒绝。

Editors 和 admins 可以接受或拒绝任何建议，viewers 不能。

若要提出建议，请选中文本并点击工具栏中的 **Switch to suggesting**，或按 <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>E</kbd>（macOS）或 <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>E</kbd>（Windows）。在建议模式下，顶部栏会显示 **Suggesting** 标签，你的删除和插入会以高亮文本的形式显示，而不会直接修改内容。点击该标签即可回到编辑状态。待处理的建议会显示在页面旁边和评论面板中。

<Note>
  [Viewers](/zh/dashboard/roles) 始终处于建议模式。viewer 打开编辑器时会自动进入建议模式，这样他们就可以在不直接修改内容的情况下提出更改。
</Note>

点击高亮显示的建议，然后点击 **Accept suggestion** 或 **Reject suggestion**。无论选择哪一项，该建议线程都会被解决。被接受的更改会成为当前分支的一部分，并在你下次[发布](/zh/editor/publish)时上线。

<div id="ask-the-mintlify-agent">
  ## 询问 Mintlify 智能体 [#询问-mintlify-智能体]
</div>

在评论、建议或回复中提及 `@mintlify`，即可就当前页面向[编辑器智能体](/zh/editor/agent)提问。智能体会在后台运行，并以该页面、线程和分支作为上下文，然后把回答作为回复发布到同一线程中。

```text
@mintlify does this endpoint support pagination?
@mintlify are there any pages that contradict this?
```

智能体在回复评论时以只读模式运行。它可以搜索你的文档、阅读页面、获取网页内容并加载 skills，但无法编辑内容、创建建议或发布。若要进行修改，请直接打开[编辑器智能体](/zh/editor/agent)。

对于已有访问权限的成员，提及功能在私有页面上同样有效。

<div id="real-time-editing">
  ## 实时编辑 [#实时编辑]
</div>

当多人在同一分支上打开同一页面时，他们会协同编辑。每个人的光标和编辑对所有人可见，工具栏中会显示头像。

实时编辑在可视化模式和 source 模式下均可用。你可以在 source 模式下编辑 MDX，同时同事在同一页面上使用可视化模式工作。对方的光标和选区会出现在你的编辑器中，你的光标和选区也会出现在对方的编辑器中，包括标题和描述字段。

* 所有协作者的更改会自动合并。两人编辑同一部分不会产生冲突。
* 撤销只影响你自己的编辑。
* 如果你断开连接，编辑会保存在本地，并在重新连接时同步。
* 在 source 模式下，无效的 MDX 或 frontmatter YAML 会保留在你本地，直到你修复它。同事只会收到有效的内容，而无效的 MDX 会[阻止发布](/zh/editor/publish#invalid-mdx-blocks-publishing)，直到问题被修复。

当 [Mintlify 智能体](/zh/agent)通过 API 或 MCP 编辑页面时，它会像其他协作者一样出现，带有头像和位于其最近编辑位置的实时光标。智能体完成后，光标会自动消失。