Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
/**
* ContentHeader(右侧内容区顶栏 Shell)
* ---------------------------------------------------------------------------
* Codex 风格布局重构后,原 TitleBar 拆为三部分:
* - Sidebar 顶行(红绿灯让位 + 空白拖拽区,见 Sidebar.tsx)
* - ChromeActions 浮动按钮簇(菜单 + 折叠按钮,见 MainLayout —— 浮在
* Sidebar / Header 之上,折叠/展开时整体平移,而不是两份实例消失重现)
* - 本组件:右侧内容区自己的顶栏
*
* Shell 职责(跨所有路由保证存在,feature 不可遗漏):
* - 窗口拖拽区域(整条 header 默认 drag,交互元素各自 no-drag)
* - Windows 窗口控制按钮(最小化/最大化/关闭,恒在右上角)
* - 折叠态给 ChromeActions 按钮簇预留的占位 spacer(与侧栏宽度动画同步
* 伸缩,保证标题平滑让位,不与浮动按钮重叠)
* - Sidebar 不可见(折叠 / 设置页)且非全屏时,mac 红绿灯让位 padding
*
* 中部内容由当前路由视图通过 useRegisterContentHeader 注入(会话标题等),
* Shell 不知道里面是什么。无注入时:mac + 侧栏展开 → 整条隐藏(自带顶部
* 内容的页面不浪费 46px);其余场景保留空白拖拽条(约束见函数内注释)。
*
* 视觉:无背景(bg 继承 main 的 bg-content-area),下边框 hairline 只画在
* 右栏(Sidebar 侧保持无横线的连续表面);设置页隐形 chrome 连边框也不画。
*/
import { createContext, useContext, type ReactNode } from 'react';
import { useFeatureContentHeader } from '@/features/feature-context';
import { useMacFullscreen } from '@/hooks/useMacFullscreen';
import { cn } from '@/lib/utils';
import {
CHROME_ACTIONS_GEOMETRY,
CHROME_ACTIONS_MAC_RIGHT_EDGE,
chromeActionsHitHoleWidth,
} from './chromeActionsGeometry';
export const CONTENT_HEADER_HEIGHT_PX = 46;
const ContentHeaderHiddenContext = createContext(false);
/** Routes whose top is entirely non-host content (such as a plugin webview) can
* add a window drag area exactly when the common header is hidden. */
export function useIsContentHeaderHidden(): boolean {
return useContext(ContentHeaderHiddenContext);
}
/**
* Windows 窗口控制按钮宽度(3 × 46px)。固定侧栏入口位于下一行的内容区,
* 不占用本标题栏。
*/
const WIN_CONTROLS_WIDTH = 138;
/**
* mac 右栏固定唤起按钮宽度占位(按钮 28 + 右距 8)。按钮已 hoist 到 MainLayout
* 顶层浮层(钉窗口右上角,见
* MainLayout 的 mac 浮层),这里同 Windows 一样在右端留等宽占位,防止注入的
* header 内容滑到浮动开关下面。
*/
const MAC_RIGHT_TOGGLE_WIDTH = 36;
/**
* "空 header 隐藏"判定(用户决策 2026-06-11)的单一决策源:MainLayout 与 ContentHeader
* 共用,MainLayout 据此在 <main> 上广播 --content-header-h(46px/0px)供路由做占位
* 补偿(新建页内容组恒定在"有栏时"位置,用户改稿 2026-07-21),ContentHeader 据此隐藏。
* 判定语义见组件内原注释:mac + Sidebar 展开 + 无注入内容 + 无右栏开关。
*/
export function useContentHeaderHidden(args: {
sidebarVisible: boolean;
rightSidebarAvailable: boolean;
}): boolean {
const { isMac } = useMacFullscreen();
const headerContent = useFeatureContentHeader();
return isMac && args.sidebarVisible && headerContent == null && !args.rightSidebarAvailable;
}
interface ContentHeaderProps {
/** Sidebar 当前是否在布局中可见(展开态)。false = 折叠或设置页隐藏。 */
sidebarVisible: boolean;
/** 折叠态是否需要为 ChromeActions 浮动按钮簇预留占位。设置页为 false。 */
showCollapsedActions: boolean;
/** 左侧栏是否处于 rail 态(拖到最窄但仍保留图标列)。 */
isSidebarRail: boolean;
/** 展开态侧栏宽度(窗口像素)。与按钮簇的几何一起决定本 header 要补挖多宽的
* no-drag 区:侧栏窄于簇右缘时它的洞会被自身 overflow-hidden 裁掉。 */
sidebarWidth?: number;
/** mac 右上固定唤起按钮是否在场。mac 据此在右端留按钮占位并决定是否留住空
* header;Windows 仅影响空 header 判定,
* 占位恒为窗口控制按钮宽。 */
rightSidebarAvailable: boolean;
/** MainLayout 经 useContentHeaderHidden 预判的结果(与 --content-header-h 同源)。 */
hidden: boolean;
/** 右端占位左侧、紧挨 mac 右栏开关的按钮(任务所在电脑的远程桌面等);按钮自挖 no-drag。 */
trailing?: ReactNode;
}
export function ContentHeader({
sidebarVisible,
showCollapsedActions,
isSidebarRail,
sidebarWidth,
rightSidebarAvailable,
hidden,
trailing,
}: ContentHeaderProps) {
const { isMac, isFullscreen } = useMacFullscreen();
const headerContent = useFeatureContentHeader();
// Sidebar 不可见时红绿灯落在 header 上方 → 非全屏让位。78px = 70px 红绿灯
// 占位 + 8px 呼吸间隙(与原 TitleBar 的 pl-[70px] + px-2 等效)。
const needsTrafficLightInset = isMac && !isFullscreen && !sidebarVisible;
// rail 态时,Sidebar 仍占 78px;mac 非全屏的 ChromeActions 却紧贴其右缘
// (x=78)。Sidebar 顶栏里的 no-drag 洞会被自身 overflow-hidden 裁掉,必须在
// main 的 drag header 左缘再挖一个洞,否则点击浮动的收放/菜单按钮会被 Electron
// 当成窗口拖拽吞掉。完全收起态 main 从 x=0 开始,既有 spacer 已覆盖该位置;
// 全屏态按钮回到 rail 内,也由 Sidebar 的既有洞覆盖。
// 展开态同理但只挖溢出那一截:侧栏可拖到 180(useSidebarResize 的下限),比簇右缘
// 202 窄,超出侧栏右缘的按钮同样压在 header 拖拽区上。
const chromeActionsHitHole =
isMac && !isFullscreen && (isSidebarRail || sidebarVisible)
? chromeActionsHitHoleWidth(
isSidebarRail
? CHROME_ACTIONS_GEOMETRY.macTrafficLightLeft
: (sidebarWidth ?? CHROME_ACTIONS_MAC_RIGHT_EDGE),
)
: 0;
// 设置页:Sidebar 隐藏且无折叠按钮占位 → header 退化为"隐形 chrome"
// (仅拖拽区 + Windows 窗口控制),不画下边框。
const isInvisibleChrome = !sidebarVisible && !showCollapsedActions;
// 空 header 隐藏(用户决策 2026-06-11):技能中心 / 自动化 / 文件浏览 /
// 新建对话等自带顶部内容的页面,不再渲染空白的 46px 顶栏。
// 仅当以下条件全部成立才隐藏:
// - 无注入内容(headerContent == null)
// - Sidebar 展开可见 —— 折叠态下这 46px 是 ChromeActions 浮层按钮和
// mac 红绿灯的所在行,藏了按钮会压在页面内容上
// - mac —— Windows 上这条空 header 仍保留为拖拽细条(窗口控制按钮已
// hoist 到 MainLayout 顶层浮层,但顶栏仍是 Windows 拖动窗口的抓手)
// - 右栏唤起入口在场(rightSidebarAvailable,mac 把入口放在本 header 右端)——
// 即使无注入内容也留住空 header 当开关落点,否则全屏聊天视图在 mac 上会
// 失去关闭右栏的入口
// 设置页天然不满足 sidebarVisible,维持隐形 chrome 现状。
// 判定已上提到 useContentHeaderHidden(MainLayout 同源消费,广播 --content-header-h)。
if (hidden) {
return null;
}
return (
<header
className={cn(
// 46px 行高 (与 CONTENT_HEADER_HEIGHT_PX 同步):红绿灯钉 y=16(实测灯心 ≈23 = 46/2,macOS 渲染比理论低约 1pt),标题/图标与
// 红绿灯同轴(对齐 Codex 的紧凑 titlebar)。与 ChromeActions / Sidebar
// 顶行 / MainLayout 右上浮层同一常量,改动必须连同 main 侧
// trafficLightPosition 一起同步。
'relative flex h-[46px] w-full shrink-0 items-center select-none',
// 下边框只画在右栏(header 在 main 内部,不会延伸到 Sidebar 上方),
// Sidebar 侧保持无横线的连续表面;设置页隐形 chrome 不画
// (用户决策 2026-06-11)。
!isInvisibleChrome && 'border-b border-titlebar-border',
'transition-[padding] duration-[250ms] ease-[cubic-bezier(0.4,0,0.2,1)]',
needsTrafficLightInset ? 'pl-[78px]' : 'pl-2',
)}
// 窗口拖拽区(B3 口径修订,Lizi 实测拍板):46px 顶带整条归窗口拖动 ——
// 曾把本条划给"拖面板"手势,实测窗口没了顺手抓握区,难受;聊天面板的
// 拖动入口回归长按窗体(面积大,够顺手),面板级"标题条手柄"只保留
// 36px Tab 条那层(在面板身上,语义准)。
style={{ WebkitAppRegion: 'drag' } as React.CSSProperties}
>
{chromeActionsHitHole > 0 && (
<div
aria-hidden
data-testid="content-header-rail-chrome-actions-hit-hole"
className="absolute left-0 top-0 h-full"
style={
{
width: chromeActionsHitHole,
WebkitAppRegion: 'no-drag',
} as React.CSSProperties
}
/>
)}
{/* 折叠态占位 spacer:真实按钮在 MainLayout 的 ChromeActions 浮层里
(钉死左上角、不随折叠重建的常驻实例)。本 spacer 以与侧栏宽度动画
相同的时长/缓动伸缩,把标题平滑推到浮动按钮右侧(项目规则 8)。
簇宽 + 8 = 折叠 / 菜单 / 后退 / 前进四个 28px 按钮 + 与标题间隙 8,
跟 CHROME_ACTIONS_GEOMETRY 一起变。
⚠️ spacer 自身必须 no-drag:Electron 的拖拽区域挖洞只在"drag 元素
自己的后代"上可靠生效,浮层(非后代)的 no-drag 不被计入 ——
否则浮层按钮点击会被窗口拖拽吞掉。 */}
<div
aria-hidden
className="h-full shrink-0 overflow-hidden transition-[max-width] duration-[250ms] ease-[cubic-bezier(0.4,0,0.2,1)]"
style={
{
WebkitAppRegion: 'no-drag',
width: CHROME_ACTIONS_GEOMETRY.clusterWidth + 8,
maxWidth: showCollapsedActions ? CHROME_ACTIONS_GEOMETRY.clusterWidth + 8 : 0,
} as React.CSSProperties
}
/>
{/* 中部:feature 注入的 slot 内容。容器保持 drag,注入内容里的交互
元素自行 no-drag。 */}
<div className="flex h-full min-w-0 flex-1 items-center">{headerContent}</div>
{trailing}
{/* 右端占位 —— 平台分流(两端都只留占位,不再放交互按钮):
- mac:全屏聊天视图在场时(rightSidebarAvailable)留出固定唤起按钮等宽占位。
按钮本身已 hoist 到 MainLayout 顶层浮层(钉窗口右上角);这里仅占位防注入
内容被压到浮层按钮下。不在场则右端留空。
- Windows:留出 WIN_CONTROLS_WIDTH 等宽占位(窗口控制按钮已 hoist 到
MainLayout 顶层浮层);固定侧栏入口位于下一行内容区。 */}
{isMac ? (
rightSidebarAvailable && (
<div aria-hidden className="h-full shrink-0" style={{ width: MAC_RIGHT_TOGGLE_WIDTH }} />
)
) : (
<div aria-hidden className="h-full shrink-0" style={{ width: WIN_CONTROLS_WIDTH }} />
)}
</header>
);
}
/**
* ContentHeaderSlot —— 必须渲染在 FeatureSidebarSlotProvider 内(useContentHeaderHidden
* 消费 feature context)。一式两用:① 按判定渲染/隐藏 ContentHeader;② 用 display:contents
* 包裹层向后代广播 --content-header-h(46px/0px,与 header 的 h-[46px] 同源)——供新建页等
* 视口比例定位的路由做占位补偿,顶栏显隐内容区零跳动(用户改稿 2026-07-21)。
* display:contents 不参与布局,children 仍直接躺在 <main> 的 flex 上下文里,DOM 语义不变。
*/
export function ContentHeaderSlot({
sidebarVisible,
showCollapsedActions,
isSidebarRail,
sidebarWidth,
rightSidebarAvailable,
trailing,
children,
}: Omit<ContentHeaderProps, 'hidden'> & { children: ReactNode }) {
const hidden = useContentHeaderHidden({ sidebarVisible, rightSidebarAvailable });
return (
<>
<ContentHeader
sidebarVisible={sidebarVisible}
showCollapsedActions={showCollapsedActions}
isSidebarRail={isSidebarRail}
sidebarWidth={sidebarWidth}
rightSidebarAvailable={rightSidebarAvailable}
hidden={hidden}
trailing={trailing}
/>
<div
style={{
display: 'contents',
['--content-header-h' as string]: hidden ? '0px' : `${CONTENT_HEADER_HEIGHT_PX}px`,
}}
>
<ContentHeaderHiddenContext.Provider value={hidden}>
{children}
</ContentHeaderHiddenContext.Provider>
</div>
</>
);
}