运行方式：隔离副本与独立分支

#三种运行方式怎么选

运行方式	Agent 在哪里改	做完后怎么处理	适合
工作区（默认）	直接改你的项目文件夹	改动已写入项目，点 完成	小改动，或者你会自己用 Git 管理改动
隔离副本	项目的一份临时副本	验收时 通过并合并 回项目，或 放弃改动	想先看结果再决定要不要
独立分支	从 main/master 新建一个分支的副本	在分支上提交并推送，不自动合并	需要提交代码审查（PR）的正式开发

隔离副本和独立分支需要项目是 Git 仓库。

#开启运行方式

1. 打开 设置 → Agent → 通用配置，在「运行方式」中打开 隔离副本（①）和/或 独立分支（②）。

   

2. 之后新建任务时，任务目标下方会出现 运行方式（①）。选择 隔离副本 时，在 基线分支（②）中确认副本从哪个分支创建。

   

3. 选择 独立分支 时，需要填写分支名（①），或点击 AI 生成（②）让 Agent 根据任务目标起一个分支名。

   

   点击 AI 生成不会创建分支，点击 创建并运行 时才真正创建。

#验收

• 隔离副本：任务做完后右上角出现 通过并合并 和 放弃改动，用法见 查看结果并验收。合并时遇到冲突，Caravel 会打开冲突处理界面。
• 独立分支：通过标题下方显示分支名的按钮打开 Git 菜单，提交并推送分支，再到代码托管平台发起合并请求。

#管理副本：副本库

所有任务的副本集中显示在 副本库。副本库默认不在侧栏显示，可以在 设置 → 功能管理 中打开。

• ① 副本分为 可清理 和 需保留 两组，每一行显示所属任务、项目、分支改动和存放路径。可清理的副本可以点右侧按钮单独删除；需保留的副本会注明原因，例如任务尚未结束。
• ② 全部清理 会一次性删除「可清理」组里的全部副本。独立分支如果还有未提交或未推送的内容，会归入需保留，不会被删除。

只想清理其中几个时，勾选可清理副本前的复选框（也可以全选当前筛选结果），再点击 清理已选。确认后逐项重新检查安全性，单项失败不影响其他副本，完成后显示成功数量和失败或保留的原因。被筛选隐藏、已消失或变为不可清理的项目会自动取消勾选。

• 任务标题旁显示最后更新日期，方便判断副本是否还在使用；悬停可看完整时间。可以按关键词、工作区和标签筛选。
• 全部清理 针对全部安全副本，不受当前搜索或筛选范围限制，执行前会确认数量。
• 有未提交、未推送成果，仍被其他任务使用，或缺少恢复资料的副本会保留。
• 清理移除本地副本，恢复信息保留；续接任务时按登记路径恢复。重新接入已清理的副本时，如果显式修改了开发分支或来源分支，会按新配置重建；旧副本还没安全清理时会拒绝并提示。原工作区和手动关联的已有目录不会随当前任务清理。

删除任务时，无待合并成果且未被占用的临时副本可自动回收；长期独立副本和未合并成果保留在副本库。任务已删除但仍有恢复资料时，可以从保留项目组接续任务。

已经在原目录开发的任务，也可以 迁移到独立副本；需要更换会话继续时，可 交接任务，不必重建项目副本。