项目和工作区

“添加项目”是把代码仓库或文件夹接入 Orca；“新工作区”是在某个项目下，开一个用来完成具体任务的工作环境。一个项目可以有多个工作区。 Orca 的侧栏默认就是按“项目 → 工作区”组织的。

	「添加项目」	「新工作区」
主要作用	告诉 Orca：我要处理这个仓库或文件夹	告诉 Orca：我要在某个项目里开展一项工作
操作对象	整个项目，例如 my-app	项目下的工作区，例如“修复登录”“开发搜索”
通常什么时候用	第一次把某个项目加入 Orca，或者开始处理另一个项目	为已有项目开一个新任务，或并行尝试另一种方案
创建时主要选什么	要加入的目录或仓库	所属项目、工作区名称、Agent，以及 Git 项目的起始分支等

官方入门流程也是：先添加仓库，再创建工作区，然后选择在其中运行的 Agent。普通的非 Git 文件夹也可以通过界面加入。Orca Docs

举个例子

假设你有一个网站项目 my-app，想同时修复登录问题、开发搜索功能：

1. 点 “添加项目”，选择 my-app 的代码目录。
2. 点 “新工作区”，选择 my-app，创建“修复登录”，让 Claude Code 处理。
3. 再点 “新工作区”，仍然选择 my-app，创建“开发搜索”，让 Codex 处理。

这样是 一个项目、两个工作区。对于 Git 项目的常规创建流程，Orca 会通过 Git worktree 给不同工作区提供各自的代码目录、分支和 Agent 终端，让两项工作可以并行进行。Orca Docs

一个容易混淆的细节

“新工作区”是否有独立的文件，要看项目类型：

• Git 项目：常规的新工作区使用独立的 worktree，分别修改各自目录里的代码。Orca Docs
• 普通文件夹项目：也能有多个工作区，但它们可以指向同一个文件夹，分别管理工作会话。因此，不能仅凭创建了多个工作区，就认为文件也被复制并隔离了。GitHub

你现在如果是要打开电脑上的某个代码项目，先点左边“添加项目”；之后想在这个项目里开新的任务，再点右边“新工作区”。