文件、Git 与终端

右侧的面板：搜索、diff、提交，以及每个 Workspace 自己的 shell。

右侧切换栏

最右边那一条窄栏，一次只为选中的 Workspace 打开一个面板。再点一次同一个按钮就收起。

再往下是更新按钮（有新版本时才出现）、Remote Control（手机图标，见 Remote Control）和 Settings。

Kumo 不编辑文件。改代码是 agent 的事；这些面板用来看它们改了什么，以及做一个 Workspace 需要的那几步 git 操作。

文件

Workspace 的目录树，一层一层展开。点一个文件，它会在中间打开一个只读的文件 tab，带语法高亮。Markdown 默认渲染显示，头部有 Rendered / Source 切换，里面的链接在浏览器里打开。图片直接显示成图片。

在文件里选中文字会浮出一个 Cite，它把 @path:12-40 放进这块 board 上最近对话过的那个 agent 的草稿，并切到那个 tab。渲染后的 markdown 里也能用，引用的是你选中的那个块对应的行。

面板顶上的搜索框能做两件事：

• 按名字（⌘F）：模糊匹配，像 Go to File 那样，fsk 就能找到 file-search-keyword.ts。命中单词开头、命中文件名的排在前面。
• 按内容（⌘⇧F）：所有匹配按文件分组，带上那一行。点一条，文件打开并跳到那一行，这个词在文件里的每一处都会被高亮。

大小写是智能的：全小写就不区分大小写，出现大写字母就精确匹配。在 git 仓库里，文件列表遵守 .gitignore。Esc 清空搜索，再按一次离开搜索框。

头部的准星图标会定位当前 tab 正在显示的文件：沿途的文件夹自动展开，那一行停在面板中间。搜索找到文件之后很好用。

右键文件有 Add to Agent（把 @path 插进某个 agent 的草稿，Workspace 里有多个 agent 时会出二级菜单）、Reveal in Finder、Copy File（复制文件本身，可以直接在 Finder 里粘贴）、Copy Path 和 Copy Relative Path。文件夹多一项 Refresh，用来看到 agent 在你展开之后新写的文件。

文件 tab 在切换 Workspace、重启 Kumo 后都还在。关掉它从不询问。

Git

从上到下：分支；提交信息框和 Commit、Push；STAGED；CHANGES；以及默认折叠的 COMMITS，左侧画着 commit graph。

• 暂存与取消暂存：悬停在文件上出现 + 或 −；分组标题上有 Stage all 和 Unstage all。暂存区有东西时，Commit 只提交暂存的部分（按钮写着 Commit 2 staged）；暂存区为空时，提交全部改动。
• 丢弃：未暂存文件上的 ↺ 会丢掉它的改动（未跟踪的文件会被删掉）。要点两下：第一下变成红色的 Discard?。分组标题上有 Discard all。
• Push 推送当前分支，第一次会顺便设好 upstream。
• Commits：右键一条可以复制 hash，或者 Revert this commit。revert 是一个新 commit，不改写历史；工作区不干净或者 revert 有冲突时，Kumo 会拒绝并说明原因。

点一个改动过的文件，会在中间打开一个 diff tab：相对 HEAD 的完整改动，暂存和未暂存的合在一起。头部的 Unified / Split 在单栏和左旧右新的双栏之间切换。选中几行再按 Cite，发出去的是新文件那一侧的 @path:12-40。头部的文件名可以点，打开文件本身。

Kumo 有意不做的：checkout、merge、解决冲突、force push、按 hunk 暂存。这些交给 agent，或者用终端。

终端

你的登录 shell（$SHELL），在这个 Workspace 的目录里，就在面板里。它不是中间的另一个 tab，也不是一扇 Terminal.app 窗口。

• 多个 tab：⌘T 再开一个，最多九个；⌘W 关掉一个；⌘1–⌘9 直接跳。tab 名取 shell 报告的标题。
• 忙碌圆点：正在跑东西（dev server、测试监听）的 tab 带一个圆点。面板收起时，切换栏上的终端按钮会显示有几个在忙。
• ⌘K 清屏，⌘F 查找，⌘+ ⌘− ⌘0 调字号。URL 可以点。
• 补全建议：打字时，你以前在 Kumo 终端里跑过的命令会浮在底部。⌘↑ ⌘↓ 选择，⌘⏎ 把剩下的部分补进命令行（不会替你回车），Esc 隐藏。Tab 补全和 ⌃R 还是你 shell 自己的。
• 把文件拖进来，它的路径会加好引号打在光标处。

会话属于 Workspace：收起面板、切到 Files 都不会杀掉它。在 tab 之间切换只会重放最近的输出，很久以前的滚动内容会丢。终端永远是深色的，不跟随 app 主题，因为一半的程序输出都默认背景是深色。

终端跑在 runtime 里，所以退出 Kumo 会停掉它们，以及里面正在跑的东西。agent 不一样，它们能扛过 runtime 重启。

agent 也能用这些终端，但只限它自己的 Workspace、只限你开好的 tab：kumo term 让 agent 往一个 tab 里敲一行、等它跑完、读回输出。