垂直标签页

垂直标签页面板是一个侧边栏，它取代了传统的水平标签栏，提供了一个更丰富、更强大的标签页管理界面。面板不再只显示一行标签标题，而是为每个标签页和窗格展示上下文相关的元数据——包括 Git 分支、工作目录、智能体对话状态、差异统计等等。你可以在不丢失上下文的情况下快速浏览和切换工作流。

当同时运行多个编码智能体时，垂直标签页尤为有用，让你无需切换标签页即可清晰地概览每个会话的状态。

主要功能

丰富的元数据和状态

• 窗格元数据 - 一目了然地查看每个窗格的工作目录、Git 分支、智能体对话状态、差异统计和 PR 徽标。
• 智能体状态徽标 - 窗格图标显示彩色徽标叠加层，标示智能体状态（进行中、完成、出错、取消或阻塞）。像 Claude Code、Codex 和 Gemini CLI 这样的 第三方 CLI 智能体 会在徽标旁边显示其品牌图标和颜色。
• 通知指示器 - 当窗格有未读的智能体活动时，对应的行会出现一个强调色圆点，这样你无需切换标签页即可发现需要关注的会话。

显示模式与自定义

• 窗格或标签视图 - 将每个拆分窗格显示为单独一行（窗格），或者仅显示每个标签页中处于焦点状态的窗格（标签页）。
• 紧凑和展开模式 - 可选择紧凑的单行视图（默认）或包含完整元数据的详细多行布局。
• 可配置的窗格标题 - 控制显示顺序，例如：最后执行的命令或对话、工作目录或 Git 分支。
• 悬停详情侧栏 - 悬停在任何窗格行上，即可在悬浮的详情卡片中查看完整、未截断的元数据，无需改变焦点。

标签页管理

• 搜索、拖放和重命名 - 按标题、目录或分支筛选窗格；通过拖拽重新排序标签页或在标签页之间移动窗格；双击标签页即可在行内重命名。
• 新标签页菜单 - 通过统一的 + 菜单创建智能体标签页、终端标签页、云端智能体会话、工作树配置和 标签页配置。

启用垂直标签页

要从水平标签页切换到垂直标签页面板

1. 在 Warp 应用中，导航至 设置 (Settings) > 外观 (Appearance) > 标签页 (Tabs)。
2. 开启 使用垂直标签布局 (Use vertical tab layout)。

垂直标签页面板将作为可调整大小的侧边栏出现在窗口左侧。当垂直标签页处于激活状态时，水平标签栏会被隐藏。

带有智能体详情的垂直标签页。

注意

你也可以通过 命令面板 (Command Palette) 搜索“vertical tab layout”来切换垂直标签页。

视图模式

垂直标签页面板支持两种显示密度，你可以随时进行切换。

紧凑模式

紧凑模式是默认设置。每个窗格行显示一行图标和标题，下方可选显示一个副标题。副标题可以通过设置弹窗中的 附加元数据 (Additional metadata) 设置进行配置。

紧凑模式下的垂直标签页。

展开模式

展开模式下，每个窗格行都会显示标题、描述（如工作目录或文件路径）和元数据（Git 分支、差异统计徽标以及可用的 PR 徽标）。

垂直标签页概览。

切换视图模式

点击垂直标签页面板顶部的设置图标（滑块）。在弹窗中，使用 密度 (Density) 分段控件在紧凑视图和展开视图之间切换。更改将立即生效。

垂直标签页设置弹窗。

自定义垂直标签页

启用垂直标签页后，可以通过设置弹窗（点击控制栏中的滑块图标）或导航至 设置 (Settings) > 外观 (Appearance) > 标签页 (Tabs) 来配置其外观和行为。

你还可以重新排列 Warp 窗口顶部的面板切换按钮，包括标签页面板、工具面板、智能体管理、代码审查和通知邮箱，并可在头部左右两侧之间移动它们。详细信息请参见 可配置工具栏。

设置	可用性	选项	默认值
查看方式 (View as)	总是	窗格 (Panes) — 每个拆分窗格都有自己的行。 标签页 (Tabs) — 仅显示每个标签页中处于焦点状态的窗格。	窗格
密度 (Density)	总是	紧凑 (Compact) — 较小的行，包含标题和可选副标题。 展开 (Expanded) — 较大的行，包含标题、描述和元数据。	紧凑
窗格标题方式 (Pane title as)	总是	命令/对话 (Command / Conversation) — 最后一条命令、对话标题或 CLI 智能体名称。 工作目录 (Working Directory) — 窗格的工作目录。 分支 (Branch) — 当前检出的 Git 分支。	命令/对话
附加元数据 (Additional metadata)	仅限紧凑模式	分支 工作目录 命令/对话 (选项取决于“窗格标题方式”设置；重复项将被排除)。	分支
显示 (Show)	仅限展开模式	PR 链接 — 当前分支的拉取请求及状态（需要 GitHub CLI）。 差异统计 — 添加/删除的行数。	—
鼠标悬停显示详情 (Show details on hover)	总是	开 / 关 — 切换悬停详情侧栏。	开

