Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
feat(desktop): 设置页支持 Esc 逐层返回 (#5851)
Dashfb2e1049ba50
diff --git a/apps/desktop/src/renderer/components/settings/SettingsView.tsx b/apps/desktop/src/renderer/components/settings/SettingsView.tsxindex 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"><buttontype="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.tsxnew file mode 100644index 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.tsxnew file mode 100644index 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.tsnew file mode 100644index 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.tsxindex 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 }: PluginDetailTopBconst { 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 }: PluginDetailTopBevent.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.tsxindex 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.tsxindex 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.tsxindex 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.tsxindex 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.tsindex 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.mdindex 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.mdindex 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 |