Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
/**
* Shared sticky top bar for both Plugin detail surfaces (installed + market).
*
* Inputs: back label/handler, scroll state, optional page actions and owning page's horizontal frame.
* Outputs: the back button, page actions and, on macOS, the window-drag region.
* [PROTOCOL]: 变更时更新此头部,然后检查 CLAUDE.md
*/
import { useCallback, useEffect, useState, type ReactNode, type UIEvent } from 'react';
import { ArrowLeft } from 'lucide-react';
import { WINDOW_DRAG_STYLE, WINDOW_NO_DRAG_STYLE } from '@/components/layout/windowDrag';
import { useMacFullscreen } from '@/hooks/useMacFullscreen';
import { isEditableKeyboardTarget } from '@/lib/editableKeyboardTarget';
import { cn } from '@/lib/utils';
interface PluginDetailTopBarProps {
label: string;
onBack: () => void;
/** 滚动帧是否已离开顶部;顶栏据此从透明切到实底 + hairline。 */
scrolled: boolean;
/** 管理页传入与正文共用的宽度和留白;详情页保留默认阅读宽度。 */
frameClassName?: string;
actions?: ReactNode;
}
/**
* 详情页滚动帧的「已离开顶部」判定。返回的 onScroll 直接挂在滚动容器上;
* scrollTop > 0 是布尔量,同值 setState 由 React bail out,重渲染只发生在
* 跨越顶部的那一次。
*/
export function usePluginDetailScrolled(): {
scrolled: boolean;
onScroll: (event: UIEvent<HTMLElement>) => void;
} {
const [scrolled, setScrolled] = useState(false);
const onScroll = useCallback((event: UIEvent<HTMLElement>) => {
setScrolled(event.currentTarget.scrollTop > 0);
}, []);
return { scrolled, onScroll };
}
/**
* 详情页顶行:返回入口 + mac 侧的窗口拖拽区。
*
* mac 上通用 ContentHeader 在「侧栏展开 + 无注入内容 + 无右栏」时整条隐藏
* (ContentHeader.tsx 的 useContentHeaderHidden),自带顶部内容的页面自行承担
* 窗口拖动(windowDrag.tsx 的约定),本行是插件详情页的那一份。Windows /
* Linux 的通用 header 常驻,那 46px 即窗口抓手,本行在这两端纯作视觉顶栏。
* 行内交互元素标 no-drag 挖洞,且必须是本行的后代 —— Electron 的挖洞只在
* drag 元素自身后代上生效。
*
* sticky 让拖拽区在任意滚动位置都在场。滚动态为实底:正文滚到本行下方会落进
* Electron 的 drag 矩形,实底背景同时把这些元素遮住,视觉与命中区一致。
*
* 高度 h-16 + 内容垂直居中,常规宽度下与列表页 PluginManagementHeader 同规格
* (PluginManagementLayout.tsx:212),列表与详情切换时顶栏高度恒定。主面板窄到
* 720px 以内时列表页顶栏排成工具行 + 页签行、撑到 7rem(plugin-motion.css 的
* container query,作用域是列表页的 plugin-management-layout-root);本行只承载
* 返回入口一个控件,各宽度下恒为 h-16。
*
* hairline 走 after 伪元素,脱离布局流,透明态与实底态之间高度恒定;article 的
* pt-5 之下,hero 起点为 64 + 20 = 84px。
*
* hairline 只画在 mac:那里 ContentHeader 整条隐藏,本行的 hairline 是顶栏与正文
* 之间唯一的边界。Windows / Linux 的 ContentHeader 常驻且自带 border-b,其
* --titlebar-border 是 --border-default 的 alias(cindy-light.ts:127 /
* cindy-dark.ts:131,两端同值),两条线同时出现即为一片 --surface 上相隔 64px 的
* 两条同色平行线;那两端由 ContentHeader 的下边框充当顶部分隔,本行只留实底。
*/
export function PluginDetailTopBar({
label,
onBack,
scrolled,
frameClassName,
actions,
}: PluginDetailTopBarProps) {
const { isMac } = useMacFullscreen();
// Both installed and market detail surfaces share this escape hatch. Let
// nested dialogs and editable controls consume Escape first. Listen on
// document so the detail page settles Escape before the enclosing Settings
// page's window listener, regardless of which mounted first. A held key's
// auto-repeat is not a new press: after the first keydown closes a nested
// layer, repeats must not also go back to the list.
useEffect(() => {
const onKeyDown = (event: KeyboardEvent) => {
if (
event.key !== 'Escape' ||
event.repeat ||
event.defaultPrevented ||
event.isComposing ||
event.altKey ||
event.ctrlKey ||
event.metaKey ||
event.shiftKey ||
isEditableKeyboardTarget(event.target)
) {
return;
}
event.preventDefault();
onBack();
};
document.addEventListener('keydown', onKeyDown);
return () => document.removeEventListener('keydown', onKeyDown);
}, [onBack]);
return (
<div
data-testid="plugin-detail-top-bar"
className={cn(
'sticky top-0 z-20 w-full',
'transition-[background-color] duration-[var(--motion-fast,150ms)] motion-reduce:transition-none',
scrolled ? 'bg-[var(--surface)]' : 'bg-transparent',
isMac && [
'after:pointer-events-none after:absolute after:inset-x-0 after:bottom-0 after:h-px after:bg-[var(--border-default)]',
'after:transition-opacity after:duration-[var(--motion-fast,150ms)] motion-reduce:after:transition-none',
scrolled ? 'after:opacity-100' : 'after:opacity-0',
],
)}
style={isMac ? WINDOW_DRAG_STYLE : undefined}
>
<div
className={cn(
'flex h-16 items-center justify-between gap-3',
frameClassName ?? 'mx-auto w-full max-w-[824px] px-8 max-[760px]:px-6',
)}
>
<button
type="button"
onClick={onBack}
className="-ml-3 inline-flex h-9 w-fit select-none items-center gap-2 rounded-full px-3 text-13 text-[var(--text-secondary)] transition-colors duration-[var(--motion-fast,150ms)] hover:bg-[var(--surface-hover-soft)] hover:text-[var(--text-primary)] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--focus-ring)]"
style={WINDOW_NO_DRAG_STYLE}
>
<ArrowLeft size={16} aria-hidden="true" />
{label}
</button>
{actions ? (
<div className="flex shrink-0 items-center gap-2" style={WINDOW_NO_DRAG_STYLE}>
{actions}
</div>
) : null}
</div>
</div>
);
}