界面与会话管理

本章介绍 VelaTerm 组织工作的方式：窗口布局、项目树管理、标签页与分屏的行为、状态点与筛选、归档、全局搜索，以及退出时保存工作空间。其他章节都以这些内容为基础。

1. 窗口布局

「远程访问」和「连接远程服务」在桌面版中提供，详见远程开发与管理。「反馈」会在浏览器中打开 VelaTerm 的反馈页面。在 Windows 和 Linux 上，按 Alt 会显示菜单栏，其中包含「文件」「终端」和「帮助」。

左右两栏都可以通过标题栏按钮隐藏，也可以拖动边缘调整宽度。

2. 项目树：项目、集合、分组与会话

• 项目对应磁盘上的一个目录，是一棵子树的根节点。可以通过「创建项目」（新建文件夹）、「导入项目」（打开已有文件夹，⌘O）或「从 Git 克隆」来创建。
• 集合是不对应文件夹的顶层容器，用于存放不属于某一个项目的会话。可通过左栏底部的「新建集合」按钮创建。
• 分组是用于组织内容的节点，可以任意层级嵌套。
• 会话是工作单元，可以是智能体、浏览器页面或终端。会话的工作目录默认为项目根目录，可在会话的「编辑」表单中修改。

鼠标悬停在某一行上时会出现 ＋ 按钮（项目和分组上为「新建会话」，会话上为「新建子会话」）；项目和分组上还会出现一个用于新建分组的按钮。

大多数操作都在右键菜单中：

项目和分组菜单以新建类菜单项开头：

• 「新建浏览器页面」（桌面版）和「新建终端」；后者会在该目录中打开一个临时终端（§5）。
• 三个对应最近使用的智能体的「新建 … 会话」菜单项，以及「更多智能体会话」，其中包含所有智能体、已保存的预设、「新建智能体会话」（可搜索的选择器）和「自定义参数新建…」。
• 「新建 worktree 会话…」和「新建规划/执行会话…」，详见会话派生与 Git 协作和规划与执行。
• 「导入会话…」（仅项目菜单）和「恢复会话…」，详见AI 智能体会话 §4。

项目菜单接下来依次提供「新建分组」「标记」「实验性功能」（代码图谱和代码审计）、「项目信息」（集合为「集合信息」）、「重命名」和「移除项目」（集合为「删除集合」）。分组菜单提供「Git」子菜单、「新建子分组」「转移到 Worktree…」「标记」「重命名」「归档分组」和「删除分组」。

会话菜单会根据会话的类型和状态显示相应的菜单项：

• 「打开」「在新标签打开」「在右侧分屏打开」「在下方分屏打开」「在当前分屏打开」（§4）。
• 「新建子会话」「Fork 会话」「导出会话…」「整理到会话知识库」以及「Git」子菜单。
• 「标记」「会话信息」（按住 Option/Alt 可查看完整启动命令）、「编辑」「重命名」「移动到…」。
• 「结束进程」（运行时显示）、「归档会话」「删除会话」。

项目树的其他操作：

• 移动：拖动节点，或使用「移动到…」。会话可以移到另一个会话下，成为它的子会话。
• 重命名：「重命名」可直接在原位置编辑名称。未命名的会话会以你发送的第一条消息作为名称。
• 标记：「标记」可为项目、分组或会话添加表情符号标记：🔥 紧急、⭐ 重要、🐛 缺陷、✅ 已完成、🚧 进行中、📌 置顶关注、💡 想法、⚠️ 注意。再次选择当前标记即可将其移除。
• 多选：按住 ⌘/Ctrl 点击可选中或取消选中会话，按住 Shift 点击可选择一个范围。此时右键菜单提供「打开选中会话」「平铺选中会话」（两到四个会话）、「移动所选到…」「归档选中的会话」和「删除选中的 N 项」。拖动选中的内容会将其全部移动。
• 折叠状态在重启后保持不变。

3. 标签页

「设置 ▸ 行为 ▸ 标签页」决定会话的打开方式：

• 单标签（默认）：在项目树中点击智能体会话会复用当前的会话标签页，就像在浏览器中点击链接一样。离开的标签页连同其中所有分屏一起转入后台，进程继续运行。终端会话会在单独的标签页中打开。
• 多标签：每个会话都在单独的标签页中打开。

「在新标签打开」总是会打开新的标签页。无论哪种模式，切换到其他标签页都不会停止任何进程；关闭标签页（⌘W 或 ×）则会结束其中的进程。对于智能体会话，这样做是安全的：对话会被保留，再次打开该节点即可恢复。

后台标签页在状态栏中显示为「后台 N/M」，点击后可以切回某个标签页或将其结束。在单标签模式下，「后台保活上限」（默认 32）限制后台标签页的数量。超出上限时，最早的不活跃后台标签页会被自动结束。如果所有后台标签页都在工作或等待你处理，VelaTerm 会询问你要结束哪一个。

标签栏的其他细节：

• ⌘1–9（Windows 和 Linux 上为 Ctrl+1–9）按位置切换标签页。用鼠标中键点击可关闭标签页。
• 标签页后面的 ＋ 会打开一个临时终端。右侧的按钮分别用于新建终端、新建文档、打开内置浏览器标签页（桌面版）和打开游戏中心。
• 标签页的右键菜单包含「关闭标签」「关闭其他标签」「关闭右侧标签」「关闭所有标签」「转入后台保活」（保持该标签页的进程继续运行），以及与项目树中相同的会话菜单项。

文档标签页和浏览器标签页的说明见文档与浏览器标签页。

