atrium — Docs
docs/zh-cn/concepts/glossary.md

术语表:atrium 的概念一览

atrium 各层级的简短说明——workspace、project、wing、room、pane、subtab,以及 resident 和 Vault,并列出每个术语在命令行中的名称。

Read in English

atrium 的界面目前只有英文。本页用中文解释界面上的英文术语,并注明每个术语在命令行(CLI)中的名称。

atrium 把内容分成六层,从外到内依次是:

workspace › project › wing › room › pane › subtab

一个 workspace 包含多个 project,一个 project 包含多个 wing,一个 wing 包含多个 room,一个 room 包含多个 pane,一个 pane 里还可以叠放多个 subtab。

各个层级

Workspace(工作区)——一组 project 的集合,有自己的图标和强调色。切换 workspace,就是在不同的 project 组之间切换,比如“客户项目”和“个人项目”。详细了解 workspace(英文)。

Project(项目)——在 atrium 中打开的一个文件夹,通常是一个 git 仓库。每个 project 都有自己的 room、智能体、笔记和任务。git worktree 会显示为子 project。详细了解 project(英文)。

Wing(房间分组)——project 里可选的 room 分组。标签栏只显示当前 wing 里的 room。每个 project 一开始都有一个名为 main 的 wing。详细了解 wing(英文)。

Room(房间)——project 里的一个界面,里面排列着若干 pane。room 在标签栏里显示为一个标签,在房间侧边栏(rooms sidebar)里显示为一行。用 New Room(macOS 上是 Cmd+T)新建。详细了解 room(英文)。

Pane(窗格)——room 里的一个区块:终端、智能体对话、编辑器、浏览器等。拆分 room,就可以并排放置多个 pane。详细了解 pane(英文)。

Subtab(子标签页)——叠放在同一个区块里的多个 pane。pane 的标题栏上有小标签,一次只显示其中一个。Pane 菜单里的 New Subtab 会在当前 pane 上新增一个。详细了解 subtab(英文)。

另外两个术语

Resident(常驻窗格)——停靠在侧边栏上方或下方的 pane,而不是放在 room 里。它在这个 project 的每个 room 里都可见。详细了解 resident(英文)。

Vault(存档库)——atrium 保存的历史记录:它定期保存的整个应用的快照,以及可以搜索的历史智能体会话。从 Library 打开(macOS 上是 Cmd+Shift+L)。详细了解 Vault(英文)。

这些“标签”有什么区别?

  • New Room 新建一个 room。标签栏里的标签(或房间侧边栏里的行)就是 room。
  • New Subtab 在当前 pane 里新增一个 subtab,room 不变。
  • Pop out(弹出)把一个 pane 从布局里移到 room 上方的浮动面板中。它既不是新的 room,也不是 subtab。
只有一个 pane 的 room,在标签栏和侧边栏里显示的是这个 pane 的标题和图标。有多个 pane 的 room,会在房间侧边栏的 room 行下面列出这些 pane。

命令行里的名称

命令行沿用了两个层级的旧名称,所以 workspace 在命令行里指的是另一个层级。atrium --help 的开头也有同样的对照。

界面中命令行中
Workspaceatrium collection
Projectatrium workspace,或它的别名 atrium project(--workspace、$ATRIUM_WORKSPACE_ID)
Wingatrium wing
Roomatrium room($ATRIUM_TAB_ID)
Paneatrium pane
Subtabatrium pane create --split <pane-id> --direction subtab
Residentatrium pane dock、atrium pane undock、atrium pane pin
Vault没有对应的命令

JSON 字段、磁盘上的文件夹等地方仍在使用旧名称,详见 Naming: internals vs. UI(英文)。

在 atrium 里打开本页

打开 Help → Glossary,或者在命令面板(macOS 上是 Cmd+K)里搜索“glossary”或“术语表”。如果电脑的系统语言是简体中文,atrium 会直接打开这个中文版本。