> 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/collaboration/change-requests/change-requests-in-a-space.md). # 章节中的变更请求 当你处于一个 [部分](/docs/documentation/zh/zi-yuan/concepts.md#space)时，你可以通过打开一个新的变更请求来进行更改，或者浏览现有的变更请求，看看其他人在处理什么。 ### 创建变更请求 点击 **编辑** 中的按钮 [章节标题](/docs/documentation/zh/zi-yuan/gitbook-ui.md#space-header) 来开始一个新的变更请求。 这将打开一个新的变更请求，你可以根据需要编辑或删除内容。你的更改会自动保存，其他人也可以加入你的变更请求，与您实时协作。 在创建变更请求时，你可以添加标题和描述，以提供更多关于你所做更改的上下文。 你也可以将变更请求链接到来源，包括： * Linear 问题 * GitHub 拉取请求或问题 * Jira 工单 * 通用 URL 这些链接会显示在变更请求中，因此审阅者可以追溯到工作的来源。 当你对更改满意后，可以使用标题栏中的按钮来 [**请求审阅**](#request-a-review-on-a-change-request) 变更请求的，或者 [**合并**](#merging-a-change-request) 直接合并到主分支。 #### 使用 GitBook Agent 创建变更请求 [GitBook Agent](/docs/documentation/zh/gitbook-agent/what-is-gitbook-agent.md) 是一个 AI 队友，可以 [规划并实施变更请求](/docs/documentation/zh/gitbook-agent/write-and-edit-with-ai.md#implement-a-change-request-with-gitbook-agent) 根据你给它的任何指令。 要使用 GitBook Agent 打开一个新的变更请求，请点击右上角“编辑”按钮旁边的 GitBook Agent 图标，并告诉 GitBook 你想实施的任何更改。 你可以让它做的一些事情包括： * 添加使用示例 * 提升页面 SEO * 增强清晰度 * 检查一致性 * 修复错别字和拼写错误 * 链接相关内容 * \+ 更多 前往 [使用 GitBook Agent 写作](/docs/documentation/zh/gitbook-agent/write-and-edit-with-ai.md) 以了解更多。 ### 预览变更请求 你可以通过点击 **预览** 中的选项 [章节标题](/docs/documentation/zh/zi-yuan/gitbook-ui.md#space-header)。这将切换到包含建议更改的已发布文档预览，因此你可以在已发布文档的完整上下文中查看更改。 在……下方 **预览** 按钮是你的网站预览 URL。点击它，你的网站预览将会在新标签页中完整打开。 当你在新标签页中打开预览 URL 时，你还会看到 [预览工具栏](/docs/documentation/zh/collaboration/toolbar-on-published-sites-and-site-previews.md) 位于浏览器窗口底部。此工具栏可让你快速返回 GitBook，以查看、编辑或评论该变更请求，或打开你网站的实时版本。 {% hint style="info" %} 你只能预览添加到 [已发布的文档站点](/docs/documentation/zh/docs-site/publish-a-docs-site.md). {% endhint %} {% hint style="warning" %} 如果你的内容是通过分享链接或经过身份验证的访问方式发布的，预览功能将不会显示。 {% endhint %} ### 请求审阅变更请求 当你想在将更改合并到主分支之前，请团队成员检查你的内容时，可以对你的变更请求发起审阅请求。 点击 **概览** 部分标题栏中的选项卡，可打开你的变更请求概览——包括你在差异视图中所做的所有更改。 使用 **概览** 选项卡来添加上下文和审阅者。要在编辑器中检查差异，请切换到 **更改** 选项卡。在该视图中，带有差异的页面会显示指示标记，悬浮的差异导航控件可帮助你更快地在已更改的区块之间跳转。 在这里，你可以为变更请求添加描述，为审阅者提供一些上下文，并标记你希望检查你工作内容的特定人员。 当你点击 **请求审阅**时，变更请求的状态将变为 **审核中**，你在审阅请求中标记的任何人都会收到通知。 如果你的更改不需要审阅，你拥有适当的 [权限](/docs/documentation/zh/collaboration/member-management/roles.md)，并且没有任何阻止性的 [合并规则](/docs/documentation/zh/collaboration/merge-rules.md)，你也可以直接将更改合并到主版本中。 {% hint style="info" %} [将 GitBook Agent 添加为审阅者](/docs/documentation/zh/gitbook-agent/review-change-requests-with-gitbook-agent.md) 到你的变更请求中，它就可以检查你的内容中的拼写、语法和风格指南错误，并提出改进建议等。 {% endhint %} {% hint style="warning" %} 如果你在审阅请求中没有标记任何人，那么该部分中拥有审阅者权限的所有人都会收到通知。如果该部分没有审阅者，则其上一级角色会收到通知。 {% endhint %} #### 差异视图 如果页面包含差异，GitBook 还会显示一个居中的浮动指示器。点击它即可滚动到第一个已更改的块或元素。 当你打开 **更改** 选项卡时，GitBook 会显示变更请求中编辑的每个页面和块。GitBook 左侧显示之前的版本，右侧显示更新后的版本。这使得并排比较编辑内容更加容易。 包含差异的页面还会在目录中显示指示器，这让大型变更请求更容易浏览。 当你在编辑器的 **更改** 选项卡中审阅页面时，一个浮动的差异导航控件可帮助你更快地在已更改的块之间跳转，而无需滚动完整个页面。 使用差异视图时有两个选项： 1. **显示所有页面** — 这会在目录中显示已更改和未更改的页面，因此你可以在整个部分的上下文中审阅编辑内容。 2. **仅显示已更改页面** — 这只会显示已修改的页面，因此你可以专注于已编辑的内容。 你可以切换到 **更改** 选项卡，以在任何变更请求中查看差异视图。

