第 03 模块 · 3 节

工作树管理:归档、休眠、删除与多选操作

《Orca 基础入门》03 工作树模型 · 本节时长 25 分钟

工作树会越来越多并行推进几十个工作树很常见。管理操作(归档 / 休眠 / 删除 / 批量)就是保持侧边栏清爽的关键。

四种状态操作

操作 效果 何时用
Pin 置顶 固定到项目顶部 长期推进的任务,别让它沉下去
Archive 归档 从活跃列表收起 阶段性完成、暂时不删
Sleep 休眠 暂停终端/面板资源 Agent 干完活,省内存
Delete 删除 删目录 + 分支 任务交付后清理

多选与批量操作

  • 按住 Cmd/Ctrl 点击多个工作树(加选)
  • 按住 Shift 点击(连续范围选择)
  • 右键任意一个选中的工作树,操作应用到整个选区
  • 右键菜单还有嵌套相关操作:
    • Sleep with Descendants (N) —— 休眠本工作树 + 所有验证过的嵌套子工作树(只作用于有活跃终端的)
    • Delete with Descendants… —— 显式的级联删除

Resource Manager 清理

当你需要跨整个环境盘点时:

Resource Manager → Clean up workspaces 列出所有工作区:本地 worktree、主 worktree、文件夹工作区、断连 SSH 主机上的工作区。可以搜索、筛选、排序,检查每个工作区的状态、最近活动、大小、git 状态与关联评审,然后批量选择移除。


被保留的分支

批量删除工作区时会删除磁盘目录;但如果 git 因为分支上有未合并提交而拒绝删除本地分支,Orca 会:

  1. 保留这些分支
  2. 弹 toast:Review N Branches
  3. 打开列表让你逐个强删或保留

未选择的分支留在仓库里;工作区目录不会恢复。


重命名与编辑

  • 双击侧边栏标题:内联重命名
  • 双击卡片其他位置:打开完整编辑对话框(Edit Worktree Details)
  • 编辑对话框里可以关联 GitHub / Linear 问题(粘贴 URL 自动识别;一个工作区最多一个关联问题)
  • 任务名支持 Slack 风格 emoji 短代码(:rocket:),Orca 派生分支名时会转成可读短代码(🚀 → rocket

隐藏与筛选

侧边栏头部筛选菜单可隐藏:

  • Sleeping(休眠中的工作区)
  • Default branch(主 checkout 行)
  • Automation-created(自动化创建)
  • CLI-createdorca worktree create 创建的)
  • Other-client(共享远程服务器上别的客户端建的)
  • Detached HEAD(停在 commit 上的 checkout)

注意:Cmd+J Jump Palette 与文本搜索不受这些隐藏筛选影响,输入查询仍能找到被隐藏的工作树。


落地练习:管理一轮工作树

  1. 造 3~4 个工作树,练习 Cmd/Ctrl 多选与 Shift 范围选择
  2. 把其中一个 Pin 到项目顶部
  3. 把一个 Agent 已干完活的休眠(Sleep),观察资源释放
  4. 批量删除两个不再需要的,确认分支去向
  5. 打开 Resource Manager → Clean up workspaces 看一眼全局清单

怎么判断做对了?——你能说出 Pin / Archive / Sleep / Delete 四者的区别,并在 30 秒内完成一次多选批量删除。

卡住了怎么办? 删错了?未合并分支会被保留并可恢复;已合并的删除后就找不回来了,删除前确认 diff 已经交付或 cherry-pick 保留。


小结

  1. 四种操作:Pin / Archive / Sleep / Delete,各有适用场景
  2. 多选(Cmd/Ctrl、Shift)+ 右键批量操作
  3. Resource Manager 提供跨环境的全局清理
  4. 未合并分支会被保留并提示 Review
  5. 隐藏筛选不影响 Cmd+J 搜索

下一节,进入界面操作:分屏布局。