> 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 代理](/docs/documentation/zh/gitbook-agent/overview.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/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" %} 你只能预览已添加到 [已发布文档站点](/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-agent/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.