4. 分屏

一个标签页可以包含多个分屏：

• ⌘D 向右分屏，⌘⇧D 向下分屏（Windows 和 Linux 上分别为 Ctrl+Alt+D 和 Ctrl+Alt+E）；分屏顶部也有相同的按钮。新分屏是一个临时终端，在当前分屏的工作目录中启动。
• 要在当前标签页中显示已有的会话，可在其菜单中选择「在右侧分屏打开」「在下方分屏打开」或「在当前分屏打开」，也可以将其从左栏拖到中栏。
• 「平铺选中会话」会将选中的两到四个会话排列在同一个标签页中。
• 显示在当前标签页其他分屏中的会话，会在左栏中高亮显示。

分隔条可以拖动。后台保活以整个标签页为单位，因此离开标签页再返回时，布局保持不变。⌘W 关闭当前分屏；关闭最后一个分屏时，标签页也随之关闭。

5. 临时终端

「新建终端」、⌘T 以及标签栏中的 ＋ 都会打开临时终端。临时终端只以标签页的形式存在：它不会成为项目树中的节点，关闭后即被丢弃。这类标签页带有「临时」标记。临时终端适合执行简短的命令；需要长时间运行的工作应放在智能体会话中。临时终端的菜单比较简短：「打开」「在新标签打开」、分屏相关菜单项、「重命名」「会话信息」和「关闭草稿」。

6. 状态点与筛选

每个智能体会话旁的圆点显示其状态：工作时为绿色，需要你处理时为黄色，智能体已回复且你已查看后为洋红色。完整的图例见AI 智能体会话 §3。

状态栏显示处于「工作中」「等待处理」（需要你处理）和「已查看」状态的会话数量；没有会话的计数会被隐藏。点击某个计数，左栏只显示对应的会话；再次点击即可取消筛选。

左栏也有自己的工具：

• 搜索框（「搜索会话 / 分组…」）按名称筛选项目树。
• 筛选按钮（「状态筛选」）可以选择一个或多个状态，另外还可以选择一个标记。
• 状态筛选会保留设置筛选时符合条件的会话，因此工作过程中列表不会跳动。开启「状态筛选动态增加」（位于「设置 ▸ 行为」，默认开启）后，之后变为符合条件的会话也会被加入列表。左栏底部的「刷新状态筛选」会重新检查所有会话；会话菜单中的「刷新状态」只检查该会话。
• 左栏底部的「向下切分树分身」会再添加一个项目树视图，它有独立的搜索和筛选，例如一个视图只显示需要你处理的会话，另一个显示完整的项目树。每个新增的视图都可以关闭。

7. 右栏

• 文件：会话工作目录的文件树。双击文件即可在文档标签页中打开。
• 信息：会话详情、账号用量、当前回合和资源占用，详见AI 智能体会话 §8。
• Git：分支、已暂存和未暂存的改动、未跟踪的文件、提交操作以及提交历史。
• 知识库：会话知识库、已归档的会话以及你的本地知识库，详见本地知识库和会话知识库。

8. 归档：收起而不删除

已完成的工作不必删除。右键点击会话 →「归档会话」即可将其收起：该会话及其子会话会从项目树中移除，进程也会结束，但所有数据都会保留。「归档分组」会归档分组中的所有会话，「归档选中的会话」则归档当前选中的会话。

已归档的会话位于知识库中，可通过左栏顶部的「已归档会话」按钮打开。已归档的会话按项目分组，搜索框（「搜索归档内容…」）可以搜索它们的内容。对于每个已归档的会话：

• 可以查看对话内容。智能体会话会显示消息；没有可用的对话时，如果存在终端录制，则显示终端录制。另一个标签页列出从该会话生成的知识条目。
• 「恢复为正常会话」会将其放回项目树中原来的位置，并保留对话 ID，因此打开后会继续原来的对话。
• 「整理到会话知识库」会从中提取可复用的知识。
• 「导出完整上下文为 Markdown」（Claude 和 Codex）会将完整对话写入文件。
• 只有「彻底删除（连带录制）」会删除数据。

9. 全局搜索（⌘⇧F）

「搜索所有会话」（⌘⇧F；Windows 和 Linux 上为 Ctrl+Alt+G）搜索的是所有会话的内容，包括智能体对话和已录制的终端输出，而不仅仅是名称。

• 可以组合多个词，顺序不限；也能搜到部分词语以及中文、日文或韩文文本。结果按相关度排序。
• 左侧按会话分组显示结果；右侧的预览会高亮当前匹配项。使用 ↑/↓ 和 Enter 可以在各会话的匹配项之间逐个跳转。
• 「打开会话」会在工作空间中打开该会话。
• 除非勾选「同时搜索归档」，否则搜索结果不包含已归档的会话。

只有开启会话录制（「设置 ▸ 高级 ▸ 记录会话日志」，默认关闭）后，才能搜索终端输出。智能体对话则始终可以搜索。

10. 安全删除

删除会话会将其连同录制一起永久删除。删除包含已归档会话的分组或项目时，这些归档会被保留；恢复其中任意一个时，其所属的项目和分组也会一并恢复。如果拿不准，请先归档：已归档的内容随时可以恢复。

11. 退出与恢复工作空间

退出时会弹出「退出 VelaTerm？」确认，并停止正在运行的终端会话和智能体会话。勾选「保存工作空间」后，下次启动时会重新打开相同的标签页和分屏。恢复的会话不会自动启动：每个分屏会显示「已从保存的工作空间恢复，进程还没有启动。」以及「启动」按钮。该复选框会记住你上次的选择。