助手
扣子 AI 帮助与支持
你好,我是 扣子 文档问答助手 🎉 你在阅读当前文档的过程中,无论对文档概念的解释,还是文档内容方面的疑问,都可以随时向我提问,我会全力为你解答
推荐问题
扣子 3.0 都有什么新特性?
扣子和扣子编程有什么区别?
扣子如何收费?
文档反馈

AI 编程多分支并行开发

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

说明

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

功能介绍

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

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

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

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

使用限制

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

1 创建分支

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

  1. 扣子编程项目管理页面中,单击目标 AI 编程项目。
  2. 在左侧会话列表中,单击新建分支图标,然后选择分支。
    你可以选择主分支,也可以选择已创建的任意分支。系统将自动基于所选分支创建新的开发分支。
    新建分支的默认名称为新会话,创建后可在列表中双击名称进行重命名。
    Image

2 在新分支中开发

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

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

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

回答结束后,支持生成评估报告

Image

3 合并分支

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

  1. 在左侧分支列表中,找到要合并的分支。
  2. 单击目标分支对应的··· > 合并分支
    扣子 AI 会自动调用技能,对分支进行冲突检查,并完成合并操作。若存在代码冲突,扣子 AI 会先询问解决策略,待开发者确认后,再解决冲突。

    提交合并

    Image

    生成合并报告

    Image

    合并冲突

    Image

查看沙箱容量

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

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

需注意的是:

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

Image

相关操作

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

操作 说明
查看分支标识 你可以将鼠标 hover 在分支名称左侧的图标上,查看分支标识。
修改分支名称 创建新分支时,分支的默认名称为新会话,你可以双击目标分支名称,或者单击目标分支对应的··· > 重命名,重新设置分支名称,便于辨识。

复制分支

在分支列表中,单击目标分支对应的···> 复制,基于该分支创建一个新会话。

说明

新会话与来源分支共享工作区和代码,并继承来源分支的历史记录,不会创建独立的工作分支。

查看分支 Diff 在分支列表中,或者单击目标分支对应的··· > 查看 Diff,查看新分支和来源分支的代码文件变更点。

关闭分支

在分支列表中,单击目标分支对应的··· > 关闭,关闭分支。

说明

  • 如果分支中有正在进行的任务,则暂时无法关闭该分支。如需关闭,请先手动停止正在进行的任务。
  • 关闭分支后,该分支中的记录将被清除,未合并的代码改动将丢失。该操作不可撤销,请谨慎操作。
置顶分支 在分支列表中,单击目标分支对应的···> 置顶,将该分支固定在分支列表顶部。

常见问题