Warp 垂直标签栏悬停详情侧边栏:Hover Detail Sidecar 的技术设计与实现解析

原创2026-10-01 21:39:071,857 阅读
文章标签:开发工具桌面应用跨平台人工智能AI Agent代码智能体CLIMCP Clients

Warp 垂直标签栏悬停详情侧边栏:Hover Detail Sidecar 的技术设计与实现解析

本篇基于 Warp 仓库内 specs/APP-3832/TECH.md 技术规格展开,聚焦垂直标签栏(Vertical Tabs)面板上的悬停详情侧边栏(Hover Detail Sidecar)功能:它如何在 View as = Panes / Tabs 两种粒度下展示完整、不截断的窗格信息,同时不抢占焦点、不影响既有行渲染与设置同步流。读完本文,你将掌握该功能的资格判定规则、悬浮层锚定与安全三角形(safe-triangle)交互原语、内部滚动布局等完整设计脉络,并能在仓库源码中逐一对位验证实现细节。

背景问题:垂直标签栏的信息压缩与两个缺口

垂直标签栏面板的首要设计目标是"保持可扫读"(scannable),因此它刻意压缩了每行呈现的信息量。这种压缩在实际使用中会产生两个明确的缺口:

  1. 即使是 View as = Panes(按窗格显示),行内重要的元数据仍会被裁剪或省略——例如完整的工作目录、git 分支名、命令/对话全文,都可能因为行宽与行高限制而显示不全;
  2. 在 View as = Tabs(按标签页显示)模式下,非活动窗格会从面板中整体消失——用户无法在不切换焦点的情况下快速检视一个分屏标签页里的其余窗格。

用户需要一个"从面板自身出发、不改变焦点、不打开标签页、不破坏 View as = Tabs 高层面板"的检视手段,这就是 APP-3832 悬停详情侧边栏的动机。相关产品行为约定详见 specs/APP-3832/PRODUCT.md,而决定行粒度的既有行为见 specs/APP-3828/PRODUCT.md 与 specs/APP-3828/TECH.md。

产品行为约定:两种显示粒度下的侧边栏语义

侧边栏的产品行为被刻意定义得很具体,技术设计必须逐条满足:

  • View as = Panes:悬停一个受支持(eligible)的窗格行,显示**一个窗格维度(pane-scoped)**的详情卡片,卡片只针对被悬停的那一个窗格;
  • View as = Tabs:悬停一个受支持的标签页代表行(representative row),显示**一个标签页维度(tab-scoped)**的侧边栏,内部为该标签页每个可见窗格各渲染一个小节(section);
  • 侧边栏是浮层(floating),不改变焦点;指针从行移入侧边栏期间保持打开;内容过高时内部滚动;
  • v1 迭代只支持终端 / 代理终端(agent terminal)窗格、代码(code)窗格,以及受支持的 Warp Drive 对象窗格(notebook/plan、workflow、环境变量集合、rules 等),其余窗格类型不显示侧边栏。

在 Tabs 模式下有一条关键的门槛规则:只有当被悬停标签页的每一个可见窗格都属于受支持类型时,才显示 tab-scoped 侧边栏;只要混入任意一个不受支持的可见窗格,整个标签页就不显示侧边栏(而不是"只渲染受支持的小节")。这条混合类型门控规则是整个设计中必须集中化、可测试的核心逻辑。

此外,侧边栏是"固定的详情视图",不是"放大版的行":Density、Pane title as、Additional metadata、Show 等既有显示设置均不得改变侧边栏的字段顺序与布局——这些设置只塑造行,不塑造详情卡。

现状分析:现有垂直标签栏为何无法直接复用

技术规格先系统梳理了现状,指出垂直标签栏已有的行悬停原语(row hover primitives),但缺乏四类能力:

  • 行锚定的浮层:除设置弹窗 / 标签页菜单外,没有"锚定在某一行上的 overlay";
  • 跨行与侧边栏间隙的临时悬停状态:行与卡片之间存在空间间隙,需要一种 ephemeral(临时的、不持久化的)状态来跨越它;
  • 与行显示设置解耦的固定详情渲染器:现有行渲染器被裁剪逻辑与密度设置耦合,不能直接复用为详情视图;
  • 依赖标签页全量可见窗格的 Tabs 模式资格规则。

实现目标明确为:在完全不扰动现有行渲染器、点击行为与同步设置流的前提下,把上述能力补进来。

