Skip to content

armgit / cindy

Public Imported from GitHub
0

Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。

feat(desktop): 设置页支持 Esc 逐层返回 (#5851)

Dashfb2e1049ba50
diff --git a/apps/desktop/src/renderer/components/settings/SettingsView.tsx b/apps/desktop/src/renderer/components/settings/SettingsView.tsx
index d9235913a3..642b8ef335 100644
--- a/apps/desktop/src/renderer/components/settings/SettingsView.tsx
+++ b/apps/desktop/src/renderer/components/settings/SettingsView.tsx
@@ -13,6 +13,7 @@ import { resolveSettingsSearchEntry } from './settingsSearchCatalog';
import { SettingsSearchNavigationContext } from './SettingsSearchNavigation';
import type { SettingsSearchContext } from './settingsSearchTypes';
import { useSettingsSectionTarget } from './useSettingsSectionTarget';
+import { useSettingsEscape } from './useSettingsEscape';
import { UserProfileCard } from './UserProfileCard';
import { VoiceInputSection } from './VoiceInputSection';
import { AppearanceSection } from './AppearanceSection';
@@ -201,6 +202,17 @@ export function SettingsView() {
setSearchParams(next, { replace: true });
}, [searchParams, setSearchParams]);
+ // 设置是主窗口里的路由,Esc 与左上角返回按钮走同一出口,不关窗。
+ const exitSettings = useCallback(() => navigate('/'), [navigate]);
+ const settingsRootRef = useRef<HTMLDivElement | null>(null);
+
+ // Esc 逐层返回:PI 扩展子页先回到「通用」,其余退出设置;帮助面板开着时归它。
+ const handleSettingsEscape = useCallback(() => {
+ if (piExtensionsPanelOpen) handleClosePiExtensions();
+ else exitSettings();
+ }, [exitSettings, handleClosePiExtensions, piExtensionsPanelOpen]);
+ useSettingsEscape(settingsRootRef, !helpAssistantOpen, handleSettingsEscape);
+
useEffect(() => {
if (activeTab !== 'help') {
setHelpAssistantOpen(false);
@@ -244,6 +256,7 @@ export function SettingsView() {
return (
<SettingsSearchNavigationContext.Provider value={searchNavigation}>
<div
+ ref={settingsRootRef}
className="h-full w-full overflow-hidden bg-[var(--settings-bg)]"
role="main"
aria-label={t('settings.title')}
@@ -262,7 +275,7 @@ export function SettingsView() {
<Tip text={t('settings.back')} side="bottom">
<button
type="button"
- onClick={() => navigate('/')}
+ onClick={exitSettings}
aria-label={t('settings.back')}
className="flex h-7 w-7 items-center justify-center rounded-full text-[var(--settings-back-icon)] transition-[color,background-color,transform] duration-150 hover:bg-titlebar-button-hover hover:text-[var(--settings-back-text)] active:scale-[0.98]"
>
diff --git a/apps/desktop/src/renderer/components/settings/__tests__/SettingsViewEscape.test.tsx b/apps/desktop/src/renderer/components/settings/__tests__/SettingsViewEscape.test.tsx
new file mode 100644
index 0000000000..c160d03cc3
--- /dev/null
+++ b/apps/desktop/src/renderer/components/settings/__tests__/SettingsViewEscape.test.tsx
@@ -0,0 +1,152 @@
+/**
+ * 设置页 Esc 的页面级接线(#5845):PI 扩展子页先回到「通用」、帮助面板先关,
+ * 再按一次才退出设置。各分区内容与本测试无关,统一替换为空壳。
+ * @vitest-environment jsdom
+ */
+import { act, fireEvent, render, screen } from '@testing-library/react';
+import { MemoryRouter, Route, Routes, useLocation } from 'react-router-dom';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+import { DiffPanelShell } from '@/components/diff-panel/DiffPanelShell';
+import { SettingsView } from '../SettingsView';
+
+vi.mock('react-i18next', () => ({
+ useTranslation: () => ({ t: (key: string) => key }),
+}));
+vi.mock('@/contexts/AuthContext', () => ({
+ useAuth: () => ({ mode: 'local', dataOwnerId: null, user: null }),
+}));
+vi.mock('@/lib/useCindyVersions', () => ({
+ useCindyVersions: () => ({ state: 'idle' }),
+}));
+
+const { Stub } = vi.hoisted(() => ({ Stub: () => null }));
+vi.mock('../UserProfileCard', () => ({ UserProfileCard: Stub }));
+vi.mock('../VoiceInputSection', () => ({ VoiceInputSection: Stub }));
+vi.mock('../AppearanceSection', () => ({ AppearanceSection: Stub }));
+vi.mock('../SubagentModelSection', () => ({ SubagentModelSection: Stub }));
+vi.mock('../AuxiliaryModelSection', () => ({ AuxiliaryModelSection: Stub }));
+vi.mock('../VisionBridgeSection', () => ({ VisionBridgeSection: Stub }));
+vi.mock('../ProvidersSection', () => ({ ProvidersSection: Stub }));
+vi.mock('../McpServersSection', () => ({ McpServersSection: Stub }));
+vi.mock('../RemoteControlSection', () => ({ RemoteControlSection: Stub }));
+vi.mock('@/features/device-link/SharedTaskDialog', () => ({ SharedTaskDialog: Stub }));
+vi.mock('../NotificationSection', () => ({ NotificationSection: Stub }));
+vi.mock('../WindowBehaviorSection', () => ({ WindowBehaviorSection: Stub }));
+vi.mock('../ComposerSendShortcutSection', () => ({ ComposerSendShortcutSection: Stub }));
+vi.mock('../KeyboardShortcutsSection', () => ({ KeyboardShortcutsSection: Stub }));
+vi.mock('../AgentIslandSection', () => ({ AgentIslandSection: Stub }));
+vi.mock('../LanguageSection', () => ({ LanguageSection: Stub }));
+vi.mock('../LogoutSection', () => ({ LogoutSection: Stub }));
+vi.mock('../AboutSection', () => ({ AboutSection: Stub }));
+vi.mock('../WorktreeRecycleCard', () => ({ WorktreeRecycleCard: Stub }));
+vi.mock('../StorageManagementCard', () => ({ StorageManagementCard: Stub }));
+vi.mock('../UserPromptSection', () => ({ UserPromptSection: Stub }));
+vi.mock('../MemorySection', () => ({ MemorySection: Stub }));
+vi.mock('../CompactionSection', () => ({ CompactionSection: Stub }));
+vi.mock('../TerminalShellSection', () => ({ TerminalShellSection: Stub }));
+vi.mock('../LinkOpenSection', () => ({ LinkOpenSection: Stub }));
+vi.mock('../StreamFadeSection', () => ({ StreamFadeSection: Stub }));
+vi.mock('../TipsSection', () => ({ TipsSection: Stub }));
+vi.mock('../ExperimentalSection', () => ({ ExperimentalSection: Stub }));
+vi.mock('../GitSafetySection', () => ({ GitSafetySection: Stub }));
+vi.mock('../SessionImportSection', () => ({ SessionImportSection: Stub }));
+vi.mock('../AgentResourceSection', () => ({ AgentResourceSection: Stub }));
+vi.mock('../CollaborationSection', () => ({ CollaborationSection: Stub }));
+vi.mock('../BuiltinToolsSection', () => ({ BuiltinToolsSection: Stub }));
+vi.mock('../contacts/ContactsSection', () => ({ ContactsSection: Stub }));
+vi.mock('../ComputerUseSection', () => ({ ComputerUseSection: Stub }));
+vi.mock('../CindyMakeSection', () => ({ CindyMakeSection: Stub }));
+vi.mock('../SettingsCatalogPanel', () => ({ SettingsCatalogPanel: Stub }));
+vi.mock('@/features/billing/BillingPage', () => ({ BillingSettingsSection: Stub }));
+vi.mock('@/features/bots/BotsGlobalSettingsSection', () => ({ BotsGlobalSettingsSection: Stub }));
+vi.mock('../usage/UsageHistorySection', () => ({ UsageHistorySection: Stub }));
+vi.mock('../SettingsSidebarNav', () => ({ SettingsSidebarNav: Stub }));
+vi.mock('../ImBotSection', () => ({
+ ImBotSection: Stub,
+ isImBotSettingsGroup: (value: unknown) => value === 'cindy' || value === 'personal',
+}));
+vi.mock('../PiPackagesSection', () => ({
+ PiPackagesSection: () => <p>PI packages</p>,
+}));
+vi.mock('../HelpSection', () => ({
+ HelpSection: ({ onAskHelp }: { onAskHelp: () => void }) => (
+ <button type="button" onClick={onAskHelp}>
+ Ask help
+ </button>
+ ),
+}));
+// 帮助面板保留真实的 DiffPanelShell:它自己在 window 上处理 Esc,正是要验证的另一位 owner。
+vi.mock('../HelpAssistantPanel', () => ({
+ HelpAssistantPanel: ({ open, onClose }: { open: boolean; onClose: () => void }) => (
+ <DiffPanelShell open={open} onClose={onClose} ariaLabel="Help assistant" title="Help">
+ <p>Help thread</p>
+ </DiffPanelShell>
+ ),
+}));
+
+function LocationProbe() {
+ const location = useLocation();
+ return <output data-testid="location">{location.pathname + location.search}</output>;
+}
+
+function renderSettings(entry: string) {
+ return render(
+ <MemoryRouter initialEntries={[entry]}>
+ <Routes>
+ <Route path="/settings" element={<SettingsView />} />
+ <Route path="/" element={<p>Home</p>} />
+ </Routes>
+ <LocationProbe />
+ </MemoryRouter>,
+ );
+}
+
+function pressEscape() {
+ act(() => {
+ document.body.dispatchEvent(
+ new KeyboardEvent('keydown', { key: 'Escape', bubbles: true, cancelable: true }),
+ );
+ });
+}
+
+const location = () => screen.getByTestId('location').textContent;
+
+beforeEach(() => {
+ vi.stubGlobal('electronAPI', { platform: 'darwin', appVersion: '1.0.0' });
+ // jsdom 没有元素滚动;设置页切分区时会把内容列滚回顶部。
+ Element.prototype.scrollTo = () => {};
+});
+
+afterEach(() => {
+ vi.unstubAllGlobals();
+});
+
+describe('SettingsView Escape', () => {
+ it('returns from the Pi extensions page to General before leaving Settings', () => {
+ renderSettings('/settings?openPanel=pi-extensions');
+ expect(screen.getByText('PI packages')).toBeTruthy();
+
+ pressEscape();
+ expect(location()).toBe('/settings');
+ expect(screen.queryByText('PI packages')).toBeNull();
+
+ pressEscape();
+ expect(location()).toBe('/');
+ expect(screen.getByText('Home')).toBeTruthy();
+ });
+
+ it('closes the Help panel before leaving Settings', () => {
+ renderSettings('/settings?tab=help');
+ fireEvent.click(screen.getByRole('button', { name: 'Ask help' }));
+ expect(
+ screen.getByRole('complementary', { name: 'Help assistant' }).getAttribute('aria-hidden'),
+ ).not.toBe('true');
+
+ pressEscape();
+ expect(location()).toBe('/settings?tab=help');
+
+ pressEscape();
+ expect(location()).toBe('/');
+ });
+});
diff --git a/apps/desktop/src/renderer/components/settings/__tests__/useSettingsEscape.test.tsx b/apps/desktop/src/renderer/components/settings/__tests__/useSettingsEscape.test.tsx
new file mode 100644
index 0000000000..db379ba1dd
--- /dev/null
+++ b/apps/desktop/src/renderer/components/settings/__tests__/useSettingsEscape.test.tsx
@@ -0,0 +1,285 @@
+/**
+ * 设置页 Esc 逐层返回(#5845):无人认领的 Esc 退出设置;搜索清空、快捷键录制、
+ * 弹窗 / 菜单、插件详情、帮助面板与输入法组字先认领,输入框第一下只失焦。
+ * @vitest-environment jsdom
+ */
+import * as Dialog from '@radix-ui/react-dialog';
+import { act, fireEvent, render, screen } from '@testing-library/react';
+import { useRef, useState, type ReactNode } from 'react';
+import { MemoryRouter } from 'react-router-dom';
+import { afterEach, describe, expect, it, vi } from 'vitest';
+
+import { TAB_IDS } from '@/lib/tabLabels';
+import { PluginDetailTopBar } from '@/features/plugin/PluginDetailTopBar';
+import { PluginManagementLayout } from '@/features/plugin/PluginManagementLayout';
+import { SettingsSidebarNav } from '../SettingsSidebarNav';
+import { useSettingsEscape } from '../useSettingsEscape';
+
+vi.mock('react-i18next', () => ({
+ useTranslation: () => ({
+ t: (key: string) => ({ 'settings.search.ariaLabel': 'Search settings' })[key] ?? key,
+ }),
+}));
+
+afterEach(() => {
+ vi.unstubAllGlobals();
+});
+
+function Harness({
+ onEscape,
+ enabled = true,
+ children,
+}: {
+ onEscape: () => void;
+ enabled?: boolean;
+ children?: ReactNode;
+}) {
+ const rootRef = useRef<HTMLDivElement | null>(null);
+ useSettingsEscape(rootRef, enabled, onEscape);
+ return (
+ <div ref={rootRef} role="main">
+ <button type="button">Tab</button>
+ <input aria-label="Field" />
+ {children}
+ </div>
+ );
+}
+
+function pressEscape(target: EventTarget = document.body, init: KeyboardEventInit = {}) {
+ const event = new KeyboardEvent('keydown', {
+ key: 'Escape',
+ bubbles: true,
+ cancelable: true,
+ ...init,
+ });
+ act(() => {
+ target.dispatchEvent(event);
+ });
+ return event;
+}
+
+describe('useSettingsEscape', () => {
+ it('exits settings when Escape is unclaimed with nothing or a settings control focused', () => {
+ const onEscape = vi.fn();
+ render(<Harness onEscape={onEscape} />);
+
+ expect(pressEscape().defaultPrevented).toBe(true);
+ pressEscape(screen.getByRole('button', { name: 'Tab' }));
+
+ expect(onEscape).toHaveBeenCalledTimes(2);
+ });
+
+ it('leaves a focused settings field on the first Escape and exits on the second', () => {
+ const onEscape = vi.fn();
+ const onBlur = vi.fn();
+ render(
+ <Harness onEscape={onEscape}>
+ <input aria-label="Saved on blur" onBlur={onBlur} />
+ </Harness>,
+ );
+ const field = screen.getByRole('textbox', { name: 'Saved on blur' });
+ field.focus();
+
+ expect(pressEscape(field).defaultPrevented).toBe(true);
+ expect(onBlur).toHaveBeenCalledTimes(1);
+ expect(document.activeElement).toBe(document.body);
+ expect(onEscape).not.toHaveBeenCalled();
+
+ pressEscape();
+ expect(onEscape).toHaveBeenCalledTimes(1);
+ });
+
+ it('clears a non-empty settings search first, then leaves the field, then exits', () => {
+ const onEscape = vi.fn();
+ render(
+ <Harness onEscape={onEscape}>
+ <SettingsSidebarNav tabIds={TAB_IDS} activeTab="general" onSelectTab={vi.fn()} />
+ </Harness>,
+ );
+ const search = screen.getByRole('combobox', { name: 'Search settings' }) as HTMLInputElement;
+ search.focus();
+ fireEvent.change(search, { target: { value: 'theme' } });
+
+ pressEscape(search);
+ expect(search.value).toBe('');
+ expect(document.activeElement).toBe(search);
+
+ pressEscape(search);
+ expect(document.activeElement).toBe(document.body);
+ expect(onEscape).not.toHaveBeenCalled();
+
+ pressEscape();
+ expect(onEscape).toHaveBeenCalledTimes(1);
+ });
+
+ it('clears a non-empty plugin search first, then leaves the field, then exits', () => {
+ const onEscape = vi.fn();
+ function PluginSearch() {
+ const [query, setQuery] = useState('calendar');
+ return (
+ <PluginManagementLayout
+ activeTab="plugins"
+ query={query}
+ onQueryChange={setQuery}
+ searchPlaceholder="Search plugins"
+ clearSearchLabel="Clear plugin search"
+ >
+ <span>Plugins</span>
+ </PluginManagementLayout>
+ );
+ }
+ render(
+ <MemoryRouter>
+ <Harness onEscape={onEscape}>
+ <PluginSearch />
+ </Harness>
+ </MemoryRouter>,
+ );
+ const search = screen.getByRole('textbox', { name: 'Search plugins' }) as HTMLInputElement;
+ search.focus();
+
+ pressEscape(search);
+ expect(search.value).toBe('');
+ expect(document.activeElement).toBe(search);
+ // 按住不放:连发既不失焦也不退出。
+ pressEscape(search, { repeat: true });
+ expect(document.activeElement).toBe(search);
+
+ pressEscape(search);
+ expect(document.activeElement).not.toBe(search);
+ expect(onEscape).not.toHaveBeenCalled();
+
+ pressEscape();
+ expect(onEscape).toHaveBeenCalledTimes(1);
+ });
+
+ it('lets an open dialog close before settings handles Escape', () => {
+ const onEscape = vi.fn();
+ const onOpenChange = vi.fn();
+ render(
+ <Harness onEscape={onEscape}>
+ <Dialog.Root open onOpenChange={onOpenChange}>
+ <Dialog.Portal>
+ <Dialog.Content aria-describedby={undefined}>
+ <Dialog.Title>Nested</Dialog.Title>
+ <button type="button">Inside dialog</button>
+ </Dialog.Content>
+ </Dialog.Portal>
+ </Dialog.Root>
+ </Harness>,
+ );
+
+ pressEscape(screen.getByRole('button', { name: 'Inside dialog' }));
+
+ expect(onOpenChange).toHaveBeenCalledWith(false);
+ expect(onEscape).not.toHaveBeenCalled();
+ });
+
+ it('lets an open plugin detail page go back to its list first', () => {
+ vi.stubGlobal('electronAPI', {
+ platform: 'darwin',
+ getFullscreenState: () => Promise.resolve(false),
+ onFullscreenChange: () => () => {},
+ });
+ const onEscape = vi.fn();
+ const onBack = vi.fn();
+ // 详情页晚于设置页挂载(真实路径:先进设置,再点开插件),监听注册顺序不能决定归属。
+ const { rerender } = render(<Harness onEscape={onEscape} />);
+ rerender(
+ <Harness onEscape={onEscape}>
+ <PluginDetailTopBar label="Plugins" onBack={onBack} scrolled={false} />
+ </Harness>,
+ );
+
+ pressEscape();
+
+ expect(onBack).toHaveBeenCalledTimes(1);
+ expect(onEscape).not.toHaveBeenCalled();
+ });
+
+ it('does not let a held Escape auto-repeat past the layer its first press closed', () => {
+ vi.stubGlobal('electronAPI', {
+ platform: 'darwin',
+ getFullscreenState: () => Promise.resolve(false),
+ onFullscreenChange: () => () => {},
+ });
+ const onEscape = vi.fn();
+ const onBack = vi.fn();
+ const { rerender } = render(<Harness onEscape={onEscape} />);
+ rerender(
+ <Harness onEscape={onEscape}>
+ <PluginDetailTopBar label="Plugins" onBack={onBack} scrolled={false} />
+ </Harness>,
+ );
+
+ pressEscape();
+ expect(onBack).toHaveBeenCalledTimes(1);
+ rerender(<Harness onEscape={onEscape} />);
+
+ pressEscape(document.body, { repeat: true });
+ pressEscape(document.body, { repeat: true });
+ expect(onEscape).not.toHaveBeenCalled();
+
+ pressEscape();
+ expect(onEscape).toHaveBeenCalledTimes(1);
+ });
+
+ it('yields to a layer outside settings, an open morph popover and the help panel', () => {
+ const onEscape = vi.fn();
+ const { rerender } = render(<Harness onEscape={onEscape} />);
+
+ const outside = document.createElement('button');
+ document.body.appendChild(outside);
+ pressEscape(outside);
+ outside.remove();
+
+ const morphPanel = document.createElement('div');
+ morphPanel.setAttribute('data-morph-side', 'bottom');
+ document.body.appendChild(morphPanel);
+ pressEscape();
+ morphPanel.remove();
+
+ rerender(<Harness onEscape={onEscape} enabled={false} />);
+ pressEscape();
+
+ expect(onEscape).not.toHaveBeenCalled();
+ });
+
+ it.each([
+ ['isComposing', { isComposing: true }],
+ ['IME keyCode 229', { keyCode: 229 }],
+ ['auto-repeat', { repeat: true }],
+ ['altKey', { altKey: true }],
+ ['ctrlKey', { ctrlKey: true }],
+ ['metaKey', { metaKey: true }],
+ ['shiftKey', { shiftKey: true }],
+ ] as const)('ignores Escape carrying %s', (_label, init) => {
+ const onEscape = vi.fn();
+ render(<Harness onEscape={onEscape} />);
+ const field = screen.getByRole('textbox', { name: 'Field' });
+ field.focus();
+
+ pressEscape(field, init);
+ pressEscape(document.body, init);
+
+ expect(document.activeElement).toBe(field);
+ expect(onEscape).not.toHaveBeenCalled();
+ });
+
+ it('ignores Escape already consumed by an inner handler', () => {
+ const onEscape = vi.fn();
+ render(<Harness onEscape={onEscape} />);
+ const consumed = new KeyboardEvent('keydown', {
+ key: 'Escape',
+ bubbles: true,
+ cancelable: true,
+ });
+ consumed.preventDefault();
+
+ act(() => {
+ document.body.dispatchEvent(consumed);
+ });
+
+ expect(onEscape).not.toHaveBeenCalled();
+ });
+});
diff --git a/apps/desktop/src/renderer/components/settings/useSettingsEscape.ts b/apps/desktop/src/renderer/components/settings/useSettingsEscape.ts
new file mode 100644
index 0000000000..183cae18dd
--- /dev/null
+++ b/apps/desktop/src/renderer/components/settings/useSettingsEscape.ts
@@ -0,0 +1,57 @@
+import { useEffect, type RefObject } from 'react';
+
+import { isEditableKeyboardTarget, shouldCardShortcutYield } from '@/lib/editableKeyboardTarget';
+
+/**
+ * 设置页的 Esc 逐层返回(全平台同一套)。按键只在无人认领时才由设置页处理:
+ * 搜索框清空、快捷键录制、弹窗 / 菜单 / 插件详情等内层先消费,输入法组字中的
+ * Esc 只取消候选。焦点在设置页的输入框里时,第一下只离开输入框(等同点到别处,
+ * 失焦即保存的字段照常提交),再按一次才交给 onEscape。一次按下只退一层,按住
+ * 不放产生的自动连发一律忽略。
+ *
+ * 挂在 window 冒泡阶段,晚于 document 与组件层的处理者;同在 window 上的内层
+ * (帮助面板)由调用方通过 enabled 让路。
+ */
+export function useSettingsEscape(
+ rootRef: RefObject<HTMLElement | null>,
+ enabled: boolean,
+ onEscape: () => void,
+) {
+ useEffect(() => {
+ if (!enabled) return;
+ const onKeyDown = (event: KeyboardEvent) => {
+ // 按住 Esc 的自动连发不算新的一下:首个 keydown 关掉内层后,连发不能接着退出设置。
+ if (
+ event.key !== 'Escape' ||
+ event.repeat ||
+ event.keyCode === 229 ||
+ event.altKey ||
+ event.ctrlKey ||
+ event.metaKey ||
+ event.shiftKey
+ ) {
+ return;
+ }
+ const root = rootRef.current;
+ const target = event.target;
+ if (
+ !event.defaultPrevented &&
+ !event.isComposing &&
+ isEditableKeyboardTarget(target) &&
+ root?.contains(target)
+ ) {
+ event.preventDefault();
+ target.blur();
+ return;
+ }
+ if (shouldCardShortcutYield(event, 'dismiss', root)) return;
+ // MorphPopover(模型选择器等)在 document capture 里关闭但不 preventDefault,
+ // 面板会挂到收合动画结束;它在场时这一下 Esc 归它。
+ if (document.querySelector('[data-morph-side]')) return;
+ event.preventDefault();
+ onEscape();
+ };
+ window.addEventListener('keydown', onKeyDown);
+ return () => window.removeEventListener('keydown', onKeyDown);
+ }, [enabled, onEscape, rootRef]);
+}
diff --git a/apps/desktop/src/renderer/features/plugin/PluginDetailTopBar.tsx b/apps/desktop/src/renderer/features/plugin/PluginDetailTopBar.tsx
index 3e7f5abd16..940585f5fe 100644
--- a/apps/desktop/src/renderer/features/plugin/PluginDetailTopBar.tsx
+++ b/apps/desktop/src/renderer/features/plugin/PluginDetailTopBar.tsx
@@ -69,11 +69,16 @@ export function PluginDetailTopBar({ label, onBack, scrolled }: PluginDetailTopB
const { isMac } = useMacFullscreen();
// Both installed and market detail surfaces share this escape hatch. Let
- // nested dialogs and editable controls consume Escape first.
+ // 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 ||
@@ -87,8 +92,8 @@ export function PluginDetailTopBar({ label, onBack, scrolled }: PluginDetailTopB
event.preventDefault();
onBack();
};
- window.addEventListener('keydown', onKeyDown);
- return () => window.removeEventListener('keydown', onKeyDown);
+ document.addEventListener('keydown', onKeyDown);
+ return () => document.removeEventListener('keydown', onKeyDown);
}, [onBack]);
return (
diff --git a/apps/desktop/src/renderer/features/plugin/PluginManagementLayout.tsx b/apps/desktop/src/renderer/features/plugin/PluginManagementLayout.tsx
index 4f420c12bc..234bed9900 100644
--- a/apps/desktop/src/renderer/features/plugin/PluginManagementLayout.tsx
+++ b/apps/desktop/src/renderer/features/plugin/PluginManagementLayout.tsx
@@ -203,6 +203,10 @@ export function PluginManagementHeader({
onKeyDown={(event) => {
if (event.nativeEvent.isComposing) return;
if (event.key !== 'Escape') return;
+ // 认领这一下 Esc:外层(设置页)不再接着失焦或退出。
+ event.preventDefault();
+ // 按住不放的自动连发不算新的一下:清空后不能接着失焦。
+ if (event.repeat) return;
if (query) {
onQueryChange('');
} else {
diff --git a/apps/desktop/src/renderer/features/plugin/__tests__/GhostPluginPage.navigation.test.tsx b/apps/desktop/src/renderer/features/plugin/__tests__/GhostPluginPage.navigation.test.tsx
index acd2e285e6..a880c2d517 100644
--- a/apps/desktop/src/renderer/features/plugin/__tests__/GhostPluginPage.navigation.test.tsx
+++ b/apps/desktop/src/renderer/features/plugin/__tests__/GhostPluginPage.navigation.test.tsx
@@ -161,7 +161,7 @@ describe('plugin page return navigation', () => {
if (method === 'button') {
fireEvent.click(screen.getByRole('button', { name: 'settings.ghosts.detail.backToList' }));
} else {
- fireEvent.keyDown(window, { key: 'Escape' });
+ fireEvent.keyDown(document.body, { key: 'Escape' });
}
expect(screen.getByRole('main').scrollTop).toBe(640);
@@ -177,7 +177,7 @@ describe('plugin page return navigation', () => {
it('restores ordinary catalog navigation without a pending recommendation', async () => {
render(page('/plugins'));
await openFromCatalog();
- fireEvent.keyDown(window, { key: 'Escape' });
+ fireEvent.keyDown(document.body, { key: 'Escape' });
expect(screen.getByRole('main').scrollTop).toBe(640);
expect(getPendingPluginSuggestion()).toBeNull();
});
@@ -198,7 +198,7 @@ describe('plugin page return navigation', () => {
mounted.rerender(page(`/plugins?recommendation=${nonce}`));
await waitFor(() => expect(loadDetail).toHaveBeenCalledTimes(2));
- fireEvent.keyDown(window, { key: 'Escape' });
+ fireEvent.keyDown(document.body, { key: 'Escape' });
await act(async () => {
finishRefresh({ ...detail, name: 'Refreshed Plugin' });
});
diff --git a/apps/desktop/src/renderer/features/plugin/__tests__/PluginDetailTopBar.test.tsx b/apps/desktop/src/renderer/features/plugin/__tests__/PluginDetailTopBar.test.tsx
index 42d22cd60a..159ba3fdc2 100644
--- a/apps/desktop/src/renderer/features/plugin/__tests__/PluginDetailTopBar.test.tsx
+++ b/apps/desktop/src/renderer/features/plugin/__tests__/PluginDetailTopBar.test.tsx
@@ -15,7 +15,9 @@ import { PluginDetailTopBar, usePluginDetailScrolled } from '../PluginDetailTopB
/** jsdom 下 `-webkit-app-region` 只能从 React 写进 style 对象的驼峰键读回。 */
function appRegionOf(element: HTMLElement): string {
- return (element.style as CSSStyleDeclaration & { WebkitAppRegion?: string }).WebkitAppRegion ?? '';
+ return (
+ (element.style as CSSStyleDeclaration & { WebkitAppRegion?: string }).WebkitAppRegion ?? ''
+ );
}
afterEach(() => {
@@ -49,7 +51,7 @@ describe('PluginDetailTopBar', () => {
render(<Harness onBack={onBack} />);
const event = new KeyboardEvent('keydown', { key: 'Escape', cancelable: true });
- window.dispatchEvent(event);
+ document.dispatchEvent(event);
expect(onBack).toHaveBeenCalledTimes(1);
expect(event.defaultPrevented).toBe(true);
@@ -60,7 +62,7 @@ describe('PluginDetailTopBar', () => {
const onBack = vi.fn();
render(<Harness onBack={onBack} />);
- fireEvent.keyDown(window, { key: 'Escape', metaKey: true });
+ fireEvent.keyDown(document, { key: 'Escape', metaKey: true });
const input = document.createElement('input');
document.body.appendChild(input);
@@ -69,18 +71,18 @@ describe('PluginDetailTopBar', () => {
const consumed = new KeyboardEvent('keydown', { key: 'Escape', cancelable: true });
consumed.preventDefault();
- window.dispatchEvent(consumed);
+ document.dispatchEvent(consumed);
expect(onBack).not.toHaveBeenCalled();
});
- it.each(['altKey', 'ctrlKey', 'metaKey', 'shiftKey', 'isComposing'])(
+ it.each(['altKey', 'ctrlKey', 'metaKey', 'shiftKey', 'isComposing', 'repeat'])(
'does not navigate back when Escape carries %s',
(flag) => {
const onBack = vi.fn();
render(<Harness onBack={onBack} />);
- fireEvent.keyDown(window, { key: 'Escape', [flag]: true });
+ fireEvent.keyDown(document, { key: 'Escape', [flag]: true });
expect(onBack).not.toHaveBeenCalled();
},
diff --git a/apps/desktop/src/renderer/features/plugin/__tests__/PluginManagementLayout.test.tsx b/apps/desktop/src/renderer/features/plugin/__tests__/PluginManagementLayout.test.tsx
index 9725578577..7980ea1462 100644
--- a/apps/desktop/src/renderer/features/plugin/__tests__/PluginManagementLayout.test.tsx
+++ b/apps/desktop/src/renderer/features/plugin/__tests__/PluginManagementLayout.test.tsx
@@ -237,6 +237,33 @@ describe('PluginManagementLayout', () => {
expect(document.activeElement).not.toBe(searchInput);
});
+ it('ignores a held Escape auto-repeat so one press clears without also blurring', () => {
+ const onQueryChange = vi.fn();
+ render(
+ <MemoryRouter>
+ <PluginManagementLayout activeTab="skills" query="calendar" onQueryChange={onQueryChange}>
+ <span>Content</span>
+ </PluginManagementLayout>
+ </MemoryRouter>,
+ );
+
+ const searchInput = screen.getByRole('textbox', { name: 'Search skills' });
+ searchInput.focus();
+ const repeat = new KeyboardEvent('keydown', {
+ key: 'Escape',
+ repeat: true,
+ bubbles: true,
+ cancelable: true,
+ });
+ act(() => {
+ searchInput.dispatchEvent(repeat);
+ });
+
+ expect(onQueryChange).not.toHaveBeenCalled();
+ expect(document.activeElement).toBe(searchInput);
+ expect(repeat.defaultPrevented).toBe(true);
+ });
+
it('leaves the search query and focus intact when IME handles Escape', () => {
const onQueryChange = vi.fn();
render(
diff --git a/apps/desktop/src/renderer/lib/editableKeyboardTarget.ts b/apps/desktop/src/renderer/lib/editableKeyboardTarget.ts
index ce0eb58f46..3c3726e8d2 100644
--- a/apps/desktop/src/renderer/lib/editableKeyboardTarget.ts
+++ b/apps/desktop/src/renderer/lib/editableKeyboardTarget.ts
@@ -5,7 +5,7 @@
* ShareSelectionBar(⌘A / Esc)共用同一判据,同一语义只留一个实现;也让
* 依赖它的小组件不必为了一个工具函数 import 整个 MessageStream。
*/
-export function isEditableKeyboardTarget(target: EventTarget | null): boolean {
+export function isEditableKeyboardTarget(target: EventTarget | null): target is HTMLElement {
if (!(target instanceof HTMLElement)) return false;
const tagName = target.tagName;
return (
diff --git a/docs/design-rules/DESIGN.md b/docs/design-rules/DESIGN.md
index c83fbe808b..06577e849e 100644
--- a/docs/design-rules/DESIGN.md
+++ b/docs/design-rules/DESIGN.md
@@ -1030,6 +1030,7 @@ Known but deliberately-deferred cleanups are tracked in the decision log's backl
- When a dismissible form opens, focus its primary input. Ordinary ConfirmDialog retains Cancel by default; explicit `autoFocusConfirm` opts into the primary action, and typed confirmation takes precedence (§4, DS-6). Selection-only dialogs such as InstallTargetPicker start on Cancel to avoid focusing an immediate installation action. Contain Tab, support Esc when idle, and restore the opener on close; actual saving/installation blocks dismissal until settlement.
- On close, focus returns to the triggering element (Radix default — don't break it).
- Composer-replacing cards (permission, plan review, ask) take window-level Enter / Esc / number shortcuts only when the key is otherwise unclaimed. An already-handled key, IME composition, an editable field, a control or popup layer outside the card, and Enter on the card's own control (native activation — Enter on Deny denies) all take precedence. Implementation: `shouldCardShortcutYield` in [editableKeyboardTarget.ts](../../apps/desktop/src/renderer/lib/editableKeyboardTarget.ts); regressions in [cardShortcutYield.test.tsx](../../apps/desktop/src/renderer/__tests__/cardShortcutYield.test.tsx).
+- Settings (an in-window route, all desktop platforms) steps back one level on an unclaimed Esc, the same exit as its top-left Back: the Pi extensions sub-page returns to General, otherwise Settings closes. Inner owners settle first — clearing a non-empty search, shortcut recording, dialogs / menus / popovers, a plugin detail page (back to its list) and the Help panel; IME composition, modified Esc and auto-repeat from a held key never navigate (one physical press steps back one level). With a Settings field focused, the first Esc only leaves the field (blur-to-save fields commit as on click-away) and the next one exits. Implementation: [useSettingsEscape.ts](../../apps/desktop/src/renderer/components/settings/useSettingsEscape.ts); regressions in [useSettingsEscape.test.tsx](../../apps/desktop/src/renderer/components/settings/__tests__/useSettingsEscape.test.tsx).
### 14.3 Keyboard & IME (send-type text fields)
diff --git a/docs/design-rules/design-inventory.md b/docs/design-rules/design-inventory.md
index 644af37156..8c0251ff53 100644
--- a/docs/design-rules/design-inventory.md
+++ b/docs/design-rules/design-inventory.md
@@ -38,7 +38,7 @@
| `desktop.overlay.toast` | desktop | Toast | App 常驻 ToastContainer(用户可见出口,不展开业务逻辑) | Toast, ToastContainer | apps/desktop/src/renderer/components/ui/toast/Toast.tsx, apps/desktop/src/renderer/components/ui/toast/ToastContainer.tsx, apps/desktop/src/renderer/components/ui/toast/index.ts | 5 | 4 | 3 |
| `desktop.plugins.app-main` | desktop | 插件主视图 | hash `/apps/:ghostId`(GhostMainViewFeatureLayout) | GhostMainViewFeatureLayout, GhostMainViewHost | apps/desktop/src/renderer/features/plugin/GhostMainViewFeatureLayout.tsx, apps/desktop/src/renderer/features/plugin/GhostMainViewHost.tsx | 0 | 0 | 0 |
| `desktop.plugins.installed` | desktop | 已装插件 | hash `/plugins`(GhostPluginPage) | AddMarketplaceDialog, GhostPluginDetailView, GhostPluginPage, MarketPluginDetailView, MyPublishesSection, PluginManagementLayout, PluginScopePicker, UpdateAllDialog | apps/desktop/src/renderer/features/plugin/AddMarketplaceDialog.tsx, apps/desktop/src/renderer/features/plugin/GhostPluginDetailView.tsx, apps/desktop/src/renderer/features/plugin/GhostPluginPage.tsx, apps/desktop/src/renderer/features/plugin/MarketPluginDetailView.tsx, apps/desktop/src/renderer/features/plugin/MyPublishesSection.tsx, apps/desktop/src/renderer/features/plugin/PluginManagementLayout.tsx, apps/desktop/src/renderer/features/plugin/PluginScopePicker.tsx, apps/desktop/src/renderer/features/plugin/UpdateAllDialog.tsx, apps/desktop/src/renderer/features/plugin/plugin-motion.css | 28 | 0 | 48 |
-| `desktop.settings` | desktop | 设置 | hash `/settings`(SettingsView;tab 含 general / personalization / providers / billing / usage / voice-input / im-bot / shortcuts / agent-island / import / remote-control / ghosts / builtin-tools / computer-use / help / about) | SettingsView | apps/desktop/src/renderer/components/settings/AboutSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AboutSection.tsx, apps/desktop/src/renderer/components/settings/AccountDeletionSection.tsx, apps/desktop/src/renderer/components/settings/AddProviderWizard.tsx, apps/desktop/src/renderer/components/settings/AgentIslandSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AgentIslandSection.tsx, apps/desktop/src/renderer/components/settings/AgentResourceSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AgentResourceSection.tsx, apps/desktop/src/renderer/components/settings/AppearanceSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AppearanceSection.tsx, apps/desktop/src/renderer/components/settings/AuxiliaryModelSection.tsx, apps/desktop/src/renderer/components/settings/BetaChannelCell.tsx, apps/desktop/src/renderer/components/settings/BillingSettings.settings-search.ts, apps/desktop/src/renderer/components/settings/BrowserBackendSubsection.tsx, apps/desktop/src/renderer/components/settings/BrowserRealProfileSubsection.tsx, apps/desktop/src/renderer/components/settings/BuiltinToolsSection.settings-search.ts, apps/desktop/src/renderer/components/settings/BuiltinToolsSection.tsx, apps/desktop/src/renderer/components/settings/ChatEmbeddingCell.tsx, apps/desktop/src/renderer/components/settings/ChipMetricsSection.tsx, apps/desktop/src/renderer/components/settings/CindyMakeSection.settings-search.ts, apps/desktop/src/renderer/components/settings/CindyMakeSection.tsx, apps/desktop/src/renderer/components/settings/CollaborationSection.settings-search.ts, apps/desktop/src/renderer/components/settings/CollaborationSection.tsx, apps/desktop/src/renderer/components/settings/CompactionSection.tsx, apps/desktop/src/renderer/components/settings/ComposerSendShortcutSection.tsx, apps/desktop/src/renderer/components/settings/ComputerPermissionGuideWindow.tsx, apps/desktop/src/renderer/components/settings/ComputerPermissionRow.tsx, apps/desktop/src/renderer/components/settings/ComputerUseSection.settings-search.ts, apps/desktop/src/renderer/components/settings/ComputerUseSection.tsx, apps/desktop/src/renderer/components/settings/CustomProviderRuntimeFillOverlay.tsx, apps/desktop/src/renderer/components/settings/DefaultOverrideControls.tsx, apps/desktop/src/renderer/components/settings/DialogueDirectorySection.tsx, apps/desktop/src/renderer/components/settings/DingTalkBotSection.tsx, apps/desktop/src/renderer/components/settings/DiscordBotSection.tsx, apps/desktop/src/renderer/components/settings/DownloadMeter.tsx, apps/desktop/src/renderer/components/settings/ExperimentalSection.tsx, apps/desktop/src/renderer/components/settings/FeishuBotNotificationSection.tsx, apps/desktop/src/renderer/components/settings/FeishuBotSection.tsx, apps/desktop/src/renderer/components/settings/FontFamilyPicker.tsx, apps/desktop/src/renderer/components/settings/GeneralSettings.settings-search.ts, apps/desktop/src/renderer/components/settings/GenericGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/GitSafetySection.settings-search.ts, apps/desktop/src/renderer/components/settings/GitSafetySection.tsx, apps/desktop/src/renderer/components/settings/HarnessVersionMenuRow.tsx, apps/desktop/src/renderer/components/settings/HelpAssistantPanel.tsx, apps/desktop/src/renderer/components/settings/HelpSection.settings-search.ts, apps/desktop/src/renderer/components/settings/HelpSection.tsx, apps/desktop/src/renderer/components/settings/HelpThreadView.tsx, apps/desktop/src/renderer/components/settings/HookConnectionsSection.tsx, apps/desktop/src/renderer/components/settings/HookWorkspacePrefsEditor.tsx, apps/desktop/src/renderer/components/settings/ImBotSection.settings-search.ts, apps/desktop/src/renderer/components/settings/ImBotSection.tsx, apps/desktop/src/renderer/components/settings/ImChannelSettingsCard.tsx, apps/desktop/src/renderer/components/settings/ImDefaultSettingsSection.tsx, apps/desktop/src/renderer/components/settings/ImLifecycleAnnouncementSection.tsx, apps/desktop/src/renderer/components/settings/InputDeviceConnectionStatus.tsx, apps/desktop/src/renderer/components/settings/JoyConGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/KeyboardShortcutsSection.settings-search.ts, apps/desktop/src/renderer/components/settings/KeyboardShortcutsSection.tsx, apps/desktop/src/renderer/components/settings/LanguageSection.tsx, apps/desktop/src/renderer/components/settings/LayoutResetControl.tsx, apps/desktop/src/renderer/components/settings/LinkOpenSection.tsx, apps/desktop/src/renderer/components/settings/LlamaCppCandidates.tsx, apps/desktop/src/renderer/components/settings/LlamaCppProviderDetail.tsx, apps/desktop/src/renderer/components/settings/LocalModelDownloadUI.tsx, apps/desktop/src/renderer/components/settings/LocalOllamaInstall.tsx, apps/desktop/src/renderer/components/settings/LocalPackagingTag.tsx, apps/desktop/src/renderer/components/settings/LogoutSection.tsx, apps/desktop/src/renderer/components/settings/LspBetaCell.tsx, apps/desktop/src/renderer/components/settings/McpServerDialog.tsx, apps/desktop/src/renderer/components/settings/McpServersSection.tsx, apps/desktop/src/renderer/components/settings/MemorySection.tsx, apps/desktop/src/renderer/components/settings/MessageNavRailCell.tsx, apps/desktop/src/renderer/components/settings/ModelAdvancedDrawer.tsx, apps/desktop/src/renderer/components/settings/ModelPriceOverrideDialog.tsx, apps/desktop/src/renderer/components/settings/MyDevicesPanel.tsx, apps/desktop/src/renderer/components/settings/NotificationSection.settings-search.ts, apps/desktop/src/renderer/components/settings/NotificationSection.tsx, apps/desktop/src/renderer/components/settings/OAuthDeviceCodeCard.tsx, apps/desktop/src/renderer/components/settings/OllamaProviderDetail.tsx, apps/desktop/src/renderer/components/settings/OwnRemoteProviders.tsx, apps/desktop/src/renderer/components/settings/PersonalizationDetails.settings-search.ts, apps/desktop/src/renderer/components/settings/PersonalizationSettings.settings-search.ts, apps/desktop/src/renderer/components/settings/PiKernelVersionRow.tsx, apps/desktop/src/renderer/components/settings/PiPackagesSection.tsx, apps/desktop/src/renderer/components/settings/PlayStationGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/ProfileEditDialog.tsx, apps/desktop/src/renderer/components/settings/ProviderConnectionDialog.tsx, apps/desktop/src/renderer/components/settings/ProviderImportDialog.tsx, apps/desktop/src/renderer/components/settings/ProvidersSection.settings-search.ts, apps/desktop/src/renderer/components/settings/ProvidersSection.tsx, apps/desktop/src/renderer/components/settings/ReadOnlyProviderModels.tsx, apps/desktop/src/renderer/components/settings/RemoteControlSection.settings-search.ts, apps/desktop/src/renderer/components/settings/RemoteControlSection.tsx, apps/desktop/src/renderer/components/settings/RemoteDesktopPermissions.tsx, apps/desktop/src/renderer/components/settings/RemoteDesktopSetting.tsx, apps/desktop/src/renderer/components/settings/RemoteHostDetail.tsx, apps/desktop/src/renderer/components/settings/RemoteSection.tsx, apps/desktop/src/renderer/components/settings/SessionImportSection.settings-search.ts, apps/desktop/src/renderer/components/settings/SessionImportSection.tsx, apps/desktop/src/renderer/components/settings/SessionRuntimeFallbackCell.tsx, apps/desktop/src/renderer/components/settings/SessionShareImportWizard.tsx, apps/desktop/src/renderer/components/settings/SettingsCatalogPanel.settings-search.ts, apps/desktop/src/renderer/components/settings/SettingsCatalogPanel.tsx, apps/desktop/src/renderer/components/settings/SettingsSearchBox.tsx, apps/desktop/src/renderer/components/settings/SettingsSearchNavigation.ts, apps/desktop/src/renderer/components/settings/SettingsSidebarNav.tsx, apps/desktop/src/renderer/components/settings/SettingsTextInput.tsx, apps/desktop/src/renderer/components/settings/SettingsView.tsx, apps/desktop/src/renderer/components/settings/SharedTasks.settings-search.ts, apps/desktop/src/renderer/components/settings/SilentEncryptedRetryCell.tsx, apps/desktop/src/renderer/components/settings/SshKeySetupDialog.tsx, apps/desktop/src/renderer/components/settings/StorageManagementCard.settings-search.ts, apps/desktop/src/renderer/components/settings/StorageManagementCard.tsx, apps/desktop/src/renderer/components/settings/StreamFadeSection.tsx, apps/desktop/src/renderer/components/settings/SubagentModelSection.settings-search.ts, apps/desktop/src/renderer/components/settings/SubagentModelSection.tsx, apps/desktop/src/renderer/components/settings/SwitchProGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/TelegramBehaviorSettings.tsx, apps/desktop/src/renderer/components/settings/TelegramBotSection.tsx, apps/desktop/src/renderer/components/settings/TelegramRemoteDevices.tsx, apps/desktop/src/renderer/components/settings/TerminalShellSection.tsx, apps/desktop/src/renderer/components/settings/TipsSection.settings-search.ts, apps/desktop/src/renderer/components/settings/TipsSection.tsx, apps/desktop/src/renderer/components/settings/UnifiedModelList.tsx, apps/desktop/src/renderer/components/settings/UserProfileCard.tsx, apps/desktop/src/renderer/components/settings/UserPromptSection.tsx, apps/desktop/src/renderer/components/settings/VisionBridgeSection.settings-search.ts, apps/desktop/src/renderer/components/settings/VisionBridgeSection.tsx, apps/desktop/src/renderer/components/settings/VoiceInputSection.settings-search.ts, apps/desktop/src/renderer/components/settings/VoiceInputSection.tsx, apps/desktop/src/renderer/components/settings/WallpaperSection.tsx, apps/desktop/src/renderer/components/settings/WechatBotSection.tsx, apps/desktop/src/renderer/components/settings/WecomBotSection.tsx, apps/desktop/src/renderer/components/settings/WindowBehaviorSection.settings-search.ts, apps/desktop/src/renderer/components/settings/WindowBehaviorSection.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexKeyboardLayout.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexKeycapGlyphs.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexSettings.tsx, apps/desktop/src/renderer/components/settings/WorktreeRecycleCard.settings-search.ts, apps/desktop/src/renderer/components/settings/WorktreeRecycleCard.tsx, apps/desktop/src/renderer/components/settings/XUsageGuide.tsx, apps/desktop/src/renderer/components/settings/XboxGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/XboxGamepadSettings.tsx, apps/desktop/src/renderer/components/settings/androidStatusPresentation.ts, apps/desktop/src/renderer/components/settings/billingVisibility.ts, apps/desktop/src/renderer/components/settings/browserOpenForLoginError.ts, apps/desktop/src/renderer/components/settings/cindyMakeVisibility.ts, apps/desktop/src/renderer/components/settings/computerPermissionFlow.ts, apps/desktop/src/renderer/components/settings/contacts/ContactDetailPane.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsImportDialog.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsListPane.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsManagerDialog.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsSection.tsx, apps/desktop/src/renderer/components/settings/contacts/startContactsAiSession.ts, apps/desktop/src/renderer/components/settings/dialogueDirectoryDisplay.ts, apps/desktop/src/renderer/components/settings/dualSenseSilhouette.ts, apps/desktop/src/renderer/components/settings/feishuBotPresentation.ts, apps/desktop/src/renderer/components/settings/fontFamilyValue.ts, apps/desktop/src/renderer/components/settings/gamepadLayoutPrimitives.tsx, apps/desktop/src/renderer/components/settings/gamepadSilhouetteGeom.ts, apps/desktop/src/renderer/components/settings/hookWorkspacePrefsLogic.ts, apps/desktop/src/renderer/components/settings/imBotVisibility.ts, apps/desktop/src/renderer/components/settings/imDefaultSettingsLogic.ts, apps/desktop/src/renderer/components/settings/joyConSilhouette.ts, apps/desktop/src/renderer/components/settings/modelManagementPresentation.ts, apps/desktop/src/renderer/components/settings/modelManagementState.ts, apps/desktop/src/renderer/components/settings/myDevicesModel.ts, apps/desktop/src/renderer/components/settings/providerAssetModule.ts, apps/desktop/src/renderer/components/settings/realProfilePermissionGuide.ts, apps/desktop/src/renderer/components/settings/settingsSearchCatalog.ts, apps/desktop/src/renderer/components/settings/settingsSearchTypes.ts, apps/desktop/src/renderer/components/settings/switchProSilhouette.ts, apps/desktop/src/renderer/components/settings/ultimateC1Silhouette.ts, apps/desktop/src/renderer/components/settings/usage/UsageBarsTooltip.tsx, apps/desktop/src/renderer/components/settings/usage/UsageBreakdownTables.tsx, apps/desktop/src/renderer/components/settings/usage/UsageDeviceSelect.tsx, apps/desktop/src/renderer/components/settings/usage/UsageHistorySection.settings-search.ts, apps/desktop/src/renderer/components/settings/usage/UsageHistorySection.tsx, apps/desktop/src/renderer/components/settings/usage/UsageStatRow.tsx, apps/desktop/src/renderer/components/settings/usage/UsageTaskTable.tsx, apps/desktop/src/renderer/components/settings/usage/UsageTokenBars.tsx, apps/desktop/src/renderer/components/settings/usage/formatUsagePercent.ts, apps/desktop/src/renderer/components/settings/usage/usageCharts.css, apps/desktop/src/renderer/components/settings/usage/usageHistoryColors.ts, apps/desktop/src/renderer/components/settings/usage/usageHistoryStats.ts, apps/desktop/src/renderer/components/settings/usageVisibility.ts, apps/desktop/src/renderer/components/settings/useProviderSubscriptionCard.ts, apps/desktop/src/renderer/components/settings/useSettingsSectionTarget.ts, apps/desktop/src/renderer/components/settings/wizardRecommend.ts, apps/desktop/src/renderer/components/settings/workLouderCodexCommandCopy.ts, apps/desktop/src/renderer/components/settings/xboxSeriesSilhouette.ts, apps/desktop/src/renderer/styles/sortable.css | 137 | 100 | 544 |
+| `desktop.settings` | desktop | 设置 | hash `/settings`(SettingsView;tab 含 general / personalization / providers / billing / usage / voice-input / im-bot / shortcuts / agent-island / import / remote-control / ghosts / builtin-tools / computer-use / help / about) | SettingsView | apps/desktop/src/renderer/components/settings/AboutSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AboutSection.tsx, apps/desktop/src/renderer/components/settings/AccountDeletionSection.tsx, apps/desktop/src/renderer/components/settings/AddProviderWizard.tsx, apps/desktop/src/renderer/components/settings/AgentIslandSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AgentIslandSection.tsx, apps/desktop/src/renderer/components/settings/AgentResourceSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AgentResourceSection.tsx, apps/desktop/src/renderer/components/settings/AppearanceSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AppearanceSection.tsx, apps/desktop/src/renderer/components/settings/AuxiliaryModelSection.tsx, apps/desktop/src/renderer/components/settings/BetaChannelCell.tsx, apps/desktop/src/renderer/components/settings/BillingSettings.settings-search.ts, apps/desktop/src/renderer/components/settings/BrowserBackendSubsection.tsx, apps/desktop/src/renderer/components/settings/BrowserRealProfileSubsection.tsx, apps/desktop/src/renderer/components/settings/BuiltinToolsSection.settings-search.ts, apps/desktop/src/renderer/components/settings/BuiltinToolsSection.tsx, apps/desktop/src/renderer/components/settings/ChatEmbeddingCell.tsx, apps/desktop/src/renderer/components/settings/ChipMetricsSection.tsx, apps/desktop/src/renderer/components/settings/CindyMakeSection.settings-search.ts, apps/desktop/src/renderer/components/settings/CindyMakeSection.tsx, apps/desktop/src/renderer/components/settings/CollaborationSection.settings-search.ts, apps/desktop/src/renderer/components/settings/CollaborationSection.tsx, apps/desktop/src/renderer/components/settings/CompactionSection.tsx, apps/desktop/src/renderer/components/settings/ComposerSendShortcutSection.tsx, apps/desktop/src/renderer/components/settings/ComputerPermissionGuideWindow.tsx, apps/desktop/src/renderer/components/settings/ComputerPermissionRow.tsx, apps/desktop/src/renderer/components/settings/ComputerUseSection.settings-search.ts, apps/desktop/src/renderer/components/settings/ComputerUseSection.tsx, apps/desktop/src/renderer/components/settings/CustomProviderRuntimeFillOverlay.tsx, apps/desktop/src/renderer/components/settings/DefaultOverrideControls.tsx, apps/desktop/src/renderer/components/settings/DialogueDirectorySection.tsx, apps/desktop/src/renderer/components/settings/DingTalkBotSection.tsx, apps/desktop/src/renderer/components/settings/DiscordBotSection.tsx, apps/desktop/src/renderer/components/settings/DownloadMeter.tsx, apps/desktop/src/renderer/components/settings/ExperimentalSection.tsx, apps/desktop/src/renderer/components/settings/FeishuBotNotificationSection.tsx, apps/desktop/src/renderer/components/settings/FeishuBotSection.tsx, apps/desktop/src/renderer/components/settings/FontFamilyPicker.tsx, apps/desktop/src/renderer/components/settings/GeneralSettings.settings-search.ts, apps/desktop/src/renderer/components/settings/GenericGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/GitSafetySection.settings-search.ts, apps/desktop/src/renderer/components/settings/GitSafetySection.tsx, apps/desktop/src/renderer/components/settings/HarnessVersionMenuRow.tsx, apps/desktop/src/renderer/components/settings/HelpAssistantPanel.tsx, apps/desktop/src/renderer/components/settings/HelpSection.settings-search.ts, apps/desktop/src/renderer/components/settings/HelpSection.tsx, apps/desktop/src/renderer/components/settings/HelpThreadView.tsx, apps/desktop/src/renderer/components/settings/HookConnectionsSection.tsx, apps/desktop/src/renderer/components/settings/HookWorkspacePrefsEditor.tsx, apps/desktop/src/renderer/components/settings/ImBotSection.settings-search.ts, apps/desktop/src/renderer/components/settings/ImBotSection.tsx, apps/desktop/src/renderer/components/settings/ImChannelSettingsCard.tsx, apps/desktop/src/renderer/components/settings/ImDefaultSettingsSection.tsx, apps/desktop/src/renderer/components/settings/ImLifecycleAnnouncementSection.tsx, apps/desktop/src/renderer/components/settings/InputDeviceConnectionStatus.tsx, apps/desktop/src/renderer/components/settings/JoyConGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/KeyboardShortcutsSection.settings-search.ts, apps/desktop/src/renderer/components/settings/KeyboardShortcutsSection.tsx, apps/desktop/src/renderer/components/settings/LanguageSection.tsx, apps/desktop/src/renderer/components/settings/LayoutResetControl.tsx, apps/desktop/src/renderer/components/settings/LinkOpenSection.tsx, apps/desktop/src/renderer/components/settings/LlamaCppCandidates.tsx, apps/desktop/src/renderer/components/settings/LlamaCppProviderDetail.tsx, apps/desktop/src/renderer/components/settings/LocalModelDownloadUI.tsx, apps/desktop/src/renderer/components/settings/LocalOllamaInstall.tsx, apps/desktop/src/renderer/components/settings/LocalPackagingTag.tsx, apps/desktop/src/renderer/components/settings/LogoutSection.tsx, apps/desktop/src/renderer/components/settings/LspBetaCell.tsx, apps/desktop/src/renderer/components/settings/McpServerDialog.tsx, apps/desktop/src/renderer/components/settings/McpServersSection.tsx, apps/desktop/src/renderer/components/settings/MemorySection.tsx, apps/desktop/src/renderer/components/settings/MessageNavRailCell.tsx, apps/desktop/src/renderer/components/settings/ModelAdvancedDrawer.tsx, apps/desktop/src/renderer/components/settings/ModelPriceOverrideDialog.tsx, apps/desktop/src/renderer/components/settings/MyDevicesPanel.tsx, apps/desktop/src/renderer/components/settings/NotificationSection.settings-search.ts, apps/desktop/src/renderer/components/settings/NotificationSection.tsx, apps/desktop/src/renderer/components/settings/OAuthDeviceCodeCard.tsx, apps/desktop/src/renderer/components/settings/OllamaProviderDetail.tsx, apps/desktop/src/renderer/components/settings/OwnRemoteProviders.tsx, apps/desktop/src/renderer/components/settings/PersonalizationDetails.settings-search.ts, apps/desktop/src/renderer/components/settings/PersonalizationSettings.settings-search.ts, apps/desktop/src/renderer/components/settings/PiKernelVersionRow.tsx, apps/desktop/src/renderer/components/settings/PiPackagesSection.tsx, apps/desktop/src/renderer/components/settings/PlayStationGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/ProfileEditDialog.tsx, apps/desktop/src/renderer/components/settings/ProviderConnectionDialog.tsx, apps/desktop/src/renderer/components/settings/ProviderImportDialog.tsx, apps/desktop/src/renderer/components/settings/ProvidersSection.settings-search.ts, apps/desktop/src/renderer/components/settings/ProvidersSection.tsx, apps/desktop/src/renderer/components/settings/ReadOnlyProviderModels.tsx, apps/desktop/src/renderer/components/settings/RemoteControlSection.settings-search.ts, apps/desktop/src/renderer/components/settings/RemoteControlSection.tsx, apps/desktop/src/renderer/components/settings/RemoteDesktopPermissions.tsx, apps/desktop/src/renderer/components/settings/RemoteDesktopSetting.tsx, apps/desktop/src/renderer/components/settings/RemoteHostDetail.tsx, apps/desktop/src/renderer/components/settings/RemoteSection.tsx, apps/desktop/src/renderer/components/settings/SessionImportSection.settings-search.ts, apps/desktop/src/renderer/components/settings/SessionImportSection.tsx, apps/desktop/src/renderer/components/settings/SessionRuntimeFallbackCell.tsx, apps/desktop/src/renderer/components/settings/SessionShareImportWizard.tsx, apps/desktop/src/renderer/components/settings/SettingsCatalogPanel.settings-search.ts, apps/desktop/src/renderer/components/settings/SettingsCatalogPanel.tsx, apps/desktop/src/renderer/components/settings/SettingsSearchBox.tsx, apps/desktop/src/renderer/components/settings/SettingsSearchNavigation.ts, apps/desktop/src/renderer/components/settings/SettingsSidebarNav.tsx, apps/desktop/src/renderer/components/settings/SettingsTextInput.tsx, apps/desktop/src/renderer/components/settings/SettingsView.tsx, apps/desktop/src/renderer/components/settings/SharedTasks.settings-search.ts, apps/desktop/src/renderer/components/settings/SilentEncryptedRetryCell.tsx, apps/desktop/src/renderer/components/settings/SshKeySetupDialog.tsx, apps/desktop/src/renderer/components/settings/StorageManagementCard.settings-search.ts, apps/desktop/src/renderer/components/settings/StorageManagementCard.tsx, apps/desktop/src/renderer/components/settings/StreamFadeSection.tsx, apps/desktop/src/renderer/components/settings/SubagentModelSection.settings-search.ts, apps/desktop/src/renderer/components/settings/SubagentModelSection.tsx, apps/desktop/src/renderer/components/settings/SwitchProGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/TelegramBehaviorSettings.tsx, apps/desktop/src/renderer/components/settings/TelegramBotSection.tsx, apps/desktop/src/renderer/components/settings/TelegramRemoteDevices.tsx, apps/desktop/src/renderer/components/settings/TerminalShellSection.tsx, apps/desktop/src/renderer/components/settings/TipsSection.settings-search.ts, apps/desktop/src/renderer/components/settings/TipsSection.tsx, apps/desktop/src/renderer/components/settings/UnifiedModelList.tsx, apps/desktop/src/renderer/components/settings/UserProfileCard.tsx, apps/desktop/src/renderer/components/settings/UserPromptSection.tsx, apps/desktop/src/renderer/components/settings/VisionBridgeSection.settings-search.ts, apps/desktop/src/renderer/components/settings/VisionBridgeSection.tsx, apps/desktop/src/renderer/components/settings/VoiceInputSection.settings-search.ts, apps/desktop/src/renderer/components/settings/VoiceInputSection.tsx, apps/desktop/src/renderer/components/settings/WallpaperSection.tsx, apps/desktop/src/renderer/components/settings/WechatBotSection.tsx, apps/desktop/src/renderer/components/settings/WecomBotSection.tsx, apps/desktop/src/renderer/components/settings/WindowBehaviorSection.settings-search.ts, apps/desktop/src/renderer/components/settings/WindowBehaviorSection.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexKeyboardLayout.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexKeycapGlyphs.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexSettings.tsx, apps/desktop/src/renderer/components/settings/WorktreeRecycleCard.settings-search.ts, apps/desktop/src/renderer/components/settings/WorktreeRecycleCard.tsx, apps/desktop/src/renderer/components/settings/XUsageGuide.tsx, apps/desktop/src/renderer/components/settings/XboxGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/XboxGamepadSettings.tsx, apps/desktop/src/renderer/components/settings/androidStatusPresentation.ts, apps/desktop/src/renderer/components/settings/billingVisibility.ts, apps/desktop/src/renderer/components/settings/browserOpenForLoginError.ts, apps/desktop/src/renderer/components/settings/cindyMakeVisibility.ts, apps/desktop/src/renderer/components/settings/computerPermissionFlow.ts, apps/desktop/src/renderer/components/settings/contacts/ContactDetailPane.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsImportDialog.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsListPane.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsManagerDialog.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsSection.tsx, apps/desktop/src/renderer/components/settings/contacts/startContactsAiSession.ts, apps/desktop/src/renderer/components/settings/dialogueDirectoryDisplay.ts, apps/desktop/src/renderer/components/settings/dualSenseSilhouette.ts, apps/desktop/src/renderer/components/settings/feishuBotPresentation.ts, apps/desktop/src/renderer/components/settings/fontFamilyValue.ts, apps/desktop/src/renderer/components/settings/gamepadLayoutPrimitives.tsx, apps/desktop/src/renderer/components/settings/gamepadSilhouetteGeom.ts, apps/desktop/src/renderer/components/settings/hookWorkspacePrefsLogic.ts, apps/desktop/src/renderer/components/settings/imBotVisibility.ts, apps/desktop/src/renderer/components/settings/imDefaultSettingsLogic.ts, apps/desktop/src/renderer/components/settings/joyConSilhouette.ts, apps/desktop/src/renderer/components/settings/modelManagementPresentation.ts, apps/desktop/src/renderer/components/settings/modelManagementState.ts, apps/desktop/src/renderer/components/settings/myDevicesModel.ts, apps/desktop/src/renderer/components/settings/providerAssetModule.ts, apps/desktop/src/renderer/components/settings/realProfilePermissionGuide.ts, apps/desktop/src/renderer/components/settings/settingsSearchCatalog.ts, apps/desktop/src/renderer/components/settings/settingsSearchTypes.ts, apps/desktop/src/renderer/components/settings/switchProSilhouette.ts, apps/desktop/src/renderer/components/settings/ultimateC1Silhouette.ts, apps/desktop/src/renderer/components/settings/usage/UsageBarsTooltip.tsx, apps/desktop/src/renderer/components/settings/usage/UsageBreakdownTables.tsx, apps/desktop/src/renderer/components/settings/usage/UsageDeviceSelect.tsx, apps/desktop/src/renderer/components/settings/usage/UsageHistorySection.settings-search.ts, apps/desktop/src/renderer/components/settings/usage/UsageHistorySection.tsx, apps/desktop/src/renderer/components/settings/usage/UsageStatRow.tsx, apps/desktop/src/renderer/components/settings/usage/UsageTaskTable.tsx, apps/desktop/src/renderer/components/settings/usage/UsageTokenBars.tsx, apps/desktop/src/renderer/components/settings/usage/formatUsagePercent.ts, apps/desktop/src/renderer/components/settings/usage/usageCharts.css, apps/desktop/src/renderer/components/settings/usage/usageHistoryColors.ts, apps/desktop/src/renderer/components/settings/usage/usageHistoryStats.ts, apps/desktop/src/renderer/components/settings/usageVisibility.ts, apps/desktop/src/renderer/components/settings/useProviderSubscriptionCard.ts, apps/desktop/src/renderer/components/settings/useSettingsEscape.ts, apps/desktop/src/renderer/components/settings/useSettingsSectionTarget.ts, apps/desktop/src/renderer/components/settings/wizardRecommend.ts, apps/desktop/src/renderer/components/settings/workLouderCodexCommandCopy.ts, apps/desktop/src/renderer/components/settings/xboxSeriesSilhouette.ts, apps/desktop/src/renderer/styles/sortable.css | 137 | 100 | 544 |
| `desktop.shell.main-layout` | desktop | 主窗口壳(标题栏 / 左右栏 / 内容区) | main BrowserWindow → renderer/index.tsx → main-entry.tsx → App → MainLayout (`#/` 受保护壳) | ChromeActions, DeviceSectionHeader, FeishuConflictDialogHost, GhostMediaLightboxHost, MainLayout, ProjectsSection, RightSidebar, RightSidebarShell, SessionShareImportWizard, Sidebar, UpdateNoticeDialog, WindowControls | apps/desktop/src/renderer/cindy-brain/GhostMediaLightboxHost.tsx, apps/desktop/src/renderer/components/UpdateNoticeDialog.tsx, apps/desktop/src/renderer/components/feishuBot/FeishuConflictDialog.tsx, apps/desktop/src/renderer/components/feishuBot/FeishuConflictDialogHost.tsx, apps/desktop/src/renderer/components/layout/AppBadgeAttentionSync.tsx, apps/desktop/src/renderer/components/layout/BrowserWebviewPool.tsx, apps/desktop/src/renderer/components/layout/ChromeActions.tsx, apps/desktop/src/renderer/components/layout/ContentHeader.tsx, apps/desktop/src/renderer/components/layout/CredentialStoreBanner.tsx, apps/desktop/src/renderer/components/layout/FadeSwitcher.tsx, apps/desktop/src/renderer/components/layout/GhostPanelWindowLayout.tsx, apps/desktop/src/renderer/components/layout/GlobalDropImportListener.tsx, apps/desktop/src/renderer/components/layout/MainEntryRedirect.tsx, apps/desktop/src/renderer/components/layout/MainLayout.tsx, apps/desktop/src/renderer/components/layout/RightSidebar.tsx, apps/desktop/src/renderer/components/layout/RightSidebarDetach.tsx, apps/desktop/src/renderer/components/layout/RightSidebarMaximize.tsx, apps/desktop/src/renderer/components/layout/RightSidebarToggle.tsx, apps/desktop/src/renderer/components/layout/SidebarWindowLayout.tsx, apps/desktop/src/renderer/components/layout/WallpaperVideo.tsx, apps/desktop/src/renderer/components/layout/chromeActionsGeometry.ts, apps/desktop/src/renderer/components/layout/chromeActionsLayout.ts, apps/desktop/src/renderer/components/layout/railChromeActions.ts, apps/desktop/src/renderer/components/layout/windowDrag.tsx, apps/desktop/src/renderer/components/settings/SessionShareImportWizard.tsx, apps/desktop/src/renderer/components/sidebar/AccountSwitcherDialog.tsx, apps/desktop/src/renderer/components/sidebar/AttentionDot.tsx, apps/desktop/src/renderer/components/sidebar/DatabaseSizeWarningBanner.tsx, apps/desktop/src/renderer/components/sidebar/GhostMainViewNavEntries.tsx, apps/desktop/src/renderer/components/sidebar/MobileDownloadDialog.tsx, apps/desktop/src/renderer/components/sidebar/NavigationCountBadge.tsx, apps/desktop/src/renderer/components/sidebar/Sidebar.tsx, apps/desktop/src/renderer/components/sidebar/SidebarIconButton.tsx, apps/desktop/src/renderer/components/sidebar/SidebarNavigationCustomize.tsx, apps/desktop/src/renderer/components/sidebar/SidebarTopNav.tsx, apps/desktop/src/renderer/components/sidebar/SortableList.tsx, apps/desktop/src/renderer/components/sidebar/UpdateBanner.tsx, apps/desktop/src/renderer/components/sidebar/UserInfoSection.tsx, apps/desktop/src/renderer/components/sidebar/VendorIcon.tsx, apps/desktop/src/renderer/components/sidebar/VendorReadinessBadge.tsx, apps/desktop/src/renderer/components/sidebar/WorktreeBadge.tsx, apps/desktop/src/renderer/components/sidebar/sidebarNavigationPrefs.ts, apps/desktop/src/renderer/components/title-bar/ChromeIconButton.tsx, apps/desktop/src/renderer/components/title-bar/MenuButton.tsx, apps/desktop/src/renderer/components/title-bar/WindowControls.tsx, apps/desktop/src/renderer/features/cc-agent/sidebar/DeviceSectionHeader.tsx, apps/desktop/src/renderer/features/cc-agent/sidebar/sections/ProjectsSection.tsx, apps/desktop/src/renderer/features/right-sidebar/AddTabDropdown.tsx, apps/desktop/src/renderer/features/right-sidebar/EmptyState.tsx, apps/desktop/src/renderer/features/right-sidebar/RightSidebarShell.tsx, apps/desktop/src/renderer/features/right-sidebar/TabBar.tsx, apps/desktop/src/renderer/features/right-sidebar/TabBodyErrorBoundary.tsx, apps/desktop/src/renderer/features/right-sidebar/hooks/useBrowserWebview.ts, apps/desktop/src/renderer/features/right-sidebar/hooks/useNativePopupSurface.ts, apps/desktop/src/renderer/features/right-sidebar/lib/browserPartition.ts, apps/desktop/src/renderer/features/right-sidebar/lib/browserWebviewPool.ts, apps/desktop/src/renderer/features/right-sidebar/lib/detachedSidebarRouting.ts, apps/desktop/src/renderer/features/right-sidebar/lib/executeSidebarCommand.ts, apps/desktop/src/renderer/features/right-sidebar/lib/lastTurnChangedFiles.ts, apps/desktop/src/renderer/features/right-sidebar/lib/nativePopupTabs.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openBackgroundTasksTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openBotWorkbenchTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openInSidebarBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openInSidebarFileBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openRoutinesTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openSubagentsTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openTerminalShortcut.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openTurnReview.ts, apps/desktop/src/renderer/features/right-sidebar/lib/popupRouter.ts, apps/desktop/src/renderer/features/right-sidebar/lib/popupTabs.ts, apps/desktop/src/renderer/features/right-sidebar/lib/rsbBrowserBridge.ts, apps/desktop/src/renderer/features/right-sidebar/lib/sidebarCommands.ts, apps/desktop/src/renderer/features/right-sidebar/lib/sidebarHostSession.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/BackgroundTasksBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/WorkflowAgentStrip.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/WorkflowProgressTree.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/chatTaskFocusIntent.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/listSessionTasks.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/workflowProgressModel.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/bot-workbench/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/cindy-make/CindyMakeTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/cindy-make/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/FileBrowserBody.css, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/FileBrowserBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/dropExternalFile.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/fileTreeImagePreview.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/useSessionScopedTreeWidth.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/index.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/OrcaWorkersAttentionIcon.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/OrcaWorkersTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/actions.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/closeDecision.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/ResourceUsageBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/resource-usage.css, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/subscription.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/retired-feature/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/ImageDiffPreview.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/MarkdownDiffPreview.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/PlainUnifiedDiff.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/diffRows.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/highlight.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/inlineDiff.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/useDiffHighlights.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/ReviewTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/diffExpansionPreference.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/fileTree.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/gitApplyCommand.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/markdownPreview.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useLastTurnFilter.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useReviewGitState.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useReviewSource.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/routines/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/ConversationStream.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/DetailView.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/RunList.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentChrome.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentToolCard.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentsBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentChangeFence.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentConversation.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentFormat.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/TerminalTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/lib/xtermPool.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserChrome.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserCommentPopover.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/browserCommentEditorDraft.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/lib/parseOmnibox.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/useBrowserComment.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/useLocalHtmlAutoReload.ts, apps/desktop/src/renderer/features/right-sidebar/registry.ts, apps/desktop/src/renderer/features/right-sidebar/store.ts, apps/desktop/src/renderer/features/right-sidebar/tabAvailability.ts, apps/desktop/src/renderer/features/right-sidebar/types.ts, apps/desktop/src/renderer/layout/LayoutRoot.tsx, apps/desktop/src/renderer/layout/PanelDragController.tsx, apps/desktop/src/renderer/layout/PanelDragPrototype.tsx, apps/desktop/src/renderer/layout/collapsePrefs.ts, apps/desktop/src/renderer/layout/layoutDevTools.ts, apps/desktop/src/renderer/layout/panePlacement.tsx, apps/desktop/src/renderer/layout/paneWidths.tsx, apps/desktop/src/renderer/layout/panelMaximize.tsx, apps/desktop/src/renderer/styles/generated/tokens.css, apps/desktop/src/renderer/styles/globals.css | 144 | 46 | 200 |
| `desktop.skillhub.local` | desktop | SkillHub 本地技能 | hash `/skillhub/local` 及统一详情 `/skillhub/detail`(旧详情链接重定向) | InstallTargetPicker, PluginManagementLayout, SkillDetailLayout, SkillhubDetailRoute, SkillhubDetailView, SkillhubFeatureLayout, SkillhubHomeView, SkillhubLocalLayout, SkillhubMarketDetailView | apps/desktop/src/renderer/features/plugin/PluginManagementLayout.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubDetailRoute.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubDetailView.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubFeatureLayout.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubHomeView.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubLocalLayout.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubMarketDetailView.tsx, apps/desktop/src/renderer/features/skillhub/components/InstallTargetPicker.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillDetailLayout.tsx | 35 | 0 | 43 |
| `desktop.skillhub.market` | desktop | SkillHub 市场 | hash `/skillhub/market`(SkillhubMarketListView) | InstallTargetPicker, MarketCard, MarketInfoEditDialog, SkillhubMarketDetailView, SkillhubMarketListView, VisibilityEditorDialog | apps/desktop/src/renderer/features/skillhub/SkillhubMarketDetailView.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubMarketListView.tsx, apps/desktop/src/renderer/features/skillhub/components/HomeMarketCard.tsx, apps/desktop/src/renderer/features/skillhub/components/InstallTargetPicker.tsx, apps/desktop/src/renderer/features/skillhub/components/LocalSkillControls.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketCard.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketInfoEditDialog.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketInstallStatus.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketListError.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketLocalSkills.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketPreviewTree.tsx, apps/desktop/src/renderer/features/skillhub/components/OfficialSkillBadge.tsx, apps/desktop/src/renderer/features/skillhub/components/PlatformTagSelector.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillCategoryFilterBar.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillDetailLayout.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillIcon.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillTagList.tsx, apps/desktop/src/renderer/features/skillhub/components/TeamScopePicker.tsx, apps/desktop/src/renderer/features/skillhub/components/VisibilityEditorDialog.tsx | 43 | 0 | 37 |