# 审阅更改 (/zh/editor/review)

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

在更改进入你的线上站点之前先进行预览、请求审阅你的 pull request，并在编辑器中合并它。

<div id="live-preview">
  ## 实时预览 [#实时预览]
</div>

实时预览会在你编辑时渲染站点，无需构建步骤。在 **Site** 标签页中，点击顶部栏中的 <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;M18.8906 12.846C18.5371 14.189 16.8667 15.138 13.5257 17.0361C10.296 18.8709 8.6812 19.7884 7.37983 19.4196C6.8418 19.2671 6.35159 18.9776 5.95624 18.5787C5 17.6139 5 15.7426 5 12C5 8.2574 5 6.3861 5.95624 5.42132C6.35159 5.02245 6.8418 4.73288 7.37983 4.58042C8.6812 4.21165 10.296 5.12907 13.5257 6.96393C16.8667 8.86197 18.5371 9.811 18.8906 11.154C19.0365 11.7084 19.0365 12.2916 18.8906 12.846Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" /> **Preview**。预览会全屏打开。点击 **Refresh preview** 可重新加载，或点击 **Close preview** 返回编辑器。若要改为在新的浏览器标签页中打开预览，请开启 [Open live preview in new tab](/zh/editor/settings#appearance)。

若要编辑站点设置并查看其对内容的影响，请点击预览工具栏中的 **Site settings**，然后选择一个配置分区。

若要在预览旁边打开[智能体](/zh/editor/agent)，请点击预览工具栏中的 **Ask agent**。只有 editors 和 admins 才能在实时预览中使用智能体。

<Note>
  实时预览仅适用于公开站点以及受 Mintlify 认证保护的站点。
</Note>

<div id="preview-deployments">
  ## 预览部署 [#预览部署]
</div>

当你的 feature branch 存在 pull request 时，Mintlify 会构建一个预览部署：一个临时 URL，你的更改会在其中以发布后完全一致的方式呈现。每当编辑器向该分支提交新更改时，预览都会重新构建。该 URL 由你项目的子域名和分支名称组合而成：`<subdomain>-<branch-name>.mintlify.site`。你可以在 Mintlify 机器人的 pull request 评论中找到确切的 URL。

预览 URL 默认可公开访问。若要将访问权限限制为你的 Mintlify 组织成员，请在仪表板的[常规](https://app.mintlify.com/settings/deployment/general)页面的 **Previews** 分区中启用预览认证。更多信息请参阅[限制预览部署的访问权限](/zh/deploy/preview-deployments#restrict-access-to-preview-deployments)。

<div id="which-preview-to-use">
  ## 该使用哪种预览 [#该使用哪种预览]
</div>

| 功能       | 实时预览    | 预览部署      |
| -------- | ------- | --------- |
| **速度**   | 即时      | 需要构建      |
| **访问方式** | 在编辑器内   | 可共享的 URL  |
| **适用场景** | 编辑时审阅更改 | 与团队共享以供审阅 |
| **可用时长** | 编辑器打开期间 | 只要该分支存在   |

<div id="share-an-editor-link">
  ## 共享编辑器链接 [#共享编辑器链接]
</div>

若要把同事引导到分支上的某个特定页面，请点击页面右上角的 <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**，然后点击 **Copy link**。任何有权访问你 Mintlify 组织的人都可以在自己的编辑器会话中打开该链接。

<div id="review-and-merge-pull-requests">
  ## 审阅并合并 pull request [#审阅并合并-pull-request]
</div>

当你的分支存在 pull request 时，发布菜单会显示其已更改的文件和审阅状态，例如 **Draft in progress**、**Review required**、**Changes requested** 或 **Approved**。点击 **View request** 可在你的 Git 提供方中打开该 pull request。

1. 点击顶部栏中的 **Publish**，然后点击 **Request review**。这会将 pull request 标记为可供审阅。
2. 审阅者在你的 Git 提供方中批准 pull request。
3. 点击 **Publish**，然后点击 **Merge and publish**。编辑器会合并 pull request，部署你的更改，并把你切换回 deployment branch。

如果 Mintlify 托管你的仓库并且不要求审批，发布菜单会改为显示 **Publish**，一步完成合并和部署。

<Tip>
  在你的 Git 提供方中配置分支保护规则以要求使用 pull request。请参阅 GitHub 帮助中的 [About protected branches](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches)，或 GitLab 帮助中的 [Protected branches](https://docs.gitlab.com/user/project/repository/branches/protected/)。
</Tip>

<div id="compare-changes-before-merging">
  ### 合并前比较更改 [#合并前比较更改]
</div>

在发布菜单中点击任意已更改的文件，即可在 diff 视图中将其与已发布版本进行比较。若要退出 diff 视图，请点击顶部栏中的 **Viewing changes**，或按 <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>D</kbd>（macOS）或 <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>D</kbd>（Windows）。可视化模式会显示可视化 diff，source 模式会显示文本 diff。无法显示 diff 的文件（例如图片或已删除的文件）会出现在列表中，但无法点击。

出现在分支 diff 中的[隐藏页面](/zh/organize/hidden-pages)也可以从发布菜单中打开，即使它们并未出现在站点导航中。

<div id="pull-request-titles-and-descriptions">
  ### pull request 的标题和描述 [#pull-request-的标题和描述]
</div>

pull request 的标题来自你的分支标题。

如果你的分支存在打开的评论线程，Mintlify 会把这些线程的摘要添加到 pull request 描述中。请参阅[协作](/zh/editor/collaborate#comments)。

<div id="review-an-automation-run">
  ## 审阅自动化运行 [#审阅自动化运行]
</div>

当[自动化](/zh/automations)打开 pull request 时，你可以在该自动化的分支上打开编辑器：

* 在 Slack 通知或通知邮件中，点击 **View changes**。编辑器会在该自动化的分支上以 diff 视图打开，[智能体](/zh/editor/agent#continue-an-automation-run)会在旁边打开，并带有该自动化所做工作的上下文。
* 在仪表板的 Automations 页面的 **Runs** 标签页中，打开某次运行的操作菜单并选择 **Open in editor**。

若要改为打开该自动化的预览部署，请在该运行上点击 **Preview**。