第 01 模块 · 3 节

界面总览:侧边栏、标签页与首次启动

《Orca 基础入门》01 认识 Orca 与安装 · 本节时长 24 分钟

先看骨架Orca 的界面逻辑很一致:左边是「项目与工作树」列表,中间是「标签页 + 面板」的画布,右边是上下文面板。任何东西——终端、编辑器、浏览器、diff——都是一个标签页。

界面四区

区域 内容 作用
左侧边栏 项目 → 工作树树形列表 所有任务的入口,含状态指示
中间画布 标签页 + 分屏面板 终端、编辑器、浏览器、diff、PR 视图
右侧面板 Agent 会话历史、端口、评审等 按需切换的上下文工具
顶部状态栏 Agent 用量、运行状态、通知铃铛 全局状态一览

侧边栏:以工作树为单位

侧边栏按项目分组(一个项目 = 一个 git 仓库),展开后是你在推进的工作树。要点:

  • 每个工作树卡片显示其 Agent 行内状态(转圈 = 干活中,黄色问号 = 等你输入,绿点 = 完成,红点 = 被阻塞)
  • 未读工作树加粗而不是加徽标,避免视觉噪音
  • 双击标题可重命名;右键有归档 / 休眠 / 删除等操作
  • 顶部搜索按钮打开 Worktree Jump Palette(Cmd-J),键盘党的导航主通道
  • 可以 Pin(置顶) 长期运行的工作树

中间画布:一切皆标签页

每个标签页只装一样东西:终端、编辑器缓冲、浏览器、diff、PR。要点:

  • 标签页按 tab group 分组;组内拖动排序,组间拖动移动
  • 把标签拖到面板边缘即可分屏(右缘 = 左右分,底缘 = 上下分),分屏可无限嵌套
  • 激活标签的颜色条告诉你当前焦点在哪个面板
  • 快捷键:Cmd+Shift+] / [ 切换标签页(macOS),Ctrl+Shift+] / [(Win/Linux)

右侧面板:按需的工具抽屉

右侧面板有多个 tab,随上下文切换:

  • Agents —— Agent Session History(会话历史,进阶课展开)
  • Ports —— SSH 远程工作树的端口转发
  • Source Control —— 暂存、提交、推送(进阶课展开)

首次启动的落地页

添加第一个仓库之前,落地页只有一个动作:Add Repo。点击后:

  1. 选择本地 checkout 目录(也可以选父目录,Orca 会识别其中的多个 git 仓库并分组导入)
  2. Orca 读取仓库 git 状态,把默认分支作为 base ref(之后每个新工作树都从它分支)
  3. 仓库出现在侧边栏,随时可以创建第一个工作树
关于主题与设置Orca 支持明暗主题切换(窗口右上角)、快捷键重映射(Settings → Shortcuts),终端的主题、字体、光标甚至可以从 Ghostty / Warp 一键导入。设置项很多,但基础课阶段只需认识 Settings → General / Terminal / Agents 三个入口。

落地练习:逛一遍界面

  1. 添加一个你现有的 git 仓库
  2. 确认侧边栏出现项目行,展开能看到仓库的默认分支工作树
  3. 在默认分支工作树里开一个终端标签(Cmd+T / Ctrl+T),跑一下 git status
  4. 试着把终端标签拖到面板右缘,制造一个左右分屏,再拖回来
  5. 打开 Settings → Shortcuts,看一眼可重映射的快捷键

怎么判断做对了?——你能说出「一个工作树里可以有多个标签页」并且亲手制造过一次分屏。

卡住了怎么办? 找不到 Add Repo 就重启应用;分屏拖不动就确认拖的是标签页头部而不是面板空白处。


小结

  1. 界面四区:侧边栏、画布、右侧面板、状态栏
  2. 侧边栏 = 项目 → 工作树,卡片带 Agent 状态指示
  3. 中间画布一切皆标签页,拖拽边缘即可分屏
  4. 首次启动先 Add Repo,默认分支成为 base ref

下一节,创建你的第一个工作树。