Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
import { useEffect, useRef, useState } from 'react';
import { createPortal } from 'react-dom';
import { useTranslation } from 'react-i18next';
import { Minus, Square, X } from 'lucide-react';
import { cn } from '@/lib/utils';
import { Spinner } from '@/components/ui/spinner';
import { ConfirmDialog } from '@/components/ui/confirm-dialog';
import { isSecondaryWindow } from '@/lib/secondaryWindow';
import { isSidebarWindow } from '@/lib/sidebarWindow';
import { isResourceUsageWindow } from '@/lib/resourceUsageWindow';
import type {
LinuxCloseBehavior,
WindowsCloseBehavior,
} from '../../../shared/windowBehavior';
type DesktopCloseBehavior = LinuxCloseBehavior | WindowsCloseBehavior;
interface WindowControlsProps {
/**
* Tailwind text color class for the icons. Defaults to the title-bar
* warm-gray token so LoginPage / regular title bars stay unchanged.
* Splash screens override this with `text-[hsl(var(--splash-text))]`
* to match the Stone/Silver tones from docs/design-rules/cindy-design-system.md.
*/
iconClassName?: string;
/** Override the default minimize action for an auxiliary window. */
onMinimize?: () => void | Promise<void>;
/** Hide minimize when the current surface explicitly opts out of that action. */
showMinimize?: boolean;
/** Override the default close action for an auxiliary window. */
onClose?: () => void | Promise<void>;
}
const DEFAULT_ICON_CLASS = 'text-titlebar-icon';
export function WindowControls({
iconClassName = DEFAULT_ICON_CLASS,
onMinimize,
showMinimize = true,
onClose,
}: WindowControlsProps = {}) {
const [showCloseDialog, setShowCloseDialog] = useState(false);
const [showCloseBehaviorDialog, setShowCloseBehaviorDialog] = useState(false);
const [savingCloseBehavior, setSavingCloseBehavior] = useState(false);
const savingCloseBehaviorRef = useRef(false);
const closeBehaviorDialogVisibleRef = useRef(false);
// 点 X 后 (无论走确认框还是直接关) 进入不可取消的 closing 态:
// - 有 in-flight turn 路径: ConfirmDialog 显示 loading spinner + 锁住关闭
// - 无 in-flight 路径: 全屏 ClosingOverlay 显示 spinner + "正在关闭…"
// 期间 main 端走 disposer chain (~4-5s, 受 db.backup 体积影响), 完成后窗口/进程退出。
// closingRef 与 setClosing 同步设置,用来让 onOpenChange 在 Radix Action
// 同步触发的 onOpenChange(false) 里也能立刻拦住 (state 还没 flush 到 props)。
const [closing, setClosing] = useState(false);
const closingRef = useRef(false);
const { t } = useTranslation();
useEffect(() => {
if (
onClose ||
(window.electronAPI.platform !== 'win32' && window.electronAPI.platform !== 'linux') ||
isSecondaryWindow() ||
isSidebarWindow() ||
isResourceUsageWindow()
)
return;
const onCloseBehaviorRequested = (): void => {
if (closeBehaviorDialogVisibleRef.current) {
if (window.electronAPI.platform === 'win32') {
window.electronAPI.windowBehavior.notifyWindowsCloseBehaviorPromptShown();
} else {
window.electronAPI.windowBehavior.notifyLinuxCloseBehaviorPromptShown();
}
return;
}
setShowCloseBehaviorDialog(true);
};
return window.electronAPI.platform === 'win32'
? window.electronAPI.windowBehavior.onWindowsCloseBehaviorRequested(onCloseBehaviorRequested)
: window.electronAPI.windowBehavior.onLinuxCloseBehaviorRequested(onCloseBehaviorRequested);
}, [onClose]);
useEffect(() => {
closeBehaviorDialogVisibleRef.current = showCloseBehaviorDialog;
if (!showCloseBehaviorDialog) return;
if (window.electronAPI.platform === 'win32') {
window.electronAPI.windowBehavior.notifyWindowsCloseBehaviorPromptShown();
} else if (window.electronAPI.platform === 'linux') {
window.electronAPI.windowBehavior.notifyLinuxCloseBehaviorPromptShown();
}
}, [showCloseBehaviorDialog]);
const controlBase = cn(
'flex items-center justify-center',
'h-7 w-7',
iconClassName,
'transition-colors',
);
const handleMinimizeClick = (): void => {
if (onMinimize) {
void onMinimize();
return;
}
window.electronAPI.windowMinimize();
};
// 进入 closing 态 + 调 main 端关闭。同时被"点 X 无 in-flight 直走"和 ConfirmDialog
// 的 onConfirm 调用,共用一份语义。幂等: closingRef 守住重复调用。
const beginClose = (): void => {
if (closingRef.current) return;
closingRef.current = true;
setClosing(true);
window.electronAPI.windowClose();
};
const continueCloseWithBehavior = async (behavior: DesktopCloseBehavior): Promise<void> => {
if (behavior === 'tray') {
window.electronAPI.windowClose();
return;
}
if (behavior === 'minimize') {
window.electronAPI.windowMinimize();
return;
}
let hasInFlight = false;
try {
hasInFlight = await window.electronAPI.anySessionInTurn();
} catch {
hasInFlight = false;
}
if (hasInFlight) {
setShowCloseDialog(true);
} else {
beginClose();
}
};
const selectCloseBehavior = async (behavior: DesktopCloseBehavior): Promise<void> => {
if (savingCloseBehaviorRef.current) return;
savingCloseBehaviorRef.current = true;
setSavingCloseBehavior(true);
try {
if (window.electronAPI.platform === 'linux') {
await window.electronAPI.windowBehavior.setLinuxCloseBehavior(
behavior === 'minimize' ? behavior : 'quit',
);
} else {
await window.electronAPI.windowBehavior.setWindowsCloseBehavior(
behavior === 'tray' ? behavior : 'quit',
);
}
setShowCloseBehaviorDialog(false);
await continueCloseWithBehavior(behavior);
} catch {
// 弹窗尚未关闭;持久化失败时保留它,不带着未知行为进入关闭流程。
} finally {
savingCloseBehaviorRef.current = false;
setSavingCloseBehavior(false);
}
};
// 点 X 的入口: Windows 首次关闭先在 renderer 内选择关闭行为,之后再查是否
// 有 in-flight turn。系统 Alt+F4 / 任务栏关闭由 main 发同一个 request 事件,
// 复用这里的自绘弹窗与后续关闭流程。
// - 有 → 走 ConfirmDialog 确认 (防止误关丢未完成的 turn)
// - 无 → 直接 beginClose, 全屏 overlay 反馈 (跳过一次点击)
//
// splash / login 阶段 maker-ipc handler 还没注册, invoke 会 reject ——
// catch 后当作 false 处理 (那个阶段本来就不可能有 in-flight)。
const handleCloseClick = async (): Promise<void> => {
if (onClose) {
await onClose();
return;
}
// 「在新窗口打开」的副窗口 / 右侧栏子窗口 / 插件面板子窗口:关闭只关本窗
// (会话活在主进程,不受影响),不退出 app,也没有 disposer chain,所以跳过
// in-flight 确认框 + 全屏 closing overlay,直接调 windowClose(main 端按
// sender 解析为 win.close())。
if (
isSecondaryWindow() ||
isSidebarWindow() ||
isResourceUsageWindow()
) {
window.electronAPI.windowClose();
return;
}
if (window.electronAPI.platform === 'win32') {
let closeBehavior: WindowsCloseBehavior | null = null;
try {
closeBehavior = await window.electronAPI.windowBehavior.getWindowsCloseBehavior();
} catch {
// Main close handler remains the final authority for the persisted behavior.
}
if (!closeBehavior) {
setShowCloseBehaviorDialog(true);
return;
}
await continueCloseWithBehavior(closeBehavior);
return;
}
if (window.electronAPI.platform === 'linux') {
let closeBehavior: LinuxCloseBehavior | null = null;
try {
closeBehavior = await window.electronAPI.windowBehavior.getLinuxCloseBehavior();
} catch {
// Main close handler remains the final authority for the persisted behavior.
}
if (!closeBehavior) {
setShowCloseBehaviorDialog(true);
return;
}
await continueCloseWithBehavior(closeBehavior);
return;
}
await continueCloseWithBehavior('quit');
};
const keepRunningBehavior: Exclude<DesktopCloseBehavior, 'quit'> =
window.electronAPI.platform === 'linux' ? 'minimize' : 'tray';
return (
<>
<div className="flex gap-0.5">
{showMinimize && (
<button
className={cn(controlBase, 'hover:bg-titlebar-control-hover')}
onClick={handleMinimizeClick}
aria-label={t('titleBar.minimize')}
data-tooltip-exempt="windows-system-control"
>
<Minus size={14} />
</button>
)}
<button
className={cn(controlBase, 'hover:bg-titlebar-control-hover')}
onClick={() => window.electronAPI.windowMaximize()}
aria-label={t('titleBar.maximizeOrRestore')}
data-tooltip-exempt="windows-system-control"
>
<Square size={14} />
</button>
{closing ? (
<span
role="button"
aria-disabled="true"
aria-label={t('titleBar.closing.title')}
tabIndex={0}
data-tooltip-exempt="windows-system-control"
className="inline-flex focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[var(--focus-ring)]"
>
<button
className={cn(controlBase, 'hover:bg-[#E81123] hover:text-white')}
aria-hidden="true"
disabled
>
<X size={14} />
</button>
</span>
) : (
<button
className={cn(controlBase, 'hover:bg-[#E81123] hover:text-white')}
onClick={() => void handleCloseClick()}
aria-label={t('titleBar.close')}
data-tooltip-exempt="windows-system-control"
>
<X size={14} />
</button>
)}
</div>
<ConfirmDialog
open={showCloseBehaviorDialog}
onOpenChange={(next) => {
// Dismissal cancels this close request without saving a choice or closing the window.
if (savingCloseBehaviorRef.current && !next) return;
setShowCloseBehaviorDialog(next);
}}
showCloseButton
title={t('settings.windowBehavior.closePrompt.title')}
description={t('settings.windowBehavior.closePrompt.message')}
content={
<p className="text-sm leading-6 text-[var(--confirm-desc)]">
{t(
window.electronAPI.platform === 'linux'
? 'settings.windowBehavior.closePrompt.linuxDetail'
: 'settings.windowBehavior.closePrompt.detail',
)}
</p>
}
confirmText={t(`settings.windowBehavior.closeBehavior.${keepRunningBehavior}`)}
cancelText={t('settings.windowBehavior.closeBehavior.quit')}
autoFocusConfirm
loading={savingCloseBehavior}
onConfirm={() => void selectCloseBehavior(keepRunningBehavior)}
onCancel={() => void selectCloseBehavior('quit')}
/>
<ConfirmDialog
open={showCloseDialog}
onOpenChange={(next) => {
// loading 期间 Radix Action 的同步 onOpenChange(false) / Cancel /
// 外部状态变化都一律不放过 —— 弹框必须留着直到进程死。
if (closingRef.current && !next) return;
setShowCloseDialog(next);
}}
title={t('titleBar.closeConfirm.title')}
description={t('titleBar.closeConfirm.description')}
confirmText={t('titleBar.closeConfirm.confirm')}
cancelText={t('titleBar.closeConfirm.cancel')}
loading={closing}
onConfirm={beginClose}
/>
<ClosingOverlay visible={closing && !showCloseDialog} />
</>
);
}
/**
* 全屏 closing 反馈层 —— 无 in-flight 直接关闭路径专用 (有 in-flight 时由 ConfirmDialog
* 自己显示 loading spinner, 不需要这层避免双层 spinner)。
*
* 视觉方案: 整窗轻 dim + 中央 capsule (浮卡 + spinner + 单行文字), 用户选定的方案 B
* (vs 全屏强 dim 双行文字 vs 顶部进度条 vs 标题栏 inline)。内容可见但锁定操作。
*
* 走 Portal 渲染到 document.body, 与 title-bar 解耦, 保证整窗 (含其它 modal 之上) 覆盖。
* 整窗 dim 用极轻的 rgba(0,0,0,0.2) (比 `--overlay-modal` 的 0.5 更克制),
* capsule bg 用 `--surface-elevated` 主题 token (规则 18), light/dark 自动适配。
* 不响应点击 / 键盘 / region drag, 锁住所有交互直到进程退出。
*/
function ClosingOverlay({ visible }: { visible: boolean }) {
const { t } = useTranslation();
if (!visible) return null;
return createPortal(
<div
// z-[10000]: 高于 splash 的 z-[9999], 保证退出 overlay 永远在最顶层
className="fixed inset-0 z-[10000] flex select-none items-center justify-center"
style={{ background: 'rgba(0, 0, 0, 0.2)' }}
role="alertdialog"
aria-live="polite"
aria-label={t('titleBar.closing.title')}
>
<div
className="flex items-center gap-2 rounded-full border border-[var(--border-default)] px-4 py-2 shadow-sm"
style={{ background: 'var(--surface-elevated)' }}
>
<Spinner size={16} className="text-[var(--text-primary)]" />
<span className="text-sm text-[var(--text-primary)]">{t('titleBar.closing.title')}</span>
</div>
</div>,
document.body,
);
}