从仓库源码看,垂直标签栏的实现在 app/src/workspace/view/vertical_tabs.rs(约 7578 行)。VerticalTabsPanelState(第 695 行起)已经拥有面板滚动/缩放句柄、每标签组悬停状态、每窗格行悬停状态、每窗格徽章悬停状态、设置弹窗悬停状态与可见性;但它当时没有跟踪"当前详情侧边栏的来源行"、"侧边栏自身是否被悬停"、"侧边栏的滚动状态"以及"行到侧边栏过渡的 safe-triangle 状态"。

几个关键现状细节:

  • 行渲染与粒度:render_tab_group 已经集中了变成可见行的窗格 id——Panes 模式渲染全部可见窗格 id,Tabs 模式通过 pane_ids_for_display_granularity(...) 只渲染一个代表窗格 id。每行已有稳定的 MouseStateHandle,但行未被 SavePosition 包裹,因此没有稳定的锚点 id 供行相对浮层使用;
  • 浮层放置层级:垂直标签栏面板本身渲染在 Workspace::render_panels 内,但必须逃出面板局部边界的浮层(设置弹窗、标签页上下文菜单)是从工作区根 Stack(Workspace::render)渲染的——这正是 app/src/workspace/view.rs 中 Workspace::render 已有 workspace-root overlay(设置弹窗与标签页菜单)宿主能力的原因,也决定了详情侧边栏应同样托管在 workspace 根层;
  • 既有数据提取能力:行渲染器已经知道如何推导终端标题/会话标题回退逻辑、工作目录与 git 分支、diff-stats 与 PR 徽章数据、代码窗格文件名/父路径拆分、代码脏状态、窗格类型标签与图标。但这些行渲染器不能直接复用于侧边栏——它们被裁剪且依赖密度,且与 Pane title as、Additional metadata、Show 耦合;侧边栏应复用同一数据源,而非复用同一元素树;
  • safe-triangle 先例:仓库已有针对"悬停菜单打开侧边/子菜单"的 safe-triangle 实现(通用逻辑在 app/src/safe_triangle.rs,菜单集成在 app/src/menu.rs,侧边栏矩形回读模式参考 app/src/terminal/profile_model_selector.rs)。既有模式是:把临时悬停状态放在同步设置/工作区快照之外;从上一帧记录侧边栏矩形;在光标沿对角线向该矩形移动时抑制中间悬停变化。这正是本功能应采用的交互原语。

核心设计:八项关键改动

1. 面板局部 detail-overlay 状态

在 VerticalTabsPanelState 上扩展三个字段用于悬停详情浮层:

  • detail_scroll_state: ClippedScrollStateHandle——高侧边栏的内部滚动;
  • detail_sidecar_mouse_state: MouseStateHandle——侧边栏自身的悬停跟踪;
  • detail_overlay_state: Arc<Mutex<VerticalTabsDetailOverlayState>>——由行与侧边栏回调共享的临时悬停详情状态。

并引入一个小型内部状态类型:

struct VerticalTabsDetailOverlayState {
    active_target: Option<VerticalTabsDetailTarget>,
    safe_triangle: SafeTriangle,
}

enum VerticalTabsDetailTarget {
    Pane {
        pane_group_id: EntityId,
        pane_id: PaneId,
    },
    Tab {
        pane_group_id: EntityId,
        source_pane_id: PaneId,
    },
}

设计原则是使用面板局部的临时状态,而非新增同步设置或持久化 workspace action——侧边栏是瞬时 UI 状态,性质上更像"菜单悬停"而不是"工作区配置"。从源码看这三处改动均已落地:detail_scroll_state、detail_sidecar_mouse_state、detail_overlay_state 位于 vertical_tabs.rs 第 709-711 行,VerticalTabsDetailTarget(第 596 行)与 VerticalTabsDetailOverlayState(第 628 行)与规格中的形状完全一致。

2. 资格判定与目标锚定辅助函数

新增四个纯函数(pure helpers),让混合标签页门控规则集中化、可测试:

fn vtab_pane_row_position_id(pane_group_id: EntityId, pane_id: PaneId) -> String

