> 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.md).

# 变更请求

通过变更请求协作编辑内容

变更请求是您主要内容的副本。它基于分支的概念，熟悉 GitHub 中使用 Pull Request 或 GitLab 中使用合并请求的任何人都会觉得很熟悉。

在变更请求中，您可以编辑、更新和删除内容，对您的更改请求审阅，然后将它们合并回您的主版本。

要浏览和管理站点中的未处理变更请求，请参阅 [变更请求页面](https://gitbook.com/docs/documentation/zh/collaborate/change-requests/change-requests-screen.md).

<figure><img src="https://2111890564-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNkEGS7hzeqa35sMXQZ4X%2Fuploads%2Fgit-blob-6c42a248be934280f9e37216a5fa95d1142a5d24%2F25_12_10_collaboration_change_requests%402x.png?alt=media" alt="A GitBook screenshot showing the change requests panel"><figcaption><p>通过变更请求编辑您的内容。</p></figcaption></figure>

### 在差异视图中审阅更改 <a href="#diff-mode" id="diff-mode"></a>

打开 **变更** 选项卡，查看变更请求中的编辑内容。你可以结合上下文查看所有页面，也可以只查看已更改的页面。

变更请求的标题会以 Git 风格显示变更规模：新增、修改和删除的数量，例如 **+12 Δ3 −6**，并用彩色进度条展示各项所占比例。审阅者无需打开变更内容，就能分辨这是修正拼写错误还是全面重写。

审阅时，侧边栏会以以下形式跟踪你的进度： **已查看 N / M**。审阅完每个页面后，勾选 **已查看** 。

在编辑器底部，浮动差异导航器可让您在已更改的块之间跳转，继续前往带有差异的下一页，并使用可用的审阅操作从最后一次更改处完成审阅。

{% hint style="info" %}
默认情况下，更改会以“分屏视图”显示。左侧显示页面的“之前”版本，右侧显示“之后”版本。如果您更喜欢在单列布局中以内联方式查看更改，请单击目录面板右上角的差异模式按钮。
{% endhint %}

### 创建并合并变更请求

{% stepper %}
{% step %}

### 打开变更请求

要编辑内容，请打开一个变更请求。您可以通过以下几种方式打开：

* 点击 **编辑** （位于某个部分的右上角）。
* 请 GitBook Agent 代您创建一个。
* 当 GitBook Agent 检测到文档缺口时，可能会自动创建一个。

如果您手动打开，GitBook 会创建该变更请求并在编辑器中将其打开。
{% endstep %}

{% step %}

### 进行您的更改

直接在编辑器中编辑内容，或与 GitBook Agent 协作。

在继续之前先审阅您的更改。您可以继续编辑，直到准备好请求审阅。
{% endstep %}

{% step %}

### 请求审阅

打开 **概览** 选项卡，然后为一位或多位审核者添加标签。

审阅者可以批准您的更改、发表评论或请求进一步编辑。如果您未标记任何人，则该部分中具有审阅者权限的所有人都会收到通知。如果该部分没有审阅者，则会通知编辑和管理员。

如果有人请求更改，请在合并之前更新该变更请求。您也可以请 GitBook Agent 审阅该变更请求。
{% endstep %}

{% step %}

### 合并

变更请求获批后，打开 **概览** 选项卡，然后点击 **合并**.

GitBook 会立即将更改应用到您的在线文档。如果您的部分使用合并规则，GitBook 会在合并前进行检查。

合并无法撤销。要还原或调整内容，请打开一个新的变更请求。
{% endstep %}
{% endstepper %}

### 使用变更请求

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>变更请求界面</strong></td><td>查看并管理整个组织中的变更请求</td><td><a href="https://gitbook.com/docs/documentation/zh/collaborate/change-requests/change-requests-screen.md">变更请求界面</a></td></tr><tr><td><strong>空间中的变更请求</strong></td><td>在单个空间中创建并审阅变更请求</td><td><a href="https://gitbook.com/docs/documentation/zh/collaborate/change-requests/change-requests-in-a-space.md">分区中的变更请求</a></td></tr></tbody></table>


---

# 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.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.