自动元数据

以下元数据会自动出现，无需配置

• Git 分支 - 窗格工作目录当前检出的分支。
• 工作树 (Worktree) - 活动的 Git 工作树 路径（如适用）。
• 智能体状态 - 窗格图标上的彩色徽标，标示智能体当前状态（见下文 智能体状态徽标）。
• 通知点 - 当窗格有未读的智能体活动时，标题行上的强调色圆点。

智能体状态徽标

智能体窗格图标的右下角会显示一个小型的圆形徽标叠加层，反映智能体当前状态

状态	图标	含义
进行中	紫色时钟	智能体正在积极运行。
完成	绿色对勾	智能体最后一次轮次已成功完成。
错误	红色三角形	智能体最后一次轮次执行出错。
已取消	灰色停止符	用户取消了智能体最后一次轮次。
已阻塞	黄色停止符	智能体正在等待用户批准以继续执行。

垂直标签页上的智能体状态徽标。

第三方 CLI 智能体（Claude Code、Codex、Gemini CLI 等）会将它们的品牌图标和颜色显示在圆形窗格图标内，并带有相同的状态徽标叠加层。

当窗格有未读的智能体活动时，标题行的右边缘会出现一个强调色通知点。当你聚焦该窗格时，该点将消失。

标签页管理

搜索

垂直标签页面板顶部的控制栏包含一个搜索字段。输入内容即可按标题、工作目录、Git 分支、PR 标签或差异统计信息筛选可见的标签页和窗格。搜索查询处于活动状态时，仅匹配的标签页保持可见。

新标签页菜单

点击控制栏中的 + 按钮打开新标签页菜单。菜单包含

• 智能体 - 打开一个新的智能体标签页。
• 终端 - 打开一个新的终端标签页。
• 云端智能体 - 打开一个新的云端智能体会话标签页。
• 标签页配置 - 你创建的所有 标签页配置 都会显示为菜单项，支持一键设置。
• 新工作树配置 - 创建一个基于工作树的新标签页配置。
• 新标签页配置 - 从入门模板创建一个新的标签页配置。

拖放操作

通过在面板中拖动标签组标题来重新排序标签页。要将窗格从一个标签页移动到另一个标签页，只需将窗格标题拖动到面板中的另一个标签组上。Warp 会切换到该标签页，以便你可以使用标准放置目标放置窗格。将窗格放置在两个标签组之间会创建一个新的标签页。

重命名标签页

双击标签页行即可进行行内重命名。按 Enter 确认，或按 Esc 取消。

注意

重命名仅适用于标签页。目前无法重命名单个窗格。

悬停详情侧栏

悬停在任何窗格行上，即可打开一个固定在面板右侧的浮动详情卡片。侧栏会显示完整、未截断的元数据（完整的目录路径、全称分支名以及完整的对话或命令标题），且不会改变当前聚焦的窗格。

垂直标签页的悬停详情卡片。

当你将光标从行移到卡片上时，侧栏会保持开启。移开光标即可关闭它。你可以在设置弹窗中通过切换 鼠标悬停显示详情 (Show details on hover) 来禁用此行为。

键盘快捷键

所有现有的标签页键盘快捷键在垂直标签页中均可继续使用。侧边栏布局改变的是标签页的显示方式，而非你的交互方式。有关完整的标签页快捷键列表，请参阅 终端标签页。

相关页面

• 终端标签页 - 水平标签栏的使用和键盘快捷键
• 拆分窗格 - 将标签页拆分为多个终端窗格
• 标签页配置 - 在 TOML 文件中定义可重用的标签页设置
• Git 工作树 - 垂直标签页元数据中支持的工作树显示
• 标签页行为 - 标签栏可见性、指示器和关闭按钮设置
• 第三方 CLI 智能体 - 在 Warp 的实用工具栏中使用 Claude Code、Codex、Gemini CLI 等第三方智能体，包括在垂直标签页面板中显示的品牌图标和状态徽标