fn supports_vertical_tabs_detail_sidecar(typed: &TypedPane<'_>) -> bool

fn detail_target_for_hovered_row(
    pane_group_id: EntityId,
    pane_id: PaneId,
    granularity: VerticalTabsDisplayGranularity,
) -> VerticalTabsDetailTarget

fn pane_ids_for_detail_target(
    pane_group: &PaneGroup,
    target: &VerticalTabsDetailTarget,
    app: &AppContext,
) -> Option<Vec<PaneId>>

行为规则:

  • Panes 模式:受支持的行 → pane 维度目标;不受支持的行 → 无侧边栏;
  • Tabs 模式:代表行 → tab 维度目标;解析被悬停标签页的全部可见窗格;只要任一可见窗格不受支持,整体返回 None(v1 中整个标签页不显示侧边栏)。

仓库实现中,vtab_pane_row_position_id 生成形如 vertical_tabs:pane_row:{pane_group_id:?}:{pane_id} 的稳定 id(vertical_tabs.rs 第 135 行);detail_target_for_hovered_row 按粒度映射为 Pane / Tab 目标(第 168 行);pane_ids_for_detail_target(第 247 行)先取 pane_group.visible_pane_ids(),再经 visible_pane_ids_for_detail_target(...) 统一处理:Pane 目标要求源窗格受支持并只返回源窗格,Tab 目标要求全部可见窗格受支持才返回完整列表,源窗格已消失则返回 None(第 222-245 行)。

资格判定 supports_vertical_tabs_detail_sidecar 在实现中委托给 TypedPane::supports_vertical_tabs_detail_sidecar(第 3689 行):

fn supports_vertical_tabs_detail_sidecar(&self) -> bool {
    matches!(self, TypedPane::Terminal(_) | TypedPane::Code(_))
        || self.warp_drive_object_type().is_some()
}

即终端(含 Oz / CLI 代理终端)、代码窗格,以及带 Warp Drive 对象类型(notebook/plan、workflow、环境变量集合、rules 等)的窗格均受支持——这比规格初稿仅限"终端/代码"的范围更宽,与产品文档 specs/APP-3832/PRODUCT.md 中列出的 notebook/plan、workflow、环境变量集合、rules 等类型一致。

3. 行包裹层挂载 SavePosition 与 hover 回调

更新 render_pane_row_element,让最终行元素用新行位置辅助函数包裹进 SavePosition;hover 回调加在行包裹层而非单个 compact/expanded 行渲染器内部,这样所有行变体共享同一悬停详情行为。行包裹层需要:

  • 为该行推导合适的 VerticalTabsDetailTarget;
  • 受支持行 hover-in 时更新 detail_overlay_state.active_target;
  • 忽略不受支持的行;
  • 用当前指针位置更新 safe-triangle 状态;
  • 使用 with_skip_synthetic_hover_out(),避免浮层插入瞬间强制触发合成 hover-out 导致闪烁。

这样既保留现有行的点击/双击行为,又避免在多个渲染路径中重复接线。

4. 从 Workspace::render 渲染侧边栏,而非面板表面

新增助手函数,由工作区根 Stack 渲染返回的浮层:

pub(super) fn render_detail_sidecar(
    state: &VerticalTabsPanelState,
    workspace: &Workspace,
    app: &AppContext,
) -> Option<(String, Box<dyn Element>)>

其职责:读取 detail_overlay_state.active_target → 校验引用的 pane group / pane(s) 仍存在 → 解析应成为小节的窗格 id → 目标仍有效则构建侧边栏元素 → 返回源行位置 id 与侧边栏元素。随后在 Workspace::render 的 workspace-root Stack 中渲染(与既有设置弹窗、标签页菜单并列),从而避免被垂直标签栏面板容器裁剪。定位使用 OffsetPositioning::offset_from_save_position_element(...),以被悬停行的 save-position id 为锚,边界使用 PositionedElementOffsetBounds::WindowByPosition;侧边栏自身也带一个 SavePosition id,供后续帧读取其矩形用于 safe-triangle。

仓库中该函数(第 7215 行)实际返回 Option<DetailSidecarOverlay>(包含 anchor_position_id、offset、bounds、parent_anchor、child_anchor、sidecar 六个字段),并且多了一个实现细节:入口处先检查 TabSettings::as_ref(app).vertical_tabs_show_details_on_hover.value(),未开启时清空状态直接返回 None——即实现为侧边栏增加了一个显式开关设置项。随后依次做目标校验(标签页是否存在、标签页右键菜单是否打开)、pane_ids_for_detail_target 解析、空列表兜底清理。

5. 独立详情渲染器复用既有元数据源

规格强调:不要试图拉伸既有行渲染器,而是新建专用详情渲染器,并建立小型数据模型:

enum VerticalTabsDetailSectionData {
    Terminal(TerminalDetailSectionData),
    Code(CodeDetailSectionData),
}

数据构建复用与行代码相同的底层来源:

  • 终端标题 / 会话标题回退逻辑(agent conversation title → CLI agent title → terminal title → 最后一条已完成命令 → 最终回退如 New session)取自既有终端助手;
  • 用 TerminalView 取工作目录、分支、diff stats、PR 链接与代理状态;
  • 用 PaneProps::new / TypedPane 取窗格类型标签与代码窗格标题/路径推导;
  • 用 TypedPane::badge(app) 与 CodePane 脏检查取未保存状态。

显式约束:详情渲染器不得依赖 VerticalTabsViewMode、VerticalTabsPrimaryInfo、VerticalTabsCompactSubtitle、vertical_tabs_show_* 这些设置——它们塑造行,而侧边栏是固定详情视图。从实现看,render_detail_sidecar 内通过 detail_pane_props(...)(第 7284 行)与 render_detail_section(&props, appearance, app)(第 7306 行)逐小节构建,并复用了 detail_sidecar_background、detail_sidecar_border_fill、render_detail_badge、render_detail_status_pill、render_detail_wrapping_text 等一组详情渲染助手(第 6766-6859 行),印证了"复用数据源而非元素树"的设计。

6. 侧边栏布局与内部滚动

渲染形态为:固定宽度外层卡片 + 有界高度容器 + 内部可滚动内容 + 悬浮滚动条:

  • 固定宽度:DETAIL_SIDECAR_DEFAULT_WIDTH = 320.,空间不足时退到 DETAIL_SIDECAR_MIN_WIDTH = 240.;
  • 有界高度:DETAIL_SIDECAR_MAX_HEIGHT = 420.,并同时受窗口高度约束(window.height - 2 × DETAIL_SIDECAR_WINDOW_MARGIN(16.) 下限取 0);
  • 内部滚动:ClippedScrollable::vertical(...)(实现中为 ClippedScrollable::vertical(state.detail_scroll_state.clone(), ...) 加 .with_overlayed_scrollbar(),vertical_tabs.rs 第 7309-7318 行),滚动条样式与既有面板/菜单一致;
  • Tabs 模式:每个解析出的窗格 id 渲染一个小节,小节间插入 1px 分隔线(第 7295-7305 行);Panes 模式:单小节、无内部分隔;
  • 定位借助窗口边界:实现中的 detail_sidecar_offset_and_max_height(第 6646 行)会根据面板在左/右(PanelPosition::Left/Right)选择锚点组合与水平间隙(左面板侧边栏开在右侧,gap_x = 12.;右面板则相反),并在空间不足以放下侧边栏时切换为底部锚定(should_anchor_to_bottom 判断),同时用上一帧侧边栏高度平滑过渡;宽度判定 detail_sidecar_width_and_bounds(第 6744 行)在 WindowBySize 与 Unbounded 之间选择。

规格同时指出:v1 不需要左右翻转(flip)逻辑,因为垂直标签栏面板本身就位于工作区左侧;但实现出于完整性同时覆盖了 PanelPosition::Right 的对称情形。

7. safe-triangle:跨行到侧边栏的悬停保持

复用既有 safe-triangle 模式而非发明新的悬停启发式:

  • 侧边栏根元素用 Hoverable::new(detail_sidecar_mouse_state, ...) 包裹;
  • 行悬停变化时,用最新指针位置更新 SafeTriangle;
  • 后续悬停事件中,当光标正沿 safe-triangle 朝当前侧边栏移动时,抑制替换或清除 active target;
  • 参照 ProfileModelSelector,从上一帧读取侧边栏矩形并喂给 SafeTriangle::set_target_rect(...)。

仓库实现中,should_keep_detail_sidecar_visible_for_mouse_position(第 194 行)正是这套逻辑的纯函数化封装:指针在行矩形内或侧边栏矩形内 → 更新 safe-triangle 并保持;否则查询 safe_triangle.should_suppress_hover(position) 决定是否在过渡中抑制;VerticalTabsDetailHoverState::reconcile_visibility_for_mouse_position(第 650 行)在每次悬停事件中回读行与侧边栏的上一帧矩形并调用它,需要关闭时清空 active_target、重置 safe-triangle 与 sidecar 鼠标状态。侧边栏自身的 on_hover 回调(第 7338-7363 行)同样把最新矩形喂给 safe-triangle,并在指针离开侧边栏且源行也未被悬停时清除目标——"离开源行与侧边栏两者才关闭"的产品规则由此成立。

8. 不新增 WorkspaceAction(除非实现证明必需)

初始设计把悬停详情状态完全放在 VerticalTabsPanelState 内,通过共享的临时状态句柄传递,从而避免:

  • 为非持久化悬停状态新增 WorkspaceAction 变体;
  • 在 Workspace::handle_action 增加额外的 handle_action 分支;
  • 对"侧边栏是否属于已保存的工作区状态"产生混淆。

如果实际 UI 框架约束迫使采用 action 驱动更新,可在实现阶段引入,但不应作为默认方案。源码印证:detail_overlay_state: Arc<Mutex<VerticalTabsDetailOverlayState>> 作为面板内字段随 Default 初始化(第 711、749 行),未出现在 workspace action 体系中。

端到端交互流程

规格给出了完整的 11 步流程,结合实现可对应如下:

  1. 用户悬停一个渲染出的垂直标签栏行;
  2. 行包裹层(render_pane_row_element)根据行的 pane id、pane group id 与当前 VerticalTabsDisplayGranularity 推导 VerticalTabsDetailTarget;
  3. 行不受支持 → 什么都不发生;
  4. 行受支持 → 行 hover 回调把目标存入 detail_overlay_state.active_target;
  5. 下一帧渲染时,Workspace::render 调用 render_detail_sidecar(...) 索取浮层;
  6. 该助手校验目标、解析待展示窗格 id、在 Tabs 模式拒绝混合支持标签页、基于当前窗格数据构建小节;
  7. workspace 根 Stack 用行的 save-position id 把侧边栏定位到被悬停行右侧;
  8. 用户把指针从行移入侧边栏;
  9. safe-triangle 抑制中间悬停变化,侧边栏保持打开;
  10. 侧边栏过高时内容内部滚动;
  11. 指针同时离开源行与侧边栏后,overlay 状态被清空,侧边栏消失。

实现中的对应校验链可在 render_detail_sidecar 中逐段看到:vertical_tabs_show_details_on_hover 开关 → 目标是否存在 → 标签页是否存在(workspace.tabs.iter().find(...))→ 标签页右键菜单是否打开(打开则关闭侧边栏以免重叠)→ pane_ids_for_detail_target → 空列表兜底,最后构建滚动容器与 Hoverable 卡片并连同锚定信息一起返回给根 Stack。

风险与缓解措施

浮层引发的合成悬停抖动(Overlay-induced synthetic hover churn)

  • 风险:插入浮动层可能触发源行的合成 hover-out 事件,造成闪烁;
  • 缓解:hover 处理挂在行包裹层;使用 with_skip_synthetic_hover_out();把最后活跃目标保存在临时 overlay 状态中,而不是仅凭当前行悬停位决定可见性。

Tabs 模式下的混合支持标签页

  • 风险:混合标签页的产品规则容易被误实现为"只渲染受支持窗格";
  • 缓解:规则集中在 pane_ids_for_detail_target(...);只要标签页包含不受支持的可见窗格即返回 None;为混合标签页添加显式测试。实现中 visible_pane_ids_for_detail_target 用 all(&mut is_supported).then(...) 保证全通过才放行,测试 tab_detail_target_returns_none_for_mixed_support_tabs 直接覆盖此场景。

关闭/聚焦/重排后的过期悬停目标

  • 风险:侧边栏打开期间被悬停的源窗格或标签页可能消失;
  • 缓解:每次渲染构建侧边栏前先校验目标;pane group 或源窗格不存在则清空目标;每次渲染从实时 visible_pane_ids() 解析标签页小节,而非在目标中缓存窗格列表。实现中 pane_ids_for_detail_target 每次调用都重新走 visible_pane_ids(),render_detail_sidecar 也会在标签页缺失、右键菜单打开、列表为空时调用 clear_detail_sidecar()。

终端/代码元数据逻辑重复

  • 风险:侧边栏可能分叉行元数据逻辑并随时间漂移;
  • 缓解:尽量复用既有助手函数与模型读取;新的数据提取助手放在 vertical_tabs.rs 中、紧邻其平行的行渲染代码;避免在多处重新编码回退规则。实现中的 render_detail_status_pill、render_detail_badge 等即复用 ConversationStatus 与既有主题/外观体系。

根浮层与面板浮层的混乱

  • 风险:render_vertical_tabs_panel 已含设置弹窗的局部 overlay 结构,而 Workspace::render 又全局渲染弹窗,易产生双路径;
  • 缓解:把 Workspace::render 视为新侧边栏浮层的唯一真相源;从一开始就把侧边栏根植于 workspace 栈;不为本功能引入第二条面板局部 overlay 路径。

测试与验证

单元测试

规格要求在 app/src/workspace/view/vertical_tabs_tests.rs 增加纯测试:

  • supports_vertical_tabs_detail_sidecar(...):终端窗格受支持;代码窗格受支持;不受支持的窗格类型被拒绝;
  • pane_ids_for_detail_target(...):Panes 模式只返回被悬停窗格;Tabs 模式在所有窗格受支持时返回全部可见窗格;Tabs 模式在任一可见窗格不受支持时返回 None;源窗格缺失/过期返回 None;
  • 必要时补充行位置 id 或目标解析的小型纯测试,但优先级放在上述资格逻辑上。

仓库测试文件已落地对应用例,可直接对照:detail_sidecar_supports_terminal_code_and_warp_drive_object_panes(Terminal、Code、Notebook、Workflow、EnvVarCollection、AIFact、AIDocument 受支持,Settings 被拒绝)、detail_target_matches_panes_granularity 与 detail_target_matches_tabs_granularity(两种粒度到 Pane/Tab 目标的映射)、pane_detail_target_returns_hovered_pane_when_supported 与 pane_detail_target_returns_none_when_hovered_pane_is_not_supported、tab_detail_target_returns_all_visible_panes_when_every_pane_is_supported 与 tab_detail_target_returns_none_for_mixed_support_tabs(混合类型标签页门控),以及 code_detail_kind_label_uses_programming_language_display_name 等代码详情相关断言。

手动验证

规格列出的手动验证清单(实现阶段应逐条执行):

  • Panes 模式悬停受支持终端行 → 出现单个 pane 维度侧边栏;
  • Panes 模式悬停受支持代码行 → 出现单个代码侧边栏;
  • Tabs 模式悬停含多个受支持窗格的标签页代表行 → 每个可见窗格一个小节;
  • Tabs 模式悬停混合支持标签页 → 不出现侧边栏;
  • 指针从行沿对角线移入侧边栏 → 不闪烁关闭;
  • 点击侧边栏内 diff-stats 与 PR 徽章 → 既有动作照常触发(diff-stats 打开该窗格的代码评审流程,PR 徽章打开 PR 链接,点击小节空白区域不聚焦窗格/标签页);
  • 悬停包含大量窗格的标签页 → 侧边栏有界并内部滚动,而非延伸到屏幕外;
  • 切换 Density、Pane title as、Additional metadata、Show → 侧边栏布局保持固定;
  • 侧边栏打开期间关闭或变更被悬停标签页 → 浮层干净消失、无过期内容。

后续方向(Follow-ups)

规格为迭代收尾预留了三条路:

  1. 扩展窗格类型:待其余窗格类型的详情小节产品行为定义后,纳入支持范围(当前实现已通过 warp_drive_object_type() 先行覆盖了一部分对象型窗格);
  2. 键盘可达性:如果悬停专属行为被证明有价值,在后续 ticket 中为详情增加键盘可达的交互方式(当前规格明确 keyboard focus、选中态、程序化激活均不打开侧边栏,属非目标);
  3. 抽取可复用助手:若 Warp 其他位置继续新增悬停侧边栏,可把"行 + 侧边栏 + safe-triangle"抽取为通用助手,而不是把逻辑局限在垂直标签栏内部。

实现落点速查

关注点 仓库位置
规格正文 specs/APP-3832/TECH.md
产品行为 specs/APP-3832/PRODUCT.md
面板状态与浮层渲染 app/src/workspace/view/vertical_tabs.rs(VerticalTabsPanelState 第 695 行、render_detail_sidecar 第 7215 行、detail_sidecar_offset_and_max_height 第 6646 行)
资格判定与目标解析 app/src/workspace/view/vertical_tabs.rs(supports_vertical_tabs_detail_sidecar 第 164 行、TypedPane::supports_vertical_tabs_detail_sidecar 第 3689 行、pane_ids_for_detail_target 第 247 行)
悬停保持(safe-triangle) app/src/workspace/view/vertical_tabs.rs(should_keep_detail_sidecar_visible_for_mouse_position 第 194 行、VerticalTabsDetailHoverState 第 642 行)与 app/src/safe_triangle.rs
单元测试 app/src/workspace/view/vertical_tabs_tests.rs
既有浮层宿主与 safe-triangle 先例 app/src/workspace/view.rs、app/src/menu.rs、app/src/terminal/profile_model_selector.rs
登录后查看全文
warp