> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coze.cn/llms.txt
> Use this file to discover all available pages before exploring further.

扣子 AI 编程项目支持多分支并行开发，你可以为每个任务创建独立的开发分支，在同一项目中同时打开、开发多个分支、并行推进多项任务，同时避免代码冲突。

:::tip 说明
目前，仅开发智能体时支持多分支功能，其他 AI 编程项目的多分支功能陆续开放中。
:::

## 功能介绍 {#hxCv5bXoF}

扣子 AI 编程项目支持连接到 Git 文档实现多分支并行开发。你可以在一个项目沙箱中创建多个独立工作区，每个独立工作区对应一个 Worktree 分支，拥有**独立的文件目录**、**项目代码、预览界面**。

各独立工作区之间相互隔离，在一个分支中所做的修改不会影响主分支或其他分支。该功能适合以下场景：

* 并行开发多个独立任务，例如同时开发新功能和修复 Bug。
* 针对同一个功能，在不同分支中尝试不同的实现思路，分别预览效果，选择最优方案合并到主分支。

当分支的预览效果达到预期后，即可将其代码合并到主分支。

## 使用限制 {#hMhNIFTff}

* 一个 AI 编程项目中，最多可创建 100 个分支和会话。
* 每位用户最多可同时打开 5 个开发页面。
* 在 Worktree 中手动新建文件后，需要执行 `git add` 和 `git commit` 提交，否则在沙箱回收后，未提交的文件将被清除且无法恢复。
   如果是对话形式新建的文件，扣子 AI 会自动执行 `git add` 和 `git commit`。   


## 1 创建分支 {#hw2htXkpo}

创建一个新的工作分支，并拥有独立的工作区和项目代码，扣子 AI 将在此基础上进行开发。预览确认开发结果后，你可以将代码改动合并到主分支。

1. 在[扣子编程](https://code.coze.cn/)的**项目管理**页面中，单击目标 AI 编程项目。
2. 在左侧会话列表中，单击**新建分支**图标，然后选择分支。
   你可以选择主分支，也可以选择已创建的任意分支。系统将自动基于所选分支创建新的开发分支。
   新建分支的默认名称为**新会话**，创建后可在列表中双击名称进行重命名。
   ![Image=463x258](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/ce1062e513a74af3961a77a25752bc22)   


## 2 在新分支中开发 {#hOGA7RsLj}

创建多个独立分支，同时开发不同的任务。

例如开发一个面试官 Agent，主分支中已完成面试官 Agent 开发。现在，你想为其添加“生成评审报告”的新功能，但又不确定效果。此时，你可以在一个新分支中开发此功能，并在预览效果满足预期后，再将其合并到主分支。

在新分支中，输入如下提示词，开发新功能。

```Plain Text
回答结束后，支持生成评估报告
```

![Image=516x226](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/fd466b674d354d8cae2cb3ddf01a6c24)

## 3 合并分支 {#hGf9Ydz8S}

确认新分支中的功能或修复满足要求后，你可以将该变更合并到主分支。

1. 在左侧分支列表中，找到要合并的分支。
2. 单击目标分支对应的··· > **合并分支**。
   扣子 AI 会自动调用技能，对分支进行冲突检查，并完成合并操作。若存在代码冲突，扣子 AI 会先询问解决策略，待开发者确认后，再解决冲突。
   ::::cols
   @col 33
   提交合并
   
   ![Image=457x423](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/594f67ae019749e5bfe7dab9a5ca24fc)
   
   @col 33
   生成合并报告
   
   ![Image=863x673](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/67597ee9a13a4f018b94fa6eeee96215)
   
   @col 33
   合并冲突
   
   ![Image=570x388](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/7d8e1eecaa16474980556d0e78dc1e13)
   ::::   


## 查看沙箱容量 {#hcfGpKIpx}

同一个项目内的各个独立工作区运行在一个沙箱中。创建分支会占用沙箱容量，建议按需创建。

你可以在开发页面右下角查看容量使用情况。容量不足时，可以单击**释放容量**，释放一定的缓存，或者手动扩容。

需注意的是：

* 沙箱容量达到上限时，项目将停止运行。
* 仅**个人旗舰版及更高的订阅套餐**支持调整预览页面的沙箱容量配置。

![Image=555x312](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/6708cd5eefa343b28271a1c2432b142a)

## 相关操作 {#hJJNr85Ws}

创建分支后，你还可以重命名、关闭、置顶分支等操作。

<!-- @cols-width: 222,603 -->
|**操作** |**说明** |
|---|---|
|查看分支标识 |你可以将鼠标 hover 在分支名称左侧的图标上，查看分支标识。 |
|修改分支名称 |创建新分支时，分支的默认名称为**新会话**，你可以双击目标分支名称，或者单击目标分支对应的··· > **重命名**，重新设置分支名称，便于辨识。 |
|复制分支 |在分支列表中，单击目标分支对应的···> **复制**，基于该分支创建一个新会话。 |\
| | |\
| |:::tip 说明 |\
| |新会话与来源分支共享工作区和代码，并继承来源分支的历史记录，不会创建独立的工作分支。 |\
| |::: |\
| | |\
| | |
|查看分支 Diff |在分支列表中，或者单击目标分支对应的··· > **查看 Diff**，查看新分支和来源分支的代码文件变更点。 |
|关闭分支 |在分支列表中，单击目标分支对应的··· > **关闭**，关闭分支。 |\
| | |\
| |:::tip 说明 |\
| |* 如果分支中有正在进行的任务，则暂时无法关闭该分支。如需关闭，请先手动停止正在进行的任务。 |\
| |* 关闭分支后，该分支中的记录将被清除，未合并的代码改动将丢失。该操作不可撤销，请谨慎操作。 |\
| |::: |\
| | |\
| | |
|置顶分支 |在分支列表中，单击目标分支对应的···> **置顶**，将该分支固定在分支列表顶部。 |

## 常见问题 {#hjzAkB0nd}

* [在不同开发分支中，同时发送需求会冲突吗？](/guides_vibe_coding_faq#hgpbfrmXH)
* [多分支模式下，新分支是基于一个全新的空项目吗？](/guides_vibe_coding_faq#hDt4QIO9s)
* [合并代码到主分支后，能够撤销吗？](/guides_vibe_coding_faq#hXHWZjMrp)