> For the complete documentation index, see [llms.txt](https://gitbook.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gitbook.com/docs/documentation/zh/collaborate/change-requests/change-requests-in-a-space.md).

# 分区中的变更请求

了解如何在分区中协作处理单个变更请求——包括如何审查、解决冲突和合并

当你位于某个 [板块](https://gitbook.com/docs/documentation/zh/can-kao/concepts.md#space)中时，可以通过发起新的变更请求来进行修改，也可以浏览现有的变更请求，了解其他人正在处理的内容。

### 创建更改请求

点击 **编辑** 按钮，位于 [板块标题栏](https://gitbook.com/docs/documentation/zh/can-kao/gitbook-ui.md#space-header) 中，即可发起新的变更请求。

这将打开一个新的更改请求，你可以根据需要编辑或删除内容。你的更改会自动保存，其他人也可以加入你的更改请求，实时协作。

创建更改请求时，你可以添加标题和描述，以提供有关你所做更改的更多上下文。

你还可以将更改请求链接到来源，包括：

* Linear 问题
* GitHub 拉取请求或问题
* Jira 工单
* 通用 URL

这些链接会显示在更改请求中，方便审阅者追溯工作来源。

对更改满意后，可以使用标题栏中的按钮来 [**请求审核**](#request-a-review-on-a-change-request) 你的变更请求，或者 [**合并**](#merging-a-change-request) 直接将其合并到主分支。

#### 使用 GitBook Agent 创建更改请求

[GitBook Agent](https://gitbook.com/docs/documentation/zh/gitbook-dai-li/overview.md) 是一位 AI 队友，可以根据你提供的指示 [规划并实施变更请求](https://gitbook.com/docs/documentation/zh/gitbook-dai-li/write-and-edit-with-ai.md#implement-a-change-request-with-gitbook-agent) 。

要使用 GitBook Agent 新建变更请求，请点击 **编辑** 在分区标题中，描述您想要进行的更改，然后点击 **使用 GitBook Agent 实施**.

你可以让它执行的一些任务包括：

* 添加使用示例
* 提升页面 SEO
* 提高清晰度
* 检查一致性
* 修正错别字和拼写错误
* 链接相关内容
* \+ 更多

前往 [使用 GitBook Agent 撰写](https://gitbook.com/docs/documentation/zh/gitbook-dai-li/write-and-edit-with-ai.md) 了解更多。

### 预览更改请求

点击 **预览** 选项，即可预览你在变更请求中所做的更改。该选项位于 [板块标题栏](https://gitbook.com/docs/documentation/zh/can-kao/gitbook-ui.md#space-header)中。此操作会切换到已发布文档的预览，其中包含拟议的更改，让你可以在已发布文档的完整上下文中查看这些更改。

在 **预览** 按钮下方是网站预览网址。点击该网址，网站预览就会在新标签页中完整打开。

在新标签页中打开预览网址时，你还会在浏览器窗口底部看到 [预览工具栏](https://gitbook.com/docs/documentation/zh/manage-your-site/customization/toolbar-on-published-sites-and-site-previews.md) 。使用此工具栏，你可以快速返回 GitBook，查看、编辑或评论变更请求，也可以打开网站的在线版本。

{% hint style="info" %}
你只能预览已添加到 [已发布文档网站](https://gitbook.com/docs/documentation/zh/publish/publish-a-docs-site.md).
{% endhint %}

{% hint style="warning" %}
如果你的内容是通过分享链接或已认证访问发布的，预览功能不会出现。
{% endhint %}

### 请求审阅更改请求

当你想在将更改合并到主分支之前，请团队成员检查内容时，请对你的更改请求发起审阅请求。

点击 **概览** 选项卡，即可在板块标题栏中打开变更请求概览，其中包含你所做的所有更改的差异视图。

使用 **概览** 选项卡添加背景信息和审核者。若要在编辑器中检查差异，请切换到 **更改** 选项卡。在此视图中，存在差异的页面会显示指示标记，浮动的差异导航控件则可帮助你更快地在已更改的区块之间跳转。

在这里你可以为更改请求添加描述，为审阅者提供一些上下文，并标记你希望检查你工作的特定人员。

点击 **请求审核**后，变更请求的状态将变为 **审核中**，你在审核请求中标记的所有人都会收到通知。

如果你的更改无需审核，且你拥有相应的 [权限](https://gitbook.com/docs/documentation/zh/collaborate/member-management/roles.md)，并且没有任何阻止事项 [合并规则](https://gitbook.com/docs/documentation/zh/collaborate/merge-rules.md)，您也可以直接将更改合并到主版本中。

{% hint style="info" %}
[将 GitBook Agent 添加为审核者](https://gitbook.com/docs/documentation/zh/gitbook-dai-li/review-change-requests-with-gitbook-agent.md) 到您的更改请求中，它便可以检查内容中的拼写、语法和风格指南错误，提出改进建议等。
{% endhint %}

{% hint style="warning" %}
如果你在审阅请求中没有标记任何人，则该部分中具有审阅者权限的所有人都会收到通知。如果该部分没有审阅者，则审阅者之上的下一个角色会收到通知。
{% endhint %}

#### 差异视图 <a href="#diff-mode" id="diff-mode"></a>

如果页面包含差异，GitBook 还会显示一个居中的浮动指示器。点击它可滚动到第一个变更块或元素。

打开 **更改** 选项卡时，GitBook 会显示更改请求中编辑过的所有页面和内容块。GitBook 会在左侧显示先前版本，在右侧显示更新后的版本，方便您并排比较编辑内容。

包含差异的页面也会在目录中显示指示器，这使得大型更改请求更容易浏览。

在编辑器的 **更改** 选项卡中审核页面时，浮动的差异导航控件可帮助您快速跳转到已更改的内容块，无需滚动浏览整个页面。

使用差异视图时有两个选项：

1. **显示所有页面** — 这会在目录中显示已更改和未更改的页面，方便您结合整个版块的内容审核编辑。
2. **仅显示已更改的页面** — 这会仅显示修改过的页面，让您专注于已编辑的内容。

您可以切换到 **更改** 选项卡，查看任意更改请求的差异视图。

<div align="left"><figure><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-bcbf04adbcd5805dea739a8b0e020f4e9d5bd960%2FScreenshot%202026-07-02%20at%205.52.15%E2%80%AFPM.png?alt=media" alt="" width="188"><figcaption><p>这是“更改”屏幕底部的导航控件小组件</p></figcaption></figure></div>

### 合并更改请求

合并更改请求会将其中的更改加入内容的主分支，生成更新后的版本，并在版块的 [版本历史记录](https://gitbook.com/docs/documentation/zh/chuang-jian-nei-rong/version-control.md#see-the-activity-of-a-specific-draft).

如果您没有相应的 [权限](https://gitbook.com/docs/documentation/zh/collaborate/member-management/permissions-and-inheritance.md)，或者更改请求未通过组织或版块的 [合并规则](https://gitbook.com/docs/documentation/zh/collaborate/merge-rules.md).

### 更新更改请求

当你在更改请求中工作时，其他协作者可能正在修改该部分的主分支。这种情况下，你的更改请求会被视为“过时”——主分支上有你在更改请求中看不到的内容。

你可能希望将这些新内容拉入你的更改请求。如果出现以下情况，这会很有用：

* 你想看看当所有内容合并在一起后，你的更改和主分支上的内容会是什么样子。
* 你需要将拉取的内容作为更改请求的一部分进行修改。

您可以点击 **更新** 来执行此操作，该按钮位于更改请求页面的标题栏中。

按下 **更新**后，主分支中的所有内容都会拉取到你的变更请求中。更新时可能会遇到冲突——你可以在变更请求中解决这些冲突。冲突解决后，变更请求即视为已更新到最新状态，「更新」按钮也会消失。

如果主分支再次发生更改，你的更改请求又会变得过时，更新按钮会再次出现。

要求编辑者在合并前确保其变更请求已更新到最新状态，是一种很好的质量控制方式——这有助于作者检查变更请求合并后将进入主分支的确切内容。你可以通过以下方式强制执行此要求： [合并规则](https://gitbook.com/docs/documentation/zh/collaborate/merge-rules.md).

### 解决合并冲突

有时，当你想合并更改请求时，可能会发现主内容与你要合并的内容之间存在冲突。最简单地说，冲突是一段无法自动合并的内容。

如果发生这种情况，你会看到冲突警告，以及在继续合并之前需要解决的冲突列表。

解决合并冲突有两种方式： **选择要合并的版本** 或 **手动** **编辑内容**.

#### 选择要合并的版本

你可以通过选择要合并的版本来解决合并冲突——可以是传入的内容，或者之前存在的内容。这样你就可以在一种更改和另一种更改之间做出选择——要么是你最近的工作，要么是原始内容。

如果你处理的合并冲突可以通过这种方式解决，你可以选择要保留的版本，另一个版本将被删除。

#### 手动编辑

如果你不想在版本之间做选择，可以通过手动编辑冲突来解决合并冲突。你可以删除不需要的块，甚至完全重写它们。当你对更改满意后，可以继续处理下一个冲突，直到全部解决。

### 归档更改请求

你无法在 GitBook 中删除更改请求，但可以将其归档。

要归档更改请求：

1. 打开 **更改请求** 选项卡。
2. 点击你想要归档的更改请求。
3. 点击 **操作** 菜单 <picture><source srcset="broken://files/HXFvPsjDqbaBEhpH0WKJ" media="(prefers-color-scheme: dark)"><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-f73bf8251d7a6786ca6595b4593501e11512d107%2F25_02_04_actions_horizontal_1.svg?alt=media" alt="The Actions menu icon in GitBook"></picture> （位于更改请求标题旁边），然后选择 **归档**.

如需查找并重新打开已归档的更改请求，请打开 **更改请求** 菜单，然后点击 **已归档** 选项卡。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://gitbook.com/docs/documentation/zh/collaborate/change-requests/change-requests-in-a-space.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
