一个任务同时修改多个项目

#开始前

一个任务有一个 主 工作区，可以关联多个 辅 工作区。已登记的项目从工作区列表选择；只想在本任务中使用的 Git 仓库，也可以直接接入已有目录，不必加入全局工作区。

#第一步：打开关联工作区

新建任务时，点击 任务目标 旁的 关联 按钮。

已有任务则点击标题下方工作区旁的关联入口，两处使用相同的窗口。

#第二步：选择目录方式，再选择项目

窗口上方列出本任务项目，下方是 添加关联工作区。

① 主 项目是任务创建时选择的工作区。② 辅 项目是额外接入的项目。每个项目可查看文件、Diff 和分支状态，分别提交、拉取或推送。

③ 在添加栏先选目录方式，再搜索并单击项目接入：

方式	如何使用	适合情况
原工作区	直接使用已有工作区的当前分支和未提交改动	希望修改立即落到原项目
独立分支	填写开发分支，选择来源分支，再选择 Git 项目创建副本	希望辅助项目也独立开发
已有目录	输入绝对路径（支持 ~/）或选择 Git 仓库根目录，点击关联	接入自己准备的仓库或 Git worktree

独立分支默认沿用主项目的开发分支，可以修改；不能使用 main/master，远程已有同名分支时需更换。来源分支按项目选择，默认自动识别远程 main/master，也可以搜索已知的 origin 分支或直接输入分支名；创建前会确认远程存在该分支并拉取最新代码。已有目录保留原分支和改动，只供本任务引用，Caravel 不接管它的清理。

#第三步：确认接入状态

任务未运行时，后续执行使用当前关联项目。运行中添加或解除的关联从 下一轮 生效，弹窗顶部会提示待生效变更；需要立即切换时，可用弹窗中的暂停并接入入口。

解除辅助项目关联需要确认，之后从任务头和关联列表移除，但目录与成果保留。需要时从添加栏重新选择；Caravel 管理的副本仍可在 副本库 管理。

原目录丢失时，先恢复该目录再重试，Caravel 不会自动下载替代目录。Agent 是否真正接入辅助项目，取决于它对附加工作目录的支持。

#把原目录迁移到独立副本

已经在原目录开始开发，后来想把这个任务隔离出来时，无需重建任务。主项目和辅助项目都可以迁移。

1. 先结束当前运行，在关联窗口找到项目行内的 迁移到独立工作区。

2. 确认开发分支和未提交改动数量，选择是否让原目录切回 main/master。

   

3. 确认后，未推送提交以及暂存、未暂存、未跟踪改动一起搬入独立副本。主项目迁移后，下一轮建立新的 Agent 会话，任务历史保留；辅助项目从下一轮接入。

#完成后你会看到

标题栏显示主辅项目，关联窗口集中显示各项目的分支和目录状态。不同项目可以混用原目录与独立副本；只有 Caravel 管理的副本进入当前任务的副本清理流程，外部引用目录不会随任务删除。