> 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/xie-zuo/change-requests/change-requests-in-a-space.md). # 分区中的变更请求 了解如何在分区中协作处理单个变更请求——包括如何审查、解决冲突和合并 当你处于一个 [部分](/docs/documentation/zh/can-kao/concepts.md#space)中时，你可以通过打开新的变更请求来进行修改，或者浏览现有的变更请求，查看其他人正在处理什么。 ### 创建变更请求 点击 **编辑** 中的按钮 [章节标题](/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](/docs/documentation/zh/gitbook-dai-li/overview.md) 是一个 AI 队友，可以 [规划并实现变更请求](/docs/documentation/zh/gitbook-dai-li/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-dai-li/write-and-edit-with-ai.md) 了解更多。 ### 预览变更请求 你可以通过点击 **预览** 中的 [章节标题](/docs/documentation/zh/can-kao/gitbook-ui.md#space-header)选项来预览你在变更请求中所做的更改。这将切换到已发布文档的预览，其中包含提议的更改，因此你可以在整个已发布文档的上下文中查看这些更改。 按钮下方是一个 **预览** 站点预览 URL。点击此处，你的站点预览将在新标签页中完整打开。 当你在新标签页中打开预览 URL 时，你还会看到 [预览工具栏](/docs/documentation/zh/guan-li-ni-de-zhan-dian/customization/toolbar-on-published-sites-and-site-previews.md) 位于浏览器窗口底部。该工具栏可让你快速返回 GitBook，以查看、编辑或评论变更请求，或打开你站点的实时版本。 {% hint style="info" %} 你只能预览添加到某个 [已发布的文档站点的访客启用或禁用 PDF 导出](/docs/documentation/zh/fa-bu/publish-a-docs-site.md). {% endhint %} {% hint style="warning" %} 如果你的内容是通过分享链接或已认证访问发布的，预览功能将不会出现。 {% endhint %} ### 请求审阅变更请求 当你想在将更改合并到主分支之前，请求团队成员检查你的内容时，请对你的变更请求发起审阅请求。 点击 **概述** 章节标题栏中的标签页，可打开你的变更请求概览——包括你在差异视图中所做的所有更改。 使用 **概述** 标签页以添加上下文和审阅者。要在编辑器中检查差异，请切换到 **更改** 标签页。在该视图中，带有差异的页面会显示指示器，浮动的差异导航控件可帮助你更快地在变更块之间跳转。 你可以在此为变更请求添加描述，为审阅者提供一些上下文，并标记你希望检查工作的特定人员。 当你点击 **请求审核**时，变更请求的状态将变为 **审阅中**，并且你在审阅请求中标记的任何人都会收到通知。 如果你的更改不需要审阅，并且你拥有适当的 [权限](/docs/documentation/zh/xie-zuo/member-management/roles.md)，且没有任何阻止性的 [合并规则](/docs/documentation/zh/xie-zuo/merge-rules.md)，你也可以直接将更改合并到主版本。 {% hint style="info" %} [将 GitBook Agent 添加为审阅者](/docs/documentation/zh/gitbook-dai-li/review-change-requests-with-gitbook-agent.md) 到你的变更请求中，它可以检查你的内容中的拼写、语法和风格指南错误，提出改进建议等。 {% endhint %} {% hint style="warning" %} 如果你没有在审阅请求中标记任何人，则该章节中拥有审阅者权限的每个人都会收到通知。如果该章节没有审阅者，则审阅者之上的下一个角色会收到通知。 {% endhint %} #### 差异视图 如果页面包含差异，GitBook 还会显示一个悬浮的居中指示器。点击它可滚动到第一个已更改的块或元素。 当你打开 **更改** 章节标题中的标签页时，GitBook 会显示在变更请求中编辑过的每个页面和块。GitBook 左侧显示上一版本，右侧显示更新后的版本。这样可以更轻松地并排比较编辑内容。 包含差异的页面也会在目录中显示指示器，这使大型变更请求更容易浏览。 当你在编辑器的 **更改** 标签页中审阅页面时，浮动的差异导航控件可帮助你更快地在变更块之间跳转，而无需滚动整页。 使用差异视图时有两个选项： 1. **显示所有页面** —— 这会在目录中显示已更改和未更改的页面，因此你可以在整个章节的上下文中审阅编辑内容。 2. **仅显示已更改的页面** —— 这只会显示已修改的页面，因此你可以专注于已编辑的内容。 你可以切换到 **更改** 标签页，以在任何变更请求中查看差异视图。

这是“更改”页面底部的导航控件小部件

### 合并变更请求 合并变更请求会将该变更请求的更改添加到内容的主分支中，创建更新后的版本以及该章节中的一个新条目 [版本历史记录](/docs/documentation/zh/chuang-jian-nei-rong/version-control.md#see-the-activity-of-a-specific-draft). 如果你没有相应的 [权限](/docs/documentation/zh/xie-zuo/member-management/permissions-and-inheritance.md)权限，或者你的变更请求尚未通过你所在组织或章节的 [合并规则](/docs/documentation/zh/xie-zuo/merge-rules.md). ### 更新变更请求 当你在变更请求中工作时，其他贡献者可能正在修改该章节的主分支。发生这种情况时，你的变更请求会被视为“已过期”——主分支上有你在变更请求中看不到的内容。 你可能希望将这些新内容拉入你的变更请求中。如果出现以下情况，这会很有用： * 你想看看你的更改和主分支上的内容合在一起后会是什么样子。 * 你需要将拉取的内容作为变更请求的一部分进行修改。 你可以通过按下 **更新** 在变更请求屏幕标题中。 一旦你按下 **更新**，主分支中的所有内容都会被拉入你的变更请求中。更新时你可能会遇到冲突——你可以在变更请求中解决这些冲突。冲突解决后，变更请求会被视为已更新，更新按钮会消失。 如果主分支再次发生更改，你的变更请求又会变成过期状态，更新按钮将再次出现。 要求编辑者在合并前使其变更请求保持最新，是一种很好的质量控制措施——它帮助作者确认变更请求合并后将进入主分支的确切内容。你可以通过一个 [合并规则](/docs/documentation/zh/xie-zuo/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/xie-zuo/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.