这是“更改”屏幕底部的导航控件小组件

### 合并变更请求 合并变更请求会将该变更请求中的更改添加到内容的主分支中，从而创建一个更新后的版本，并在该部分的 [版本历史](/docs/documentation/zh/creating-content/version-control.md#see-the-activity-of-a-specific-draft). 如果你没有正确的 [权限](/docs/documentation/zh/collaboration/member-management/permissions-and-inheritance.md)，或者你的变更请求尚未通过你的组织或部分的 [合并规则](/docs/documentation/zh/collaboration/merge-rules.md). ### 更新变更请求 当你在变更请求中工作时，其他贡献者可能正在修改该部分的主分支。发生这种情况时，你的变更请求会被视为“已过时”——主分支上有一些内容不在你的变更请求中显示。 你可能希望将这些新内容拉取到你的变更请求中。如果出现以下情况，这会很有用： * 你想查看你的更改与主分支上的内容在全部合并后会是什么样子。 * 你需要将拉取的内容作为变更请求的一部分进行修改。 你可以通过按下 **更新** 在变更请求屏幕标题中。 一旦你按下 **更新**，主分支中的所有内容都会被拉取到你的变更请求中。更新时你可能会遇到冲突——你可以在变更请求内解决它们。冲突解决后，变更请求将被视为已是最新，更新按钮会消失。 如果主分支再次发生变化，你的变更请求又会变为过时，更新按钮会重新出现。 要求编辑者在合并之前保持其变更请求为最新状态，是一种很好的质量控制——它有助于作者检查其变更请求合并后将进入主分支的确切内容。你可以通过一个 [合并规则](/docs/documentation/zh/collaboration/merge-rules.md). ### 解决合并冲突 有时，当你想合并一个变更请求时，可能会发现主内容与要合并的内容之间存在冲突。最简单地说，冲突就是一段无法自动合并的内容。 如果发生这种情况，你会看到一个冲突提醒，以及一份你需要在继续合并之前解决的冲突列表。 在解决合并冲突时，你有两个选项—— **选择要合并的版本** 或 **手动** **编辑内容**. #### 选择要合并的版本 你可以通过选择想要合并的版本来解决合并冲突——可以是传入的内容，也可以是之前存在的内容。这让你可以在一个更改和另一个更改之间做出选择——要么是你最近的工作，要么是原始内容。 如果你处理的是可以通过这种方式解决的合并冲突，你可以选择要保留的版本，另一个版本将被删除。 #### 手动编辑 如果你不想在版本之间做选择，你可以通过手动编辑冲突来解决合并冲突。你可以删除不需要的块，甚至完全重写它们。等你对更改满意后，可以继续处理下一个冲突，直到全部解决。 ### 归档变更请求 你不能在 GitBook 中删除变更请求，但可以将其归档。 要归档一个变更请求： 1. 打开 **变更请求** 选项卡。 2. 点击你想要归档的变更请求。 3. 点击 **操作** 菜单 The Actions menu icon in GitBook 旁边的变更请求标题，并选择 **归档**. 要查找并重新打开已归档的变更请求，请打开 **变更请求** 菜单并点击 **已归档** 选项卡。 --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://gitbook.com/docs/documentation/zh/collaboration/change-requests/change-requests-in-a-space.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.