Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
feat(desktop): add independent terminal font settings
xuzini-xzn45a6dd0d0b62
diff --git a/apps/desktop/src/main/__tests__/appearanceSettingsIpcSecurity.test.ts b/apps/desktop/src/main/__tests__/appearanceSettingsIpcSecurity.test.tsindex e77f10ca83..30a5f0b5cd 100644--- a/apps/desktop/src/main/__tests__/appearanceSettingsIpcSecurity.test.ts+++ b/apps/desktop/src/main/__tests__/appearanceSettingsIpcSecurity.test.ts@@ -67,6 +67,8 @@ const persisted = {codeFamily: 'JetBrains Mono',uiSize: 15,codeSize: 14,+ terminalFamily: 'Menlo',+ terminalSize: 17,windowZoom: 1.1,};@@ -211,6 +213,7 @@ describe('appearance settings IPC authorization', () => {mocks.assertTrustedAppRendererEvent.mockReset();mocks.readAppearanceSettings.mockReset().mockReturnValue(persisted);mocks.fromWebContents.mockReset().mockReturnValue({ isDestroyed: () => false });+ mocks.writeAppearanceSettingsPatch.mockReset().mockResolvedValue(persisted);});it('同步启动读取只向已授权的外观 reader 返回持久快照', () => {@@ -346,4 +349,34 @@ describe('appearance settings IPC authorization', () => {await expect(setHandler({}, { wallpaperId })).rejects.toThrow('wallpaperId is not supported');},);+ const getSetHandler = () => mocks.ipcHandle.mock.calls.find(+ ([channel]) => channel === 'appearance-settings:set-patch',+ )?.[1] as (event: unknown, patch: unknown) => Promise<unknown>;++ it('accepts only terminal font fields while preserving the existing write authorization', async () => {+ const event = {};+ await getSetHandler()(event, { terminalFamily: ' Menlo ', terminalSize: 30 });+ expect(mocks.assertTrustedAppRendererEvent).toHaveBeenCalledWith(event);+ expect(mocks.writeAppearanceSettingsPatch).toHaveBeenCalledExactlyOnceWith({+ terminalFamily: 'Menlo', terminalSize: 24,+ });+ });++ it.each([+ { terminalFamily: 1 }, { terminalFamily: 'x'.repeat(257) },+ { terminalSize: '13' }, { terminalSize: NaN }, { terminalSize: Infinity },+ { terminalTheme: 'dark' }, null, [],+ ])('rejects malformed or unapproved terminal appearance patch %j before writing', async (patch) => {+ await expect(getSetHandler()({}, patch)).rejects.toThrow('[INVALID_PARAMS]');+ expect(mocks.writeAppearanceSettingsPatch).not.toHaveBeenCalled();+ });++ it('does not grant read-only windows or untrusted senders terminal settings write access', async () => {+ mocks.assertTrustedAppRendererEvent.mockImplementation(() => {+ throw new Error('untrusted app renderer');+ });+ await expect(getSetHandler()({}, { terminalFamily: 'Menlo', terminalSize: 16 }))+ .rejects.toThrow('untrusted app renderer');+ expect(mocks.writeAppearanceSettingsPatch).not.toHaveBeenCalled();+ });});diff --git a/apps/desktop/src/main/__tests__/appearanceSettingsStore.test.ts b/apps/desktop/src/main/__tests__/appearanceSettingsStore.test.tsnew file mode 100644index 0000000000..8d32b6f68b--- /dev/null+++ b/apps/desktop/src/main/__tests__/appearanceSettingsStore.test.ts@@ -0,0 +1,62 @@+import fs from 'node:fs';+import os from 'node:os';+import path from 'node:path';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';++const fixture = vi.hoisted(() => ({ userData: '' }));+vi.mock('electron', () => ({ app: { getPath: () => fixture.userData } }));+vi.mock('../maker-host/logger-adapter.js', () => ({+ desktopMakerLogger: { child: () => ({ info: vi.fn(), warn: vi.fn() }) },+}));++import { DEFAULT_APPEARANCE_SETTINGS } from '../../shared/appearanceSettings';+import {+ readAppearanceSettingsState,+ writeAppearanceSettingsPatch,+} from '../appearance-settings-store';++describe('terminal appearance overrides', () => {+ beforeEach(() => {+ fixture.userData = fs.mkdtempSync(path.join(os.tmpdir(), 'cindy-terminal-appearance-'));+ });+ afterEach(() => fs.rmSync(fixture.userData, { recursive: true, force: true }));++ it('reads old overrides with unchanged values and adds terminal defaults only in memory', () => {+ const oldOverrides = { uiFamily: 'Inter', codeFamily: 'JetBrains Mono', uiSize: 16, codeSize: 18, windowZoom: 1.2 };+ const file = path.join(fixture.userData, 'appearance-settings.json');+ fs.writeFileSync(file, JSON.stringify(oldOverrides));+ const state = readAppearanceSettingsState();+ expect(state.value).toEqual({ ...DEFAULT_APPEARANCE_SETTINGS, ...oldOverrides });+ expect(state.customizedKeys).not.toContain('terminalFamily');+ expect(state.customizedKeys).not.toContain('terminalSize');+ expect(JSON.parse(fs.readFileSync(file, 'utf8'))).toEqual(oldOverrides);+ });++ it('persists only terminal overrides and clears each one without changing other preferences', async () => {+ const file = path.join(fixture.userData, 'appearance-settings.json');+ const otherOverrides = { uiFamily: 'Inter', codeFamily: 'JetBrains Mono', uiSize: 16, codeSize: 18, windowZoom: 1.2 };+ await writeAppearanceSettingsPatch(otherOverrides);+ await writeAppearanceSettingsPatch({ terminalFamily: ' Menlo ', terminalSize: 19 });+ expect(JSON.parse(fs.readFileSync(file, 'utf8'))).toEqual({+ ...otherOverrides, terminalFamily: 'Menlo', terminalSize: 19,+ });++ await writeAppearanceSettingsPatch({ terminalFamily: '' });+ expect(JSON.parse(fs.readFileSync(file, 'utf8'))).toEqual({ ...otherOverrides, terminalSize: 19 });+ expect(readAppearanceSettingsState().value.terminalFamily).toBe('');+ expect(readAppearanceSettingsState().customizedKeys).not.toContain('terminalFamily');++ await writeAppearanceSettingsPatch({ terminalSize: 13 });+ expect(JSON.parse(fs.readFileSync(file, 'utf8'))).toEqual(otherOverrides);+ expect(readAppearanceSettingsState().value).toEqual({ ...DEFAULT_APPEARANCE_SETTINGS, ...otherOverrides });+ });++ it('does not persist a defaults snapshot when restoring the only terminal override', async () => {+ const file = path.join(fixture.userData, 'appearance-settings.json');+ await writeAppearanceSettingsPatch({ terminalSize: 20 });+ expect(JSON.parse(fs.readFileSync(file, 'utf8'))).toEqual({ terminalSize: 20 });+ await writeAppearanceSettingsPatch({ terminalSize: 13 });+ expect(fs.existsSync(file)).toBe(false);+ expect(readAppearanceSettingsState().isCustomized).toBe(false);+ });+});diff --git a/apps/desktop/src/main/appearance-settings-ipc.ts b/apps/desktop/src/main/appearance-settings-ipc.tsindex ffe04625a2..7761428123 100644--- a/apps/desktop/src/main/appearance-settings-ipc.ts+++ b/apps/desktop/src/main/appearance-settings-ipc.ts@@ -9,6 +9,7 @@ import {clampAppearanceWallpaperVisibility,clampAppearanceWallpaperBlur,clampAppearanceCodeSize,+ clampAppearanceTerminalSize,clampAppearanceUiSize,clampAppearanceWindowZoom,type AppearanceOverrides,@@ -184,6 +185,8 @@ function parsePatch(rawPatch: unknown): AppearanceOverrides {'codeFamily','uiSize','codeSize',+ 'terminalFamily',+ 'terminalSize','windowZoom','wallpaperId','wallpaperOverlay',@@ -197,6 +200,8 @@ function parsePatch(rawPatch: unknown): AppearanceOverrides {const patch: AppearanceOverrides = {};if ('uiFamily' in raw) patch.uiFamily = parseFamily(raw.uiFamily, 'uiFamily');if ('codeFamily' in raw) patch.codeFamily = parseFamily(raw.codeFamily, 'codeFamily');+ if ('terminalFamily' in raw)+ patch.terminalFamily = parseFamily(raw.terminalFamily, 'terminalFamily');if ('uiSize' in raw)patch.uiSize = parseNumber(raw.uiSize,@@ -211,6 +216,13 @@ function parsePatch(rawPatch: unknown): AppearanceOverrides {clampAppearanceCodeSize,APPEARANCE_LIMITS.codeSize,);+ if ('terminalSize' in raw)+ patch.terminalSize = parseNumber(+ raw.terminalSize,+ 'terminalSize',+ clampAppearanceTerminalSize,+ APPEARANCE_LIMITS.terminalSize,+ );if ('windowZoom' in raw) {patch.windowZoom = parseNumber(raw.windowZoom,diff --git a/apps/desktop/src/preload/__tests__/appearanceSettingsSnapshot.test.ts b/apps/desktop/src/preload/__tests__/appearanceSettingsSnapshot.test.tsnew file mode 100644index 0000000000..91d62ae2af--- /dev/null+++ b/apps/desktop/src/preload/__tests__/appearanceSettingsSnapshot.test.ts@@ -0,0 +1,100 @@+import { beforeEach, describe, expect, it, vi } from 'vitest';+import { DEFAULT_APPEARANCE_SETTINGS, type AppearanceSettings } from '../../shared/appearanceSettings';++const mocks = vi.hoisted(() => ({+ listeners: new Map<string, Set<(...args: unknown[]) => void>>(),+ expose: vi.fn(),+ sendSync: vi.fn(),+ invoke: vi.fn(),+}));++vi.mock('electron', () => ({+ contextBridge: { exposeInMainWorld: mocks.expose },+ webUtils: { getPathForFile: vi.fn() },+ ipcRenderer: {+ sendSync: mocks.sendSync,+ invoke: mocks.invoke,+ send: vi.fn(),+ on: (channel: string, listener: (...args: unknown[]) => void) => {+ const listeners = mocks.listeners.get(channel) ?? new Set();+ listeners.add(listener);+ mocks.listeners.set(channel, listeners);+ },+ removeListener: (channel: string, listener: (...args: unknown[]) => void) => {+ mocks.listeners.get(channel)?.delete(listener);+ },+ },+}));++interface AppearanceBridge {+ getSync(): AppearanceSettings | null;+ onChanged: ((callback: (settings: AppearanceSettings) => void) => () => void) & {+ __reset?: () => void;+ };+}++describe.each(['main', 'sidebar'] as const)('%s preload appearance snapshot', (kind) => {+ beforeEach(() => {+ mocks.listeners.clear();+ mocks.expose.mockClear();+ mocks.invoke.mockReset();+ mocks.sendSync.mockReset().mockImplementation((channel) => {+ if (channel === 'appearance-settings:get-sync') return { ...DEFAULT_APPEARANCE_SETTINGS };+ if (channel === 'app-locale:get-preferred-system-locale-sync') return 'en';+ return {};+ });+ });++ it('keeps late mounts and remounts current, updates before consumers, and strips Electron events', async () => {+ if (kind === 'main') await import('../preload');+ else await import('../sidebarWindowPreload');+ const exposed = mocks.expose.mock.calls.find(([name]) => name === 'electronAPI')?.[1];+ const bridge = exposed.appearanceSettings as AppearanceBridge;+ const privilegedEvent = { sender: { send: vi.fn() } };+ const emit = (settings: AppearanceSettings) => {+ for (const listener of mocks.listeners.get('appearance-settings:changed') ?? []) {+ listener(privilegedEvent, settings);+ }+ };++ expect(bridge.getSync()).toEqual(DEFAULT_APPEARANCE_SETTINGS);+ const changed = { ...DEFAULT_APPEARANCE_SETTINGS, terminalFamily: 'Menlo', terminalSize: 18 };+ emit(changed); // No renderer subscription exists yet.+ expect(bridge.getSync()).toEqual(changed);++ const callback = vi.fn((settings: AppearanceSettings) => {+ expect(bridge.getSync()).toEqual(settings);+ });+ const unsubscribe = bridge.onChanged(callback);+ if (kind === 'sidebar') {+ expect(callback.mock.calls).toEqual([[changed]]);+ callback.mockClear();+ }+ const next = { ...changed, terminalSize: 21 };+ emit(next);+ expect(callback).toHaveBeenCalledOnce();+ expect(callback.mock.calls[0][0]).toEqual(next);+ expect(callback.mock.calls[0]).not.toContain(privilegedEvent);+ expect(mocks.invoke).not.toHaveBeenCalled();++ unsubscribe();+ bridge.onChanged.__reset?.(); // HMR may dispose every renderer listener.+ emit({ ...next, terminalSize: 13 });+ expect(callback).toHaveBeenCalledOnce();+ expect(bridge.getSync()?.terminalSize).toBe(13);+ expect(mocks.sendSync.mock.calls.filter(([channel]) => channel === 'appearance-settings:get-sync'))+ .toHaveLength(1);++ if (kind === 'sidebar') {+ expect(Object.keys(bridge).sort()).toEqual([+ 'ensureWallpaperImage', 'ensureWallpaperVideo', 'getSync', 'onChanged',+ 'onWallpaperDownloadProgress',+ ]);+ } else {+ expect(Object.keys(bridge).sort()).toEqual([+ 'ensureWallpaperImage', 'ensureWallpaperVideo', 'get', 'getSync', 'importWallpaper',+ 'onChanged', 'onWallpaperDownloadProgress', 'removeWallpaper', 'reset', 'setPatch',+ ]);+ }+ });+});diff --git a/apps/desktop/src/preload/preload.ts b/apps/desktop/src/preload/preload.tsindex 8410ab1f24..f397686814 100644--- a/apps/desktop/src/preload/preload.ts+++ b/apps/desktop/src/preload/preload.ts@@ -1072,9 +1072,14 @@ const clientEndpointsInfo = ipcRenderer.sendSync('client-endpoints:get-sync') aswebsiteUrl: string;};-const appearanceSettingsInfo = ipcRenderer.sendSync(+let appearanceSettingsInfo = ipcRenderer.sendSync('appearance-settings:get-sync',) as AppearanceSettings | null;+// Keep the bootstrap snapshot current even before a terminal mounts. Register+// before renderer subscriptions so getSync() sees the same update as onChanged.+ipcRenderer.on('appearance-settings:changed', (_event, settings: AppearanceSettings) => {+ appearanceSettingsInfo = settings;+});contextBridge.exposeInMainWorld('electronAPI', {localAgent: {diff --git a/apps/desktop/src/renderer/__tests__/terminalFontSettings.test.ts b/apps/desktop/src/renderer/__tests__/terminalFontSettings.test.tsnew file mode 100644index 0000000000..e6cea949f0--- /dev/null+++ b/apps/desktop/src/renderer/__tests__/terminalFontSettings.test.ts@@ -0,0 +1,149 @@+// @vitest-environment jsdom++import { act, cleanup, renderHook, waitFor } from '@testing-library/react';+import { createElement, type ReactNode } from 'react';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';+import { FontSettingsProvider, useFontSettings } from '@/hooks/useFontSettings';+import {+ DEFAULT_APPEARANCE_SETTINGS,+ type AppearanceSettings,+} from '../../shared/appearanceSettings';++const originalElectronAPI = window.electronAPI;+const wrapper = ({ children }: { children: ReactNode }) =>+ createElement(FontSettingsProvider, null, children);++function installBridge(initial: AppearanceSettings) {+ let snapshot = initial;+ let onChanged: ((next: AppearanceSettings) => void) | undefined;+ const setPatch = vi.fn(async (patch: Partial<AppearanceSettings>) => {+ snapshot = { ...snapshot, ...patch };+ onChanged?.(snapshot);+ });+ const logToMain = vi.fn();+ Object.defineProperty(window, 'electronAPI', {+ configurable: true,+ value: {+ appearanceSettings: {+ getSync: () => snapshot,+ setPatch,+ onChanged: (callback: typeof onChanged) => {+ onChanged = callback;+ return () => {+ onChanged = undefined;+ };+ },+ },+ logToMain,+ },+ });+ return {+ setPatch,+ logToMain,+ broadcast: (next: Partial<AppearanceSettings>) => {+ snapshot = { ...snapshot, ...next };+ onChanged?.(snapshot);+ },+ };+}++beforeEach(() => {+ document.documentElement.removeAttribute('style');+ document.body.removeAttribute('style');+});++afterEach(() => {+ cleanup();+ vi.restoreAllMocks();+ Object.defineProperty(window, 'electronAPI', {+ configurable: true,+ value: originalElectronAPI,+ });+});++describe('terminal font settings isolation', () => {+ it('patches and resets only terminal fields without rewriting UI or code CSS', async () => {+ const bridge = installBridge({+ ...DEFAULT_APPEARANCE_SETTINGS,+ uiFamily: 'Inter',+ uiSize: 16,+ codeFamily: 'Consolas',+ codeSize: 18,+ });+ const { result } = renderHook(() => useFontSettings(), { wrapper });+ const cssBefore = [document.documentElement.style.cssText, document.body.style.cssText];+ const setProperty = vi.spyOn(document.documentElement.style, 'setProperty');+ const removeProperty = vi.spyOn(document.documentElement.style, 'removeProperty');++ act(() => {+ result.current.setTerminalFamily(' Menlo ');+ result.current.setTerminalSize(20);+ });+ await waitFor(() => expect(bridge.setPatch).toHaveBeenCalledTimes(2));+ expect(bridge.setPatch.mock.calls).toEqual([+ [{ terminalFamily: 'Menlo' }],+ [{ terminalSize: 20 }],+ ]);+ expect(result.current.terminalFamily).toBe('Menlo');+ expect(result.current.terminalSize).toBe(20);+ expect(result.current.uiFamily).toBe('Inter');+ expect(result.current.uiSize).toBe(16);+ expect(result.current.codeFamily).toBe('Consolas');+ expect(result.current.codeSize).toBe(18);++ act(() => result.current.resetTerminalFamily());+ await waitFor(() => expect(bridge.setPatch).toHaveBeenCalledTimes(3));+ expect(bridge.setPatch).toHaveBeenLastCalledWith({ terminalFamily: '' });+ expect(result.current.terminalSize).toBe(20);+ act(() => result.current.resetTerminalSize());+ await waitFor(() => expect(bridge.setPatch).toHaveBeenCalledTimes(4));+ expect(bridge.setPatch).toHaveBeenLastCalledWith({ terminalSize: 13 });+ expect(result.current.terminalFamily).toBe('');+ expect(result.current.terminalSize).toBe(13);+ expect([document.documentElement.style.cssText, document.body.style.cssText]).toEqual(+ cssBefore,+ );+ expect(setProperty).not.toHaveBeenCalled();+ expect(removeProperty).not.toHaveBeenCalled();+ });++ it('receives terminal-only broadcasts without touching global font styles', () => {+ const bridge = installBridge({ ...DEFAULT_APPEARANCE_SETTINGS });+ const { result } = renderHook(() => useFontSettings(), { wrapper });+ const setProperty = vi.spyOn(document.documentElement.style, 'setProperty');+ act(() => bridge.broadcast({ terminalFamily: 'Monaco', terminalSize: 17 }));+ expect(result.current.terminalFamily).toBe('Monaco');+ expect(result.current.terminalSize).toBe(17);+ expect(setProperty).not.toHaveBeenCalled();+ });++ it('keeps newer pending values over broadcasts and restores confirmed terminal state on failure', async () => {+ const bridge = installBridge({ ...DEFAULT_APPEARANCE_SETTINGS });+ let rejectWrite!: (error: Error) => void;+ bridge.setPatch.mockImplementationOnce(+ () =>+ new Promise<void>((_resolve, reject) => {+ rejectWrite = reject;+ }),+ );+ const { result } = renderHook(() => useFontSettings(), { wrapper });+ act(() => {+ result.current.setTerminalFamily('Menlo');+ result.current.setTerminalSize(18);+ });+ await waitFor(() => expect(bridge.setPatch).toHaveBeenCalledTimes(1));++ act(() => bridge.broadcast({ terminalFamily: 'Monaco', codeSize: 19 }));+ expect(result.current.terminalFamily).toBe('Menlo');+ expect(result.current.terminalSize).toBe(18);+ expect(result.current.codeSize).toBe(19);++ await act(async () => rejectWrite(new Error('write failed')));+ await waitFor(() => expect(bridge.setPatch).toHaveBeenCalledTimes(2));+ expect(result.current.terminalFamily).toBe('Monaco');+ expect(result.current.terminalSize).toBe(18);+ expect(result.current.codeSize).toBe(19);+ expect(bridge.setPatch).toHaveBeenLastCalledWith({ terminalSize: 18 });+ expect(bridge.logToMain).toHaveBeenCalledTimes(1);+ });+});diff --git a/apps/desktop/src/renderer/components/settings/AppearanceSection.settings-search.ts b/apps/desktop/src/renderer/components/settings/AppearanceSection.settings-search.tsindex 63654db9b4..b5eee1508f 100644--- a/apps/desktop/src/renderer/components/settings/AppearanceSection.settings-search.ts+++ b/apps/desktop/src/renderer/components/settings/AppearanceSection.settings-search.ts@@ -18,6 +18,8 @@ export default {{ id: 'settings.appearance.font.uiSize.label', fallbackTargetId: 'settings-search-target-appearance-fonts', tab: 'appearance', targetId: 'settings-search-settings-appearance-font-uiSize-label', titleKey: 'settings.appearance.font.uiSize.label', sectionKey: 'settings.appearance.font.title', descriptionKey: 'settings.appearance.font.uiSize.description' },{ id: 'settings.appearance.font.codeFamily.label', fallbackTargetId: 'settings-search-target-appearance-fonts', tab: 'appearance', targetId: 'settings-search-settings-appearance-font-codeFamily-label', titleKey: 'settings.appearance.font.codeFamily.label', sectionKey: 'settings.appearance.font.title', descriptionKey: 'settings.appearance.font.codeFamily.description' },{ id: 'settings.appearance.font.codeSize.label', fallbackTargetId: 'settings-search-target-appearance-fonts', tab: 'appearance', targetId: 'settings-search-settings-appearance-font-codeSize-label', titleKey: 'settings.appearance.font.codeSize.label', sectionKey: 'settings.appearance.font.title', descriptionKey: 'settings.appearance.font.codeSize.description' },+ { id: 'settings.appearance.font.terminalFamily.label', fallbackTargetId: 'settings-search-target-appearance-fonts', tab: 'appearance', targetId: 'settings-search-settings-appearance-font-terminalFamily-label', titleKey: 'settings.appearance.font.terminalFamily.label', sectionKey: 'settings.appearance.font.title', descriptionKey: 'settings.appearance.font.terminalFamily.description' },+ { id: 'settings.appearance.font.terminalSize.label', fallbackTargetId: 'settings-search-target-appearance-fonts', tab: 'appearance', targetId: 'settings-search-settings-appearance-font-terminalSize-label', titleKey: 'settings.appearance.font.terminalSize.label', sectionKey: 'settings.appearance.font.title', descriptionKey: 'settings.appearance.font.terminalSize.description' },{ id: 'settings.appearance.sidebarCardMode.label', fallbackTargetId: 'settings-search-target-appearance-sidebar', tab: 'appearance', targetId: 'settings-search-settings-appearance-sidebarCardMode-label', titleKey: 'settings.appearance.sidebarCardMode.label', sectionKey: 'settings.appearance.sidebarAndPanels', descriptionKey: 'settings.appearance.sidebarCardMode.hint' },{ id: 'settings.appearance.sidebarMainListMode.label', fallbackTargetId: 'settings-search-target-appearance-sidebar', tab: 'appearance', targetId: 'settings-search-settings-appearance-sidebarMainListMode-label', titleKey: 'settings.appearance.sidebarMainListMode.label', sectionKey: 'settings.appearance.sidebarAndPanels', descriptionKey: 'settings.appearance.sidebarMainListMode.hint' },{ id: 'appearance.streamFade', tab: 'appearance', targetId: 'settings-search-target-appearance-stream-fade', titleKey: 'settings.sections.streamFade', sectionKey: 'settings.sections.streamFade', aliases: ['personalization.streamFade', 'settings-search-target-personalization-stream-fade'] },diff --git a/apps/desktop/src/renderer/components/settings/AppearanceSection.tsx b/apps/desktop/src/renderer/components/settings/AppearanceSection.tsxindex d2ea4b8083..9e35f0e289 100644--- a/apps/desktop/src/renderer/components/settings/AppearanceSection.tsx+++ b/apps/desktop/src/renderer/components/settings/AppearanceSection.tsx@@ -21,6 +21,7 @@ import {clampFontSize,clampUiFontSize,DEFAULT_CODE_FONT_SIZE,+ DEFAULT_TERMINAL_FONT_SIZE,DEFAULT_UI_FONT_SIZE,useFontSettings,} from '@/hooks/useFontSettings';@@ -46,6 +47,11 @@ import {SETTINGS_SECTION_TITLE_CLASS,} from './settingsRowClasses';import { WallpaperSection } from './WallpaperSection';+import {+ APPEARANCE_LIMITS,+ clampAppearanceTerminalSize,+ DEFAULT_TERMINAL_FONT_FAMILY,+} from '../../../shared/appearanceSettings';const log = createLogger('settings/AppearanceSection');@@ -95,6 +101,19 @@ const CODE_FONT_PRESETS: FontPreset[] = [},];+const TERMINAL_FONT_PRESETS: FontPreset[] = [+ {+ id: 'default',+ labelKey: 'settings.appearance.font.presetsTerminal.default',+ family: '',+ },+ {+ id: 'jetbrainsMono',+ labelKey: 'settings.appearance.font.presetsCode.jetbrainsMono',+ family: '"JetBrains Mono Variable", "JetBrains Mono"',+ },+];+const CODE_FONT_PREVIEW_SAMPLE ='// preview 0O 1lI\n' +'const greet = (name: string, n = 3): string =>\n' +@@ -403,14 +422,20 @@ export function AppearanceSection() {codeFamily,uiSize,codeSize,+ terminalFamily,+ terminalSize,setUiFamily,setCodeFamily,setUiSize,setCodeSize,+ setTerminalFamily,+ setTerminalSize,resetUiFamily,resetCodeFamily,resetUiSize,resetCodeSize,+ resetTerminalFamily,+ resetTerminalSize,} = useFontSettings();const { mode: sidebarViewMode, setMode: setSidebarViewMode } = useSidebarCardMode();const { mode: sidebarMainViewMode, setMode: setSidebarMainViewMode } = useSidebarMainViewMode();@@ -418,6 +443,7 @@ export function AppearanceSection() {const [localThemesVersion, setLocalThemesVersion] = useState(0);const [uiSizeInput, setUiSizeInput] = useState(String(uiSize));const [codeSizeInput, setCodeSizeInput] = useState(String(codeSize));+ const [terminalSizeInput, setTerminalSizeInput] = useState(String(terminalSize));const families = useMemo(() => getThemeFamilies(), [localThemesVersion]);const selectedFamily = families.find((f) => f.id === familyId) ?? families[0];@@ -433,6 +459,10 @@ export function AppearanceSection() {setCodeSizeInput(String(codeSize));}, [codeSize]);+ useEffect(() => {+ setTerminalSizeInput(String(terminalSize));+ }, [terminalSize]);+useEffect(() =>onLocalThemesChange(() => {@@ -562,6 +592,18 @@ export function AppearanceSection() {setCodeSizeInput(String(codeSize));}, [codeSize, codeSizeInput, setCodeSize]);+ const commitTerminalSizeInput = useCallback(() => {+ const trimmed = terminalSizeInput.trim();+ const next = Number(terminalSizeInput);+ if (trimmed !== '' && Number.isFinite(next)) {+ const normalized = clampAppearanceTerminalSize(next);+ setTerminalSize(normalized);+ setTerminalSizeInput(String(normalized));+ return;+ }+ setTerminalSizeInput(String(terminalSize));+ }, [terminalSize, terminalSizeInput, setTerminalSize]);+const commitUiSizeInput = useCallback(() => {const trimmed = uiSizeInput.trim();const next = Number(uiSizeInput);@@ -901,6 +943,91 @@ export function AppearanceSection() {/></div></div>++ <div className={SETTINGS_ROW_DIVIDER_CLASS} />++ <div+ id="settings-search-settings-appearance-font-terminalFamily-label"+ className="px-4 py-4"+ >+ <FontFamilyPicker+ label={t('settings.appearance.font.terminalFamily.label')}+ description={t('settings.appearance.font.terminalFamily.description')}+ ariaLabel={t('settings.appearance.font.terminalFamily.aria')}+ value={terminalFamily}+ presets={TERMINAL_FONT_PRESETS}+ previewSample={t('settings.appearance.font.previewSamples.terminal')}+ previewFallbackFamily={DEFAULT_TERMINAL_FONT_FAMILY}+ onChange={setTerminalFamily}+ onReset={resetTerminalFamily}+ />+ </div>++ <div className={SETTINGS_ROW_DIVIDER_CLASS} />++ <div className="flex flex-col gap-3 px-4 py-4">+ <div className="flex items-start justify-between gap-3">+ <div className="min-w-0">+ <p+ id="settings-search-settings-appearance-font-terminalSize-label"+ className="text-13 font-medium text-[var(--settings-section-sublabel)]"+ style={{ letterSpacing: '0.12px' }}+ >+ {t('settings.appearance.font.terminalSize.label')}+ </p>+ <p className="mt-1 text-12 leading-[1.4] text-[var(--text-secondary)]">+ {t('settings.appearance.font.terminalSize.description')}+ </p>+ </div>+ <Tip text={t('settings.appearance.font.reset')}>+ <Button+ variant="secondary"+ className="w-8 px-0"+ type="button"+ aria-label={t('settings.appearance.font.reset')}+ onClick={resetTerminalSize}+ disabled={terminalSize === DEFAULT_TERMINAL_FONT_SIZE}+ >+ <RotateCcw size={14} />+ </Button>+ </Tip>+ </div>++ <div className="flex items-center gap-3">+ <Slider+ min={APPEARANCE_LIMITS.terminalSize.min}+ max={APPEARANCE_LIMITS.terminalSize.max}+ step={1}+ value={[terminalSize]}+ onValueChange={([next]) => {+ if (typeof next === 'number') setTerminalSize(next);+ }}+ aria-label={t('settings.appearance.font.terminalSize.aria')}+ />+ <input+ type="number"+ aria-label={t('settings.appearance.font.terminalSize.label')}+ min={APPEARANCE_LIMITS.terminalSize.min}+ max={APPEARANCE_LIMITS.terminalSize.max}+ step={1}+ value={terminalSizeInput}+ onChange={(e) => setTerminalSizeInput(e.target.value)}+ onBlur={commitTerminalSizeInput}+ onKeyDown={(e) => {+ if (e.key === 'Enter') {+ commitTerminalSizeInput();+ e.currentTarget.blur();+ }+ }}+ className={cn(+ 'h-9 w-[72px] rounded-xl border px-3 text-right text-13 outline-none',+ 'border-[var(--settings-input-border)] bg-[var(--settings-input-bg)]',+ 'font-mono text-[var(--settings-input-text)]',+ 'focus:border-[var(--settings-input-border-focus)]',+ )}+ />+ </div>+ </div></div></section>diff --git a/apps/desktop/src/renderer/components/settings/__tests__/AppearanceSection.accessibility.test.tsx b/apps/desktop/src/renderer/components/settings/__tests__/AppearanceSection.accessibility.test.tsxindex d31f7661a6..a5540afd8b 100644--- a/apps/desktop/src/renderer/components/settings/__tests__/AppearanceSection.accessibility.test.tsx+++ b/apps/desktop/src/renderer/components/settings/__tests__/AppearanceSection.accessibility.test.tsx@@ -29,14 +29,20 @@ vi.mock('@/hooks/useFontSettings', async (importOriginal) => ({codeFamily: '',uiSize: 14,codeSize: 14,+ terminalFamily: '',+ terminalSize: 13,setUiFamily: vi.fn(),setCodeFamily: vi.fn(),setUiSize: vi.fn(),setCodeSize: vi.fn(),+ setTerminalFamily: vi.fn(),+ setTerminalSize: vi.fn(),resetUiFamily: vi.fn(),resetCodeFamily: vi.fn(),resetUiSize: vi.fn(),resetCodeSize: vi.fn(),+ resetTerminalFamily: vi.fn(),+ resetTerminalSize: vi.fn(),}),}));@@ -97,7 +103,7 @@ vi.mock('../FontFamilyPicker', () => ({ FontFamilyPicker: () => null }));vi.mock('../LayoutResetControl', () => ({ LayoutResetControl: () => null }));describe('AppearanceSection accessibility', () => {- it('labels the UI and code font-size number inputs', () => {+ it('labels the UI, code and terminal font-size number inputs', () => {render(<AppearanceSection />);const visibility = screen.getByRole('slider', {name: 'settings.appearance.wallpaper.visibilityLabel',@@ -142,6 +148,9 @@ describe('AppearanceSection accessibility', () => {expect(screen.getByRole('spinbutton', { name: 'settings.appearance.font.codeSize.label' }),).toBeTruthy();+ expect(+ screen.getByRole('spinbutton', { name: 'settings.appearance.font.terminalSize.label' }),+ ).toBeTruthy();});it('locks the appearance mode to the only variant of a single-variant theme', () => {diff --git a/apps/desktop/src/renderer/components/settings/__tests__/AppearanceSection.terminalFonts.test.tsx b/apps/desktop/src/renderer/components/settings/__tests__/AppearanceSection.terminalFonts.test.tsxnew file mode 100644index 0000000000..084376bd0b--- /dev/null+++ b/apps/desktop/src/renderer/components/settings/__tests__/AppearanceSection.terminalFonts.test.tsx@@ -0,0 +1,185 @@+// @vitest-environment jsdom++import { cleanup, fireEvent, render, screen, within } from '@testing-library/react';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';+import { FontSettingsProvider } from '@/hooks/useFontSettings';+import { AppearanceSection } from '../AppearanceSection';+import zhCN from '@/i18n/locales/zh-CN/common.json';+import appearanceSearch from '../AppearanceSection.settings-search';++vi.mock('react-i18next', () => ({+ useTranslation: () => ({+ t: (key: string) => {+ const value = key+ .split('.')+ .reduce<unknown>(+ (current, part) =>+ current && typeof current === 'object'+ ? (current as Record<string, unknown>)[part]+ : undefined,+ zhCN,+ );+ return typeof value === 'string' ? value : key;+ },+ }),+}));++vi.mock('@/hooks/useTheme', () => ({+ resolveIsDark: () => false,+ useTheme: () => ({+ theme: 'system',+ setTheme: vi.fn(),+ familyId: 'cindy',+ setFamily: vi.fn(),+ fallbackFromType: null,+ }),+}));++vi.mock('@/hooks/useWallpaperSettings', () => ({+ useWallpaperSettings: () => ({+ wallpaperId: 'none',+ wallpaperOverlay: 0.2,+ wallpaperMotion: 'static',+ visibility: 0.37,+ setWallpaper: vi.fn(),+ setVisibility: vi.fn(),+ setBlur: vi.fn(),+ previewBlur: vi.fn(),+ setMotion: vi.fn(),+ resetWallpaper: vi.fn(),+ }),+}));++vi.mock('@/hooks/useSidebarCardMode', () => ({+ useSidebarCardMode: () => ({ mode: 'text', setMode: vi.fn() }),+ useSidebarMainViewMode: () => ({ mode: 'list', setMode: vi.fn() }),+}));++vi.mock('@/themes/local-themes', () => ({+ buildCopyFromTheme: vi.fn(),+ getLocalThemes: () => [],+ onLocalThemesChange: () => () => {},+ refreshLocalThemes: vi.fn(async () => {}),+}));++vi.mock('../LayoutResetControl', () => ({ LayoutResetControl: () => null }));++beforeEach(() => {+ vi.stubGlobal(+ 'ResizeObserver',+ class {+ observe() {}+ unobserve() {}+ disconnect() {}+ },+ );+});++afterEach(() => {+ cleanup();+ vi.unstubAllGlobals();+});++function renderSettings() {+ render(+ <FontSettingsProvider>+ <AppearanceSection />+ </FontSettingsProvider>,+ );+}++describe('AppearanceSection terminal fonts', () => {+ it('registers search targets for the terminal font and size rows', () => {+ renderSettings();+ for (const key of ['terminalFamily', 'terminalSize']) {+ const entry = appearanceSearch.entries.find(+ (item) => item.id === `settings.appearance.font.${key}.label`,+ );+ expect(entry).toBeDefined();+ expect(document.getElementById(entry!.targetId)?.textContent).toContain(+ key === 'terminalFamily' ? '终端字体' : '终端字号',+ );+ }+ });++ it('reuses custom font entry and keeps terminal and code font selections independent', () => {+ renderSettings();+ const terminalPicker = screen.getByRole('button', { name: '选择终端字体' });+ const codePicker = screen.getByRole('button', { name: '选择代码字体' });++ fireEvent.click(terminalPicker);+ fireEvent.change(screen.getByPlaceholderText(zhCN.settings.appearance.font.customPlaceholder), {+ target: { value: 'Menlo' },+ });+ fireEvent.click(+ screen.getByRole('button', { name: zhCN.settings.appearance.font.applyCustom }),+ );++ expect(terminalPicker.textContent).toBe('Menlo');+ expect(codePicker.textContent).toBe('Codex 风格(默认)');+ expect(+ screen.queryByPlaceholderText(zhCN.settings.appearance.font.customPlaceholder),+ ).toBeNull();++ fireEvent.click(codePicker);+ fireEvent.change(screen.getByPlaceholderText(zhCN.settings.appearance.font.customPlaceholder), {+ target: { value: 'Consolas' },+ });+ fireEvent.click(+ screen.getByRole('button', { name: zhCN.settings.appearance.font.applyCustom }),+ );+ expect(codePicker.textContent).toBe('Consolas');+ expect(terminalPicker.textContent).toBe('Menlo');++ fireEvent.click(+ within(terminalPicker.parentElement!).getByRole('button', { name: '恢复默认' }),+ );+ expect(terminalPicker.textContent).toBe('等宽字体(默认)');+ expect(codePicker.textContent).toBe('Consolas');+ });++ it('applies the existing JetBrains Mono preset only to the terminal', () => {+ renderSettings();+ const terminalPicker = screen.getByRole('button', { name: '选择终端字体' });+ fireEvent.click(terminalPicker);+ fireEvent.click(screen.getByRole('option', { name: 'JetBrains Mono' }));++ expect(terminalPicker.textContent).toBe('JetBrains Mono');+ expect(screen.getByRole('button', { name: '选择代码字体' }).textContent).toBe(+ 'Codex 风格(默认)',+ );+ expect(document.documentElement.style.getPropertyValue('--app-font-code')).toBe('');+ });++ it('bounds terminal size input, supports slider keys and resets only the terminal size', () => {+ renderSettings();+ const size = screen.getByRole('spinbutton', { name: '终端字号' }) as HTMLInputElement;+ const slider = screen.getByRole('slider', { name: '调整终端字号' });+ expect(size.value).toBe('13');++ fireEvent.change(size, { target: { value: '30' } });+ fireEvent.blur(size);+ expect(size.value).toBe('24');++ fireEvent.change(size, { target: { value: '' } });+ fireEvent.blur(size);+ expect(size.value).toBe('24');++ fireEvent.change(size, { target: { value: '9' } });+ fireEvent.keyDown(size, { key: 'Enter' });+ expect(size.value).toBe('10');+ fireEvent.keyDown(slider, { key: 'ArrowRight' });+ expect(size.value).toBe('11');++ fireEvent.click(+ within(size.parentElement!.parentElement!).getByRole('button', { name: '恢复默认' }),+ );+ expect(size.value).toBe('13');+ expect((screen.getByRole('spinbutton', { name: '代码字号' }) as HTMLInputElement).value).toBe(+ '14',+ );+ expect((screen.getByRole('spinbutton', { name: '界面字号' }) as HTMLInputElement).value).toBe(+ '14',+ );+ });+});diff --git a/apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/TerminalTabBody.tsx b/apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/TerminalTabBody.tsxindex a706006334..2ca600fb10 100644--- a/apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/TerminalTabBody.tsx+++ b/apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/TerminalTabBody.tsx@@ -25,6 +25,8 @@ import { useTranslation } from 'react-i18next';import { Spinner } from '@/components/ui/spinner';import type { TabKindHostContext } from '../../types';import { getOrCreateXterm, type XtermEntry } from './lib/xtermPool';+import { createTerminalFontController } from './lib/terminalFont';+import { useTerminalFontSettings } from './lib/useTerminalFontSettings';import type {TerminalDataEvent,TerminalExitEvent,@@ -74,9 +76,13 @@ function RemoteTerminalUnavailable() {function LocalTerminalTabBody({ state, ctx, active, shellVisible = true }: Props) {const { tabId, workdir, patchState } = ctx;const { t } = useTranslation();+ const { terminalFamily, terminalSize } = useTerminalFontSettings();const slotRef = useRef<HTMLDivElement>(null);const entryRef = useRef<XtermEntry | null>(null);+ const fontControllerRef = useRef<ReturnType<typeof createTerminalFontController> | null>(null);+ const activeRef = useRef(active);+ activeRef.current = active;/** xterm onData 的 disposer,unmount 时解订阅避免内存泄漏。 */const onDataDisposerRef = useRef<{ dispose(): void } | null>(null);/** 标记本组件实例是否还活着,异步 callback 里检查。 */@@ -126,12 +132,19 @@ function LocalTerminalTabBody({ state, ctx, active, shellVisible = true }: PropspatchState({ exited: ex.exit });});- // 折叠侧栏时 FitAddon 会把 0 宽折成极窄尺寸;不要把它写进- // lastSize 或下发给 PTY,恢复可见后由 active effect 再同步。- if (shellVisibleRef.current) fitNow(entry);+ fontControllerRef.current = createTerminalFontController(+ entry.terminal,+ () => activeRef.current !== false && shellVisibleRef.current && hasSize(slot),+ () => fitAndPushSize(entry, tabId, slot),+ );++ // 折叠侧栏或隐藏页签时保留最后可用尺寸,恢复可见后再测量。+ if (activeRef.current !== false && shellVisibleRef.current) fitNow(entry, slot);return () => {aliveRef.current = false;+ fontControllerRef.current?.dispose();+ fontControllerRef.current = null;onDataDisposerRef.current?.dispose();onDataDisposerRef.current = null;offData();@@ -140,6 +153,11 @@ function LocalTerminalTabBody({ state, ctx, active, shellVisible = true }: Props};}, [tabId, patchState]);+ // Font changes are independent from the DOM/PTY lifecycle and never focus the terminal.+ useEffect(() => {+ fontControllerRef.current?.update({ terminalFamily, terminalSize });+ }, [terminalFamily, terminalSize, tabId, patchState]);+// ─── 2. PTY 创建 / 跨窗口 re-attach ───// 两种进入条件:// a) state.created === false:首次创建 PTY@@ -168,6 +186,13 @@ function LocalTerminalTabBody({ state, ctx, active, shellVisible = true }: Props.then((result) => {if (cancelled || !aliveRef.current) return;entry.ptyAttached = true;+ // A font can finish loading while create is in flight. Ensure the PTY+ // receives the final dimensions even if the earlier resize arrived too soon.+ if (entry.lastSize.cols !== cols || entry.lastSize.rows !== rows) {+ void window.electronAPI.terminal+ .resize(tabId, entry.lastSize.cols, entry.lastSize.rows)+ .catch(() => undefined);+ }// re-attach 路径不重复 patchState —— 持久化字段没变,写一遍只是无谓 IPC。if (!isReattach) {patchState({@@ -194,8 +219,8 @@ function LocalTerminalTabBody({ state, ctx, active, shellVisible = true }: Propsif (!slot) return;const ro = new ResizeObserver(() => {const entry = entryRef.current;- if (!entry || !aliveRef.current || !shellVisibleRef.current) return;- fitAndPushSize(entry, tabId);+ if (!entry || !aliveRef.current || !shellVisibleRef.current || activeRef.current === false || !hasSize(slot)) return;+ if (!fontControllerRef.current?.flush()) fitAndPushSize(entry, tabId, slot);});ro.observe(slot);return () => ro.disconnect();@@ -207,11 +232,13 @@ function LocalTerminalTabBody({ state, ctx, active, shellVisible = true }: Propsconst entry = entryRef.current;if (!entry) return;// 切到本 tab 时 fit 一下,因为后台 tab 的 layout 可能没跟上侧栏宽度变化- requestAnimationFrame(() => {- if (!aliveRef.current || !entryRef.current || !shellVisibleRef.current) return;- fitAndPushSize(entryRef.current, tabId);- entryRef.current.terminal.focus();+ const frame = requestAnimationFrame(() => {+ const slot = slotRef.current;+ if (!aliveRef.current || entryRef.current !== entry || !shellVisibleRef.current || activeRef.current === false || !slot || !hasSize(slot)) return;+ if (!fontControllerRef.current?.flush()) fitAndPushSize(entry, tabId, slot);+ entry.terminal.focus();});+ return () => cancelAnimationFrame(frame);}, [active, shellVisible, tabId]);// ─── 5. Restart 按钮 handler ───@@ -263,7 +290,12 @@ function LocalTerminalTabBody({ state, ctx, active, shellVisible = true }: Props// ───────── helpers ─────────-function fitNow(entry: XtermEntry): void {+function hasSize(slot: HTMLElement): boolean {+ return slot.clientWidth > 0 && slot.clientHeight > 0;+}++function fitNow(entry: XtermEntry, slot: HTMLElement): void {+ if (!hasSize(slot)) return;try {entry.fitAddon.fit();entry.lastSize = { cols: entry.terminal.cols, rows: entry.terminal.rows };@@ -272,7 +304,8 @@ function fitNow(entry: XtermEntry): void {}}-function fitAndPushSize(entry: XtermEntry, tabId: string): void {+function fitAndPushSize(entry: XtermEntry, tabId: string, slot: HTMLElement): void {+ if (!hasSize(slot)) return;try {entry.fitAddon.fit();} catch {@@ -283,6 +316,8 @@ function fitAndPushSize(entry: XtermEntry, tabId: string): void {if (!Number.isFinite(cols) || !Number.isFinite(rows) || cols < 1 || rows < 1) return;if (cols === entry.lastSize.cols && rows === entry.lastSize.rows) return;entry.lastSize = { cols, rows };+ // create/reattach will reconcile these dimensions once it has an owner.+ if (!entry.ptyAttached) return;void window.electronAPI.terminal.resize(tabId, cols, rows).catch(() => {/* 已 disposed 的 session 静默忽略 */});diff --git a/apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/__tests__/TerminalFontBehavior.test.tsx b/apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/__tests__/TerminalFontBehavior.test.tsxnew file mode 100644index 0000000000..763d273f89--- /dev/null+++ b/apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/__tests__/TerminalFontBehavior.test.tsx@@ -0,0 +1,568 @@+// @vitest-environment jsdom++import { act, cleanup, render } from '@testing-library/react';+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';++import { DEFAULT_APPEARANCE_SETTINGS, type AppearanceSettings } from '../../../../../../shared/appearanceSettings';+import type { TabKindHostContext } from '../../../types';+import type { TerminalState } from '../index';+import type { XtermEntry } from '../lib/xtermPool';++const poolMocks = vi.hoisted(() => ({ getOrCreateXterm: vi.fn() }));+vi.mock('../lib/xtermPool', () => poolMocks);+vi.mock('react-i18next', () => ({+ useTranslation: () => ({ t: (key: string) => key }),+}));++import { TerminalTabBody } from '../TerminalTabBody';++// Keep the pre-feature defaults literal: deriving these expectations from the+// production constant would fail to catch an accidental change to old terminals.+const ORIGINAL_FAMILY = '"SF Mono", Menlo, Monaco, "Cascadia Code", "Courier New", monospace';+const originalFontsDescriptor = Object.getOwnPropertyDescriptor(document, 'fonts');++type Snapshot = AppearanceSettings & { terminalFamily: string; terminalSize: number };+type Listener = (value: unknown) => void;++function defaultSnapshot(): Snapshot {+ return {+ ...DEFAULT_APPEARANCE_SETTINGS,+ uiFamily: '', codeFamily: '', uiSize: 14, codeSize: 14, windowZoom: 1,+ terminalFamily: '', terminalSize: 13,+ };+}++function deferred<T>() {+ let resolve!: (value: T) => void;+ let reject!: (reason: unknown) => void;+ const promise = new Promise<T>((res, rej) => { resolve = res; reject = rej; });+ return { promise, resolve, reject };+}++let width: number;+let height: number;+let frameId: number;+let frames: Map<number, FrameRequestCallback>;+let resizeCallbacks: Set<ResizeObserverCallback>;+let snapshot: Snapshot;+let appearanceListeners: Set<Listener>;+let dataListeners: Set<Listener>;+let exitListeners: Set<Listener>;+let loadFonts: ReturnType<typeof vi.fn>;+let api: ReturnType<typeof installBridge>;+let entries: Map<string, ReturnType<typeof makeEntry>>;++function installBridge() {+ const terminal = {+ create: vi.fn(async () => ({ shellId: 'zsh', shellDisplayName: 'zsh' })),+ restart: vi.fn(async () => ({ shellId: 'zsh', shellDisplayName: 'zsh' })),+ dispose: vi.fn(async () => undefined),+ resize: vi.fn(async () => undefined),+ write: vi.fn(async () => undefined),+ onData: vi.fn((listener: Listener) => {+ dataListeners.add(listener);+ return () => dataListeners.delete(listener);+ }),+ onExit: vi.fn((listener: Listener) => {+ exitListeners.add(listener);+ return () => exitListeners.delete(listener);+ }),+ };+ // A detached renderer exposes only this read surface. No FontSettingsProvider+ // or settings write methods are installed in this harness.+ const appearanceSettings = {+ getSync: vi.fn(() => ({ ...snapshot })),+ onChanged: vi.fn((listener: Listener) => {+ appearanceListeners.add(listener);+ return () => appearanceListeners.delete(listener);+ }),+ };+ const bridge = { terminal, appearanceSettings };+ Object.defineProperty(window, 'electronAPI', { configurable: true, value: bridge });+ return bridge;+}++function makeEntry() {+ const inputListeners = new Set<(value: string) => void>();+ const fitSamples: Array<{ fontFamily: string; fontSize: number }> = [];+ const output: string[] = [];+ const terminal = {+ element: undefined as HTMLElement | undefined,+ options: {+ fontFamily: ORIGINAL_FAMILY,+ fontSize: 13,+ lineHeight: 1.2,+ scrollback: 5000,+ cursorBlink: true,+ cursorStyle: 'block',+ theme: { background: '#1c1c1c', foreground: '#e6e6e6' },+ },+ cols: 80,+ rows: 24,+ open: vi.fn((slot: HTMLElement) => {+ terminal.element = document.createElement('div');+ slot.appendChild(terminal.element);+ }),+ onData: vi.fn((listener: (value: string) => void) => {+ inputListeners.add(listener);+ return { dispose: () => inputListeners.delete(listener) };+ }),+ write: vi.fn((value: string) => output.push(value)),+ focus: vi.fn(),+ dispose: vi.fn(),+ reset: vi.fn(),+ clear: vi.fn(),+ refresh: vi.fn(),+ };+ const fitAddon = {+ fit: vi.fn(() => {+ fitSamples.push({ fontFamily: terminal.options.fontFamily, fontSize: terminal.options.fontSize });+ // Deliberately responsive to the public font option. This checks that the+ // PTY receives the size *after* the new font was applied, not stale cols.+ terminal.cols = Math.max(1, Math.floor(width / (terminal.options.fontSize * 0.6)));+ terminal.rows = Math.max(1, Math.floor(height / (terminal.options.fontSize * 1.2)));+ }),+ };+ return {+ terminal, fitAddon, fitSamples, inputListeners, output,+ lastSize: { cols: 80, rows: 24 },+ ptyAttached: true,+ };+}++function context(tabId = 'terminal-a'): TabKindHostContext {+ return {+ tabId, sessionId: 'session-a', workdir: '', remoteHostId: null, deviceLinkDeviceId: null,+ patchState: vi.fn(), onVisibilityChange: vi.fn(),+ setCloseInterceptor: () => () => undefined,+ };+}++const runningState: TerminalState = {+ created: true, exited: null, title: '', shellId: 'zsh', shellDisplayName: 'zsh',+};++async function flushWork() {+ await act(async () => {+ // Drain finite promise / animation-frame work without timers or real I/O.+ for (let step = 0; step < 8; step += 1) {+ await Promise.resolve();+ const pending = [...frames.values()];+ frames.clear();+ for (const callback of pending) callback(step * 16);+ }+ });+}++async function broadcast(patch: Partial<Snapshot>) {+ snapshot = { ...snapshot, ...patch };+ await act(async () => {+ for (const listener of appearanceListeners) listener({ ...snapshot });+ });+ await flushWork();+}++async function notifyResize() {+ await act(async () => {+ for (const callback of resizeCallbacks) callback([], {} as ResizeObserver);+ });+ await flushWork();+}++beforeEach(() => {+ vi.clearAllMocks();+ width = 800;+ height = 480;+ frameId = 0;+ frames = new Map();+ resizeCallbacks = new Set();+ snapshot = defaultSnapshot();+ appearanceListeners = new Set();+ dataListeners = new Set();+ exitListeners = new Set();+ entries = new Map();+ loadFonts = vi.fn(async () => []);+ Object.defineProperty(document, 'fonts', {+ configurable: true, value: { load: loadFonts },+ });+ vi.stubGlobal('requestAnimationFrame', (callback: FrameRequestCallback) => {+ const id = ++frameId;+ frames.set(id, callback);+ return id;+ });+ vi.stubGlobal('cancelAnimationFrame', (id: number) => frames.delete(id));+ vi.stubGlobal('ResizeObserver', class {+ constructor(private callback: ResizeObserverCallback) {}+ observe() { resizeCallbacks.add(this.callback); }+ disconnect() { resizeCallbacks.delete(this.callback); }+ });+ vi.spyOn(HTMLElement.prototype, 'getBoundingClientRect').mockImplementation(+ () => new DOMRect(0, 0, width, height),+ );+ vi.spyOn(HTMLElement.prototype, 'clientWidth', 'get').mockImplementation(() => width);+ vi.spyOn(HTMLElement.prototype, 'clientHeight', 'get').mockImplementation(() => height);+ vi.spyOn(HTMLElement.prototype, 'offsetWidth', 'get').mockImplementation(() => width);+ vi.spyOn(HTMLElement.prototype, 'offsetHeight', 'get').mockImplementation(() => height);+ poolMocks.getOrCreateXterm.mockImplementation((tabId: string) => {+ let entry = entries.get(tabId);+ if (!entry) {+ entry = makeEntry();+ entries.set(tabId, entry);+ }+ return entry as unknown as XtermEntry;+ });+ api = installBridge();+});++afterEach(() => {+ cleanup();+ vi.restoreAllMocks();+ vi.unstubAllGlobals();+ if (originalFontsDescriptor) Object.defineProperty(document, 'fonts', originalFontsDescriptor);+ else Reflect.deleteProperty(document, 'fonts');+ Reflect.deleteProperty(window, 'electronAPI');+});++describe('TerminalTabBody terminal font preferences', () => {+ it('keeps the existing defaults and starts the PTY once without a settings provider', async () => {+ const ctx = context();+ render(<TerminalTabBody state={{ ...runningState, created: false }} ctx={ctx} active />);+ await flushWork();++ const entry = entries.get(ctx.tabId)!;+ expect(entry.terminal.options.fontFamily).toBe(ORIGINAL_FAMILY);+ expect(entry.terminal.options.fontSize).toBe(13);+ expect(api.appearanceSettings.getSync).toHaveBeenCalled();+ expect(appearanceListeners.size).toBe(1);+ expect(api.terminal.create).toHaveBeenCalledOnce();+ expect(ctx.patchState).toHaveBeenCalledWith(expect.objectContaining({ created: true }));+ });++ it('applies saved settings and later broadcasts to the same terminal without changing its session or focus', async () => {+ snapshot = { ...snapshot, terminalFamily: 'Menlo', terminalSize: 16 };+ const ctx = context();+ render(<TerminalTabBody state={runningState} ctx={ctx} active />);+ await flushWork();+ const entry = entries.get(ctx.tabId)!;+ const theme = entry.terminal.options.theme;+ expect(entry.terminal.options.fontFamily).toContain('Menlo');+ expect(entry.terminal.options.fontSize).toBe(16);+ expect(entry.terminal.open).toHaveBeenCalledOnce();++ act(() => {+ for (const listener of dataListeners) listener({ id: ctx.tabId, chunk: 'existing output\r\n' });+ });+ entry.terminal.focus.mockClear();+ api.terminal.resize.mockClear();+ await broadcast({ terminalFamily: 'JetBrains Mono', terminalSize: 20 });++ expect(entry.terminal.options.fontFamily).toContain('JetBrains Mono');+ expect(entry.terminal.options.fontSize).toBe(20);+ expect(entry.fitSamples.at(-1)).toMatchObject({ fontSize: 20 });+ expect(api.terminal.resize).toHaveBeenLastCalledWith(ctx.tabId, 66, 20);+ expect(entry.terminal.focus).not.toHaveBeenCalled();+ expect(entry.terminal.open).toHaveBeenCalledOnce();+ expect(poolMocks.getOrCreateXterm).toHaveBeenCalledOnce();+ expect(api.terminal.create).not.toHaveBeenCalled();+ expect(api.terminal.restart).not.toHaveBeenCalled();+ expect(api.terminal.dispose).not.toHaveBeenCalled();+ expect(entry.terminal.dispose).not.toHaveBeenCalled();+ expect(entry.terminal.reset).not.toHaveBeenCalled();+ expect(entry.terminal.clear).not.toHaveBeenCalled();+ expect(entry.output).toEqual(['existing output\r\n']);+ expect(entry.terminal.options).toMatchObject({ lineHeight: 1.2, scrollback: 5000, cursorBlink: true, cursorStyle: 'block' });+ expect(entry.terminal.options.theme).toBe(theme);+ expect(ctx.patchState).not.toHaveBeenCalled();++ act(() => {+ for (const listener of entry.inputListeners) listener('pwd\r');+ for (const listener of dataListeners) listener({ id: ctx.tabId, chunk: 'next output\r\n' });+ });+ expect(api.terminal.write).toHaveBeenCalledWith(ctx.tabId, 'pwd\r');+ expect(entry.output).toEqual(['existing output\r\n', 'next output\r\n']);+ });++ it('ignores UI and code font changes and restores only the terminal defaults', async () => {+ const ctx = context();+ render(<TerminalTabBody state={runningState} ctx={ctx} active />);+ await flushWork();+ await broadcast({ terminalFamily: 'Menlo', terminalSize: 18 });+ const entry = entries.get(ctx.tabId)!;+ const family = entry.terminal.options.fontFamily;+ loadFonts.mockClear();+ entry.fitAddon.fit.mockClear();+ api.terminal.resize.mockClear();++ await broadcast({ uiFamily: 'Inter', codeFamily: 'Courier New', uiSize: 22, codeSize: 24, windowZoom: 1.2 });+ expect(entry.terminal.options.fontFamily).toBe(family);+ expect(entry.terminal.options.fontSize).toBe(18);+ expect(loadFonts).not.toHaveBeenCalled();+ expect(entry.fitAddon.fit).not.toHaveBeenCalled();+ expect(api.terminal.resize).not.toHaveBeenCalled();++ await broadcast({ terminalFamily: '', terminalSize: 13 });+ expect(entry.terminal.options.fontFamily).toBe(ORIGINAL_FAMILY);+ expect(entry.terminal.options.fontSize).toBe(13);+ expect(snapshot).toMatchObject({ uiFamily: 'Inter', codeFamily: 'Courier New', uiSize: 22, codeSize: 24 });+ });++ it('defers a saved font while the shell is collapsed and applies it on expansion', async () => {+ snapshot = { ...snapshot, terminalFamily: 'Menlo', terminalSize: 20 };+ const ctx = context();+ const view = render(<TerminalTabBody state={runningState} ctx={ctx} active shellVisible={false} />);+ await flushWork();+ const entry = entries.get(ctx.tabId)!;+ const originalSize = { ...entry.lastSize };+ await notifyResize();++ // Collapsed sidebars can keep nonzero layout dimensions during transitions.+ expect(entry.terminal.options.fontSize).toBe(13);+ expect(entry.fitAddon.fit).not.toHaveBeenCalled();+ expect(entry.lastSize).toEqual(originalSize);+ expect(api.terminal.resize).not.toHaveBeenCalled();+ expect(entry.terminal.focus).not.toHaveBeenCalled();++ view.rerender(<TerminalTabBody state={runningState} ctx={ctx} active shellVisible />);+ await flushWork();+ expect(entry.terminal.options.fontFamily).toContain('Menlo');+ expect(entry.terminal.options.fontSize).toBe(20);+ expect(api.terminal.resize).toHaveBeenLastCalledWith(ctx.tabId, 66, 20);+ expect(api.terminal.create).not.toHaveBeenCalled();+ });++ it('holds a font that finishes loading after collapse until the shell becomes visible', async () => {+ const ctx = context();+ const view = render(<TerminalTabBody state={runningState} ctx={ctx} active shellVisible />);+ await flushWork();+ const entry = entries.get(ctx.tabId)!;+ const pending = deferred<FontFace[]>();+ loadFonts.mockReturnValueOnce(pending.promise);+ await broadcast({ terminalFamily: 'Slow Mono', terminalSize: 22 });+ view.rerender(<TerminalTabBody state={runningState} ctx={ctx} active shellVisible={false} />);+ entry.fitAddon.fit.mockClear();+ entry.terminal.focus.mockClear();+ api.terminal.resize.mockClear();+ const originalSize = { ...entry.lastSize };++ pending.resolve([]);+ await flushWork();+ await notifyResize();+ expect(entry.terminal.options.fontSize).toBe(13);+ expect(entry.fitAddon.fit).not.toHaveBeenCalled();+ expect(entry.lastSize).toEqual(originalSize);+ expect(api.terminal.resize).not.toHaveBeenCalled();+ expect(entry.terminal.focus).not.toHaveBeenCalled();++ view.rerender(<TerminalTabBody state={runningState} ctx={ctx} active shellVisible />);+ await flushWork();+ expect(entry.terminal.options.fontFamily).toContain('Slow Mono');+ expect(entry.terminal.options.fontSize).toBe(22);+ expect(api.terminal.resize).toHaveBeenLastCalledWith(ctx.tabId, 60, 18);+ expect(api.terminal.create).not.toHaveBeenCalled();+ expect(api.terminal.restart).not.toHaveBeenCalled();+ });++ it('defers hidden-tab measurements and uses the latest font when activated', async () => {+ const ctx = context();+ const view = render(<TerminalTabBody state={runningState} ctx={ctx} active />);+ await flushWork();+ view.rerender(<TerminalTabBody state={runningState} ctx={ctx} active={false} />);+ await flushWork();+ const entry = entries.get(ctx.tabId)!;+ entry.fitAddon.fit.mockClear();+ entry.terminal.focus.mockClear();+ api.terminal.resize.mockClear();++ await broadcast({ terminalFamily: 'Menlo', terminalSize: 16 });+ await broadcast({ terminalFamily: 'Courier New', terminalSize: 24 });+ await notifyResize();+ expect(entry.fitAddon.fit).not.toHaveBeenCalled();+ expect(api.terminal.resize).not.toHaveBeenCalled();+ expect(entry.terminal.focus).not.toHaveBeenCalled();++ view.rerender(<TerminalTabBody state={runningState} ctx={ctx} active />);+ await flushWork();+ expect(entry.terminal.options.fontFamily).toContain('Courier New');+ expect(entry.terminal.options.fontSize).toBe(24);+ expect(entry.fitSamples.at(-1)).toMatchObject({ fontSize: 24 });+ expect(api.terminal.resize).toHaveBeenLastCalledWith(ctx.tabId, 55, 16);+ });++ it('does not resize a zero-sized panel and applies its pending font once space returns', async () => {+ const ctx = context();+ render(<TerminalTabBody state={runningState} ctx={ctx} active />);+ await flushWork();+ const entry = entries.get(ctx.tabId)!;+ width = 0;+ height = 0;+ entry.fitAddon.fit.mockClear();+ api.terminal.resize.mockClear();+ await broadcast({ terminalFamily: 'Menlo', terminalSize: 20 });+ await notifyResize();+ expect(entry.fitAddon.fit).not.toHaveBeenCalled();+ expect(api.terminal.resize).not.toHaveBeenCalled();++ width = 800;+ height = 480;+ await notifyResize();+ expect(entry.terminal.options.fontSize).toBe(20);+ expect(entry.fitSamples.at(-1)).toMatchObject({ fontSize: 20 });+ expect(api.terminal.resize).toHaveBeenLastCalledWith(ctx.tabId, 66, 20);+ });++ it('reads changes made while unmounted and reuses the pooled terminal and subscriptions', async () => {+ const ctx = context();+ const view = render(<TerminalTabBody state={runningState} ctx={ctx} active />);+ await flushWork();+ const entry = entries.get(ctx.tabId)!;+ view.unmount();+ expect(appearanceListeners.size).toBe(0);+ expect(dataListeners.size).toBe(0);+ expect(exitListeners.size).toBe(0);+ expect(entry.inputListeners.size).toBe(0);+ expect(entry.terminal.dispose).not.toHaveBeenCalled();++ snapshot = { ...snapshot, terminalFamily: 'Courier New', terminalSize: 19 };+ render(<TerminalTabBody state={runningState} ctx={ctx} active />);+ await flushWork();+ expect(entries.get(ctx.tabId)).toBe(entry);+ expect(entry.terminal.open).toHaveBeenCalledOnce();+ expect(entry.terminal.options.fontFamily).toContain('Courier New');+ expect(entry.terminal.options.fontSize).toBe(19);+ expect(appearanceListeners.size).toBe(1);+ expect(dataListeners.size).toBe(1);+ expect(entry.inputListeners.size).toBe(1);+ expect(api.terminal.create).not.toHaveBeenCalled();+ expect(api.terminal.restart).not.toHaveBeenCalled();+ });++ it('does not let an older font load override a newer selection', async () => {+ const ctx = context();+ render(<TerminalTabBody state={runningState} ctx={ctx} active />);+ await flushWork();+ const older = deferred<FontFace[]>();+ const newer = deferred<FontFace[]>();+ loadFonts.mockImplementation((font: string) => font.includes('Older Mono') ? older.promise : newer.promise);++ await broadcast({ terminalFamily: 'Older Mono', terminalSize: 16 });+ await broadcast({ terminalFamily: 'Newer Mono', terminalSize: 21 });+ newer.resolve([]); // [] is valid for locally installed system fonts.+ await flushWork();+ const entry = entries.get(ctx.tabId)!;+ expect(entry.terminal.options.fontFamily).toContain('Newer Mono');+ expect(entry.terminal.options.fontSize).toBe(21);+ const fitCount = entry.fitAddon.fit.mock.calls.length;+ older.resolve([]);+ await flushWork();+ expect(entry.terminal.options.fontFamily).toContain('Newer Mono');+ expect(entry.terminal.options.fontSize).toBe(21);+ expect(entry.fitAddon.fit).toHaveBeenCalledTimes(fitCount);+ });++ it('sends the final font dimensions once a pending PTY creation has completed', async () => {+ const ctx = context();+ const entry = makeEntry();+ entry.ptyAttached = false;+ entries.set(ctx.tabId, entry);+ const create = deferred<{ shellId: string; shellDisplayName: string }>();+ api.terminal.create.mockReturnValueOnce(create.promise);+ snapshot = { ...snapshot, terminalFamily: 'Menlo', terminalSize: 20 };++ render(<TerminalTabBody state={{ ...runningState, created: false }} ctx={ctx} active />);+ await flushWork();+ expect(api.terminal.create).toHaveBeenCalledOnce();+ expect(api.terminal.create).toHaveBeenCalledWith(expect.objectContaining({ cols: 102, rows: 30 }));+ expect(entry.terminal.options.fontSize).toBe(20);+ expect(api.terminal.resize).not.toHaveBeenCalled();++ create.resolve({ shellId: 'zsh', shellDisplayName: 'zsh' });+ await flushWork();+ expect(api.terminal.resize).toHaveBeenCalledOnce();+ expect(api.terminal.resize).toHaveBeenCalledWith(ctx.tabId, 66, 20);+ expect(api.terminal.restart).not.toHaveBeenCalled();+ });++ it('updates both subscribed terminals while deferring measurements for the hidden one', async () => {+ const firstCtx = context('terminal-a');+ const secondCtx = context('terminal-b');+ const view = render(<>+ <TerminalTabBody state={runningState} ctx={firstCtx} active />+ <TerminalTabBody state={runningState} ctx={secondCtx} active={false} />+ </>);+ await flushWork();+ expect(appearanceListeners.size).toBe(2);+ const first = entries.get(firstCtx.tabId)!;+ const second = entries.get(secondCtx.tabId)!;+ second.fitAddon.fit.mockClear();+ api.terminal.resize.mockClear();++ await broadcast({ terminalFamily: 'Courier New', terminalSize: 20 });+ expect(first.terminal.options.fontSize).toBe(20);+ expect(second.fitAddon.fit).not.toHaveBeenCalled();+ expect(api.terminal.resize).toHaveBeenCalledWith(firstCtx.tabId, 66, 20);+ expect(api.terminal.resize).not.toHaveBeenCalledWith(secondCtx.tabId, expect.anything(), expect.anything());++ view.rerender(<>+ <TerminalTabBody state={runningState} ctx={firstCtx} active={false} />+ <TerminalTabBody state={runningState} ctx={secondCtx} active />+ </>);+ await flushWork();+ expect(second.terminal.options.fontFamily).toContain('Courier New');+ expect(second.terminal.options.fontSize).toBe(20);+ expect(api.terminal.resize).toHaveBeenLastCalledWith(secondCtx.tabId, 66, 20);+ expect(first.terminal.open).toHaveBeenCalledOnce();+ expect(second.terminal.open).toHaveBeenCalledOnce();+ expect(api.terminal.create).not.toHaveBeenCalled();+ });++ it('still applies local fonts when the browser does not expose the Font Loading API', async () => {+ Object.defineProperty(document, 'fonts', { configurable: true, value: undefined });+ snapshot = { ...snapshot, terminalFamily: 'Menlo', terminalSize: 17 };+ const ctx = context();+ render(<TerminalTabBody state={runningState} ctx={ctx} active />);+ await flushWork();+ const entry = entries.get(ctx.tabId)!;+ expect(entry.terminal.options.fontFamily).toContain('Menlo');+ expect(entry.terminal.options.fontFamily).toContain(ORIGINAL_FAMILY);+ expect(entry.terminal.options.fontSize).toBe(17);+ expect(loadFonts).not.toHaveBeenCalled();+ });++ it('falls back after font loading fails and can apply a later working font', async () => {+ const ctx = context();+ render(<TerminalTabBody state={runningState} ctx={ctx} active />);+ await flushWork();+ loadFonts.mockRejectedValueOnce(new Error('Font unavailable'));+ await broadcast({ terminalFamily: 'Unavailable Mono', terminalSize: 17 });+ const entry = entries.get(ctx.tabId)!;+ expect(entry.terminal.options.fontFamily).toBe(ORIGINAL_FAMILY);+ expect(entry.terminal.options.fontSize).toBe(17);+ expect(api.terminal.restart).not.toHaveBeenCalled();++ await broadcast({ terminalFamily: 'Menlo', terminalSize: 18 });+ expect(entry.terminal.options.fontFamily).toContain('Menlo');+ expect(entry.terminal.options.fontSize).toBe(18);+ });++ it('does not touch a closed terminal when its outstanding font load resolves', async () => {+ const ctx = context();+ const view = render(<TerminalTabBody state={runningState} ctx={ctx} active />);+ await flushWork();+ const pending = deferred<FontFace[]>();+ loadFonts.mockReturnValueOnce(pending.promise);+ await broadcast({ terminalFamily: 'Slow Mono', terminalSize: 22 });+ const entry = entries.get(ctx.tabId)!;+ view.unmount();+ entry.terminal.dispose(); // The plugin disposes the pooled instance on close.+ const optionsBeforeClose = { ...entry.terminal.options };+ entry.fitAddon.fit.mockClear();+ api.terminal.resize.mockClear();+ entry.terminal.focus.mockClear();+ pending.resolve([]);+ await flushWork();+ expect(entry.terminal.options).toEqual(optionsBeforeClose);+ expect(entry.fitAddon.fit).not.toHaveBeenCalled();+ expect(api.terminal.resize).not.toHaveBeenCalled();+ expect(entry.terminal.focus).not.toHaveBeenCalled();+ });+});diff --git a/apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/__tests__/TerminalTabBody.test.tsx b/apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/__tests__/TerminalTabBody.test.tsxindex 6467f06b4f..2e7162c6fd 100644--- a/apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/__tests__/TerminalTabBody.test.tsx+++ b/apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/__tests__/TerminalTabBody.test.tsx@@ -8,6 +8,10 @@ const fit = vi.fn();const resize = vi.fn(async () => undefined);const entry = {terminal: {+ options: {+ fontFamily: '"SF Mono", Menlo, Monaco, "Cascadia Code", "Courier New", monospace',+ fontSize: 13,+ },cols: 80,rows: 24,element: undefined,@@ -64,6 +68,8 @@ beforeEach(() => {entry.terminal.rows = 24;entry.lastSize = { cols: 80, rows: 24 };TestResizeObserver.callback = null;+ vi.spyOn(HTMLElement.prototype, 'clientWidth', 'get').mockReturnValue(800);+ vi.spyOn(HTMLElement.prototype, 'clientHeight', 'get').mockReturnValue(480);vi.stubGlobal('ResizeObserver', TestResizeObserver);vi.stubGlobal('requestAnimationFrame', (callback: FrameRequestCallback) => {callback(0);@@ -86,6 +92,7 @@ beforeEach(() => {afterEach(() => {cleanup();+ vi.restoreAllMocks();vi.unstubAllGlobals();});diff --git a/apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/lib/terminalFont.ts b/apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/lib/terminalFont.tsnew file mode 100644index 0000000000..7d9a113374--- /dev/null+++ b/apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/lib/terminalFont.ts@@ -0,0 +1,77 @@+import type { Terminal } from '@xterm/xterm';++import { DEFAULT_TERMINAL_FONT_FAMILY } from '@/../shared/appearanceSettings';+import type { TerminalFontSettings } from './useTerminalFontSettings';++/** Applies font options only when loaded and measurable, without owning the PTY or focus. */+export function createTerminalFontController(+ terminal: Terminal,+ canMeasure: () => boolean,+ onApplied: () => void,+) {+ let generation = 0;+ let disposed = false;+ let frame: number | null = null;+ let pending: { family: string; size: number } | null = null;++ const cancelFrame = () => {+ if (frame !== null) cancelAnimationFrame(frame);+ frame = null;+ };++ const flush = (): boolean => {+ if (disposed || !pending || !canMeasure()) return false;+ const next = pending;+ pending = null;+ if (terminal.options.fontFamily === next.family && terminal.options.fontSize === next.size) {+ return false;+ }+ // xterm measures character cells when these options change. Assigning a+ // webfont before loading it, then only fitting, would retain fallback metrics.+ terminal.options.fontFamily = next.family;+ terminal.options.fontSize = next.size;+ onApplied();+ return true;+ };++ return {+ update({ terminalFamily, terminalSize }: TerminalFontSettings) {+ const request = ++generation;+ pending = null;+ cancelFrame();+ if (disposed) return;+ const family = terminalFamily+ ? `${terminalFamily}, ${DEFAULT_TERMINAL_FONT_FAMILY}`+ : DEFAULT_TERMINAL_FONT_FAMILY;+ if (terminal.options.fontFamily === family && terminal.options.fontSize === terminalSize) {+ return;+ }+ const ready = (loadedFamily: string) => {+ if (disposed || request !== generation) return;+ pending = { family: loadedFamily, size: terminalSize };+ frame = requestAnimationFrame(() => {+ frame = null;+ flush();+ });+ };+ // System fonts can resolve to an empty FontFace list; that is still success.+ try {+ if (!document.fonts?.load) {+ ready(family);+ } else {+ void document.fonts.load(`${terminalSize}px ${family}`, 'W0 ')+ .then(() => ready(family), () => ready(DEFAULT_TERMINAL_FONT_FAMILY));+ }+ } catch {+ ready(DEFAULT_TERMINAL_FONT_FAMILY);+ }+ },+ flush,+ dispose() {+ disposed = true;+ generation += 1;+ pending = null;+ cancelFrame();+ },+ };+}diff --git a/apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/lib/useTerminalFontSettings.ts b/apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/lib/useTerminalFontSettings.tsnew file mode 100644index 0000000000..bf372b6d6b--- /dev/null+++ b/apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/lib/useTerminalFontSettings.ts@@ -0,0 +1,40 @@+import { useEffect, useState } from 'react';++import {+ normalizeAppearanceSettings,+ type AppearanceSettings,+} from '@/../shared/appearanceSettings';++export type TerminalFontSettings = Pick<AppearanceSettings, 'terminalFamily' | 'terminalSize'>;++function readTerminalFonts(raw: unknown): TerminalFontSettings {+ const { terminalFamily, terminalSize } = normalizeAppearanceSettings(raw);+ return { terminalFamily, terminalSize };+}++/** Read-only in both sidebar hosts; the detached window needs no settings Provider. */+export function useTerminalFontSettings(): TerminalFontSettings {+ const [settings, setSettings] = useState(() =>+ readTerminalFonts(window.electronAPI?.appearanceSettings?.getSync?.()),+ );++ useEffect(() => {+ const bridge = window.electronAPI?.appearanceSettings;+ if (!bridge) return;+ const receive = (raw: unknown) => {+ const next = readTerminalFonts(raw);+ setSettings((current) =>+ current.terminalFamily === next.terminalFamily && current.terminalSize === next.terminalSize+ ? current+ : next,+ );+ };+ const unsubscribe = bridge.onChanged(receive);+ // The preload cache also receives changes while this component is absent.+ // Subscribe before reading again to close the render-to-effect gap.+ receive(bridge.getSync());+ return unsubscribe;+ }, []);++ return settings;+}diff --git a/apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/lib/xtermPool.ts b/apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/lib/xtermPool.tsindex 00c5a6ae32..a7b908b56a 100644--- a/apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/lib/xtermPool.ts+++ b/apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/lib/xtermPool.ts@@ -1,8 +1,8 @@/*** xtermPool —— per-tab xterm.js Terminal 实例池。*- * 设计动机:RSB 切换顶层 tab 时,非 active 的 TabBody 被 React 卸载(unmount),- * 但 PTY 在 main 进程仍然存活。如果每次切回来都重建 xterm Terminal,scrollback+ * 普通 tab 切换保留挂载并隐藏,任务切换等路径仍可能卸载 TabBody,+ * 但 PTY 在 main 进程仍然存活。如果每次重新挂载都重建 xterm Terminal,scrollback* (用户看过的输出历史)就丢了。pool 把 Terminal 实例跟 tabId 绑定,跨 mount/unmount* 复用,只在 plugin.onBeforeClose 真正关 tab 时才 dispose。*@@ -25,6 +25,10 @@ import { FitAddon } from '@xterm/addon-fit';import { WebLinksAddon } from '@xterm/addon-web-links';import { createLogger } from '@/lib/logger';+import {+ DEFAULT_APPEARANCE_SETTINGS,+ DEFAULT_TERMINAL_FONT_FAMILY,+} from '@/../shared/appearanceSettings';const log = createLogger('terminal');@@ -47,8 +51,8 @@ const pool = new Map<string, XtermEntry>();const DEFAULT_OPTIONS: ITerminalOptions = {// Codex 同款字号 / 字体;cursorBlink 跟 iTerm 默认行为对齐。- fontFamily: '"SF Mono", Menlo, Monaco, "Cascadia Code", "Courier New", monospace',- fontSize: 13,+ fontFamily: DEFAULT_TERMINAL_FONT_FAMILY,+ fontSize: DEFAULT_APPEARANCE_SETTINGS.terminalSize,lineHeight: 1.2,cursorBlink: true,cursorStyle: 'block',diff --git a/apps/desktop/src/renderer/hooks/useFontSettings.ts b/apps/desktop/src/renderer/hooks/useFontSettings.tsindex 6ce6914d07..66ccb57416 100644--- a/apps/desktop/src/renderer/hooks/useFontSettings.ts+++ b/apps/desktop/src/renderer/hooks/useFontSettings.ts@@ -19,6 +19,7 @@ import {APPEARANCE_LIMITS,DEFAULT_APPEARANCE_SETTINGS,clampAppearanceCodeSize,+ clampAppearanceTerminalSize,clampAppearanceUiSize,normalizeAppearanceSettings,type AppearanceSettings,@@ -31,19 +32,29 @@ export interface FontSettings {codeSize: number;}-interface FontSettingsContextValue extends FontSettings {+interface ConfigurableFontSettings extends FontSettings {+ terminalFamily: string;+ terminalSize: number;+}++interface FontSettingsContextValue extends ConfigurableFontSettings {setUiFamily: (family: string) => void;setCodeFamily: (family: string) => void;setUiSize: (size: number) => void;setCodeSize: (size: number) => void;+ setTerminalFamily: (family: string) => void;+ setTerminalSize: (size: number) => void;resetUiFamily: () => void;resetCodeFamily: () => void;resetUiSize: () => void;resetCodeSize: () => void;+ resetTerminalFamily: () => void;+ resetTerminalSize: () => void;}export const DEFAULT_UI_FONT_SIZE = DEFAULT_APPEARANCE_SETTINGS.uiSize;export const DEFAULT_CODE_FONT_SIZE = DEFAULT_APPEARANCE_SETTINGS.codeSize;+export const DEFAULT_TERMINAL_FONT_SIZE = DEFAULT_APPEARANCE_SETTINGS.terminalSize;const MIN_UI_FONT_SIZE = APPEARANCE_LIMITS.uiSize.min;const MIN_FONT_SIZE = APPEARANCE_LIMITS.codeSize.min;const MAX_FONT_SIZE = APPEARANCE_LIMITS.codeSize.max;@@ -123,16 +134,30 @@ export function applyFontSettings(settings: FontSettings): void {}export function FontSettingsProvider({ children }: { children: ReactNode }) {- const [settings, setSettings] = useState<FontSettings>(getInitialFontSettings);+ const [settings, setSettings] = useState<ConfigurableFontSettings>(() => {+ const initial = getInitialAppearanceSettings();+ return {+ uiFamily: initial.uiFamily,+ codeFamily: initial.codeFamily,+ uiSize: initial.uiSize,+ codeSize: initial.codeSize,+ terminalFamily: initial.terminalFamily,+ terminalSize: initial.terminalSize,+ };+ });const settingsRef = useRef(settings);const confirmedSettingsRef = useRef(settings);- const pendingWritesRef = useRef<Array<{ id: number; patch: Partial<FontSettings> }>>([]);+ const pendingWritesRef = useRef<Array<{ id: number; patch: Partial<ConfigurableFontSettings> }>>(+ [],+ );const writeQueueRef = useRef<Promise<void>>(Promise.resolve());const nextRequestIdRef = useRef(0);+ const { uiFamily, codeFamily, uiSize, codeSize } = settings;useEffect(() => {- applyFontSettings(settings);- }, [settings]);+ // Terminal appearance is applied to xterm only, never to the global UI/code tokens.+ applyFontSettings({ uiFamily, codeFamily, uiSize, codeSize });+ }, [uiFamily, codeFamily, uiSize, codeSize]);useEffect(() => {const bridge = getBridge();@@ -144,6 +169,8 @@ export function FontSettingsProvider({ children }: { children: ReactNode }) {codeFamily: normalized.codeFamily,uiSize: normalized.uiSize,codeSize: normalized.codeSize,+ terminalFamily: normalized.terminalFamily,+ terminalSize: normalized.terminalSize,};confirmedSettingsRef.current = confirmed;const optimistic = pendingWritesRef.current.reduce(@@ -155,7 +182,7 @@ export function FontSettingsProvider({ children }: { children: ReactNode }) {});}, []);- const patch = useCallback((next: Partial<FontSettings>) => {+ const patch = useCallback((next: Partial<ConfigurableFontSettings>) => {const previous = settingsRef.current;const merged = { ...previous, ...next };const bridge = getBridge();@@ -212,6 +239,19 @@ export function FontSettingsProvider({ children }: { children: ReactNode }) {(size: number) => patch({ codeSize: clampAppearanceCodeSize(size) }),[patch],);+ const setTerminalFamily = useCallback(+ (family: string) => patch({ terminalFamily: normalizeFamily(family) }),+ [patch],+ );+ const setTerminalSize = useCallback(+ (size: number) => patch({ terminalSize: clampAppearanceTerminalSize(size) }),+ [patch],+ );+ const resetTerminalFamily = useCallback(() => setTerminalFamily(''), [setTerminalFamily]);+ const resetTerminalSize = useCallback(+ () => setTerminalSize(DEFAULT_TERMINAL_FONT_SIZE),+ [setTerminalSize],+ );const resetUiFamily = useCallback(() => setUiFamily(''), [setUiFamily]);const resetCodeFamily = useCallback(() => setCodeFamily(''), [setCodeFamily]);const resetUiSize = useCallback(() => setUiSize(DEFAULT_UI_FONT_SIZE), [setUiSize]);@@ -224,18 +264,26 @@ export function FontSettingsProvider({ children }: { children: ReactNode }) {setCodeFamily,setUiSize,setCodeSize,+ setTerminalFamily,+ setTerminalSize,resetUiFamily,resetCodeFamily,resetUiSize,resetCodeSize,+ resetTerminalFamily,+ resetTerminalSize,}),[resetCodeFamily,resetCodeSize,+ resetTerminalFamily,+ resetTerminalSize,resetUiFamily,resetUiSize,setCodeFamily,setCodeSize,+ setTerminalFamily,+ setTerminalSize,setUiFamily,setUiSize,settings,diff --git a/apps/desktop/src/renderer/i18n/locales/en/common.json b/apps/desktop/src/renderer/i18n/locales/en/common.jsonindex eed111b10f..e2458b1ea6 100644--- a/apps/desktop/src/renderer/i18n/locales/en/common.json+++ b/apps/desktop/src/renderer/i18n/locales/en/common.json@@ -1791,6 +1791,16 @@"description": "Resize text only in code blocks, change comparisons, and editors. Inline code, status numbers, badges, and path labels keep their size.","aria": "Adjust code font size"},+ "terminalFamily": {+ "label": "Terminal font",+ "description": "Used only by the built-in terminal. A monospace font is recommended.",+ "aria": "Select terminal font"+ },+ "terminalSize": {+ "label": "Terminal font size",+ "description": "Adjust the text size in the built-in terminal.",+ "aria": "Adjust terminal font size"+ },"presetsUi": {"default": "Inter (Default)","codexStyle": "Codex style",@@ -1800,8 +1810,12 @@"default": "Codex style (Default)","jetbrainsMono": "JetBrains Mono"},+ "presetsTerminal": {+ "default": "Monospace (Default)"+ },"previewSamples": {- "ui": "The quick brown fox jumps over the lazy dog ABC xyz · a/b/c/d · a,b · 0123456789 !?@&"+ "ui": "The quick brown fox jumps over the lazy dog ABC xyz · a/b/c/d · a,b · 0123456789 !?@&",+ "terminal": "$ echo \"Terminal font preview\"\nTerminal font preview\n0123456789 0O 1lI"}},"singleVariant": {diff --git a/apps/desktop/src/renderer/i18n/locales/ja/common.json b/apps/desktop/src/renderer/i18n/locales/ja/common.jsonindex 5041e53d01..0c1bf7cc85 100644--- a/apps/desktop/src/renderer/i18n/locales/ja/common.json+++ b/apps/desktop/src/renderer/i18n/locales/ja/common.json@@ -1762,6 +1762,16 @@"description": "コードブロック、変更の比較、エディターの文字サイズのみを調整します。文中のコード、状態を示す数値、バッジ、パスのラベルは変わりません。","aria": "コードのフォントサイズを調整"},+ "terminalFamily": {+ "label": "ターミナルのフォント",+ "description": "内蔵ターミナルでのみ使用します。等幅フォントを推奨します。",+ "aria": "ターミナルのフォントを選択"+ },+ "terminalSize": {+ "label": "ターミナルのフォントサイズ",+ "description": "内蔵ターミナルのフォントサイズを調整します。",+ "aria": "ターミナルのフォントサイズを調整"+ },"presetsUi": {"default": "Inter(デフォルト)","codexStyle": "Codex スタイル",@@ -1771,8 +1781,12 @@"default": "Codex スタイル(デフォルト)","jetbrainsMono": "JetBrains Mono"},+ "presetsTerminal": {+ "default": "等幅フォント(デフォルト)"+ },"previewSamples": {- "ui": "日本語フォントは読みやすく美しい ABC xyz · a/b/c/d · a,b · 0123456789 !?@&"+ "ui": "日本語フォントは読みやすく美しい ABC xyz · a/b/c/d · a,b · 0123456789 !?@&",+ "terminal": "$ echo \"ターミナルのフォントプレビュー\"\nターミナルのフォントプレビュー\n0123456789 0O 1lI"}},"singleVariant": {diff --git a/apps/desktop/src/renderer/i18n/locales/ko/common.json b/apps/desktop/src/renderer/i18n/locales/ko/common.jsonindex dd986439bc..5b7673673e 100644--- a/apps/desktop/src/renderer/i18n/locales/ko/common.json+++ b/apps/desktop/src/renderer/i18n/locales/ko/common.json@@ -1762,6 +1762,16 @@"description": "코드 블록, 변경 사항 비교, 편집기의 글자 크기만 조절합니다. 문장 안의 코드, 상태 숫자, 배지, 경로 라벨의 크기는 바뀌지 않습니다.","aria": "코드 글꼴 크기 조정"},+ "terminalFamily": {+ "label": "터미널 글꼴",+ "description": "내장 터미널에만 사용됩니다. 고정폭 글꼴을 권장합니다.",+ "aria": "터미널 글꼴 선택"+ },+ "terminalSize": {+ "label": "터미널 글꼴 크기",+ "description": "내장 터미널의 글자 크기를 조정합니다.",+ "aria": "터미널 글꼴 크기 조정"+ },"presetsUi": {"default": "Inter(기본값)","codexStyle": "Codex 스타일",@@ -1771,8 +1781,12 @@"default": "Codex 스타일(기본값)","jetbrainsMono": "JetBrains Mono"},+ "presetsTerminal": {+ "default": "고정폭 글꼴(기본값)"+ },"previewSamples": {- "ui": "한글 글꼴은 또렷하고 읽기 쉬워요 ABC xyz · a/b/c/d · a,b · 0123456789 !?@&"+ "ui": "한글 글꼴은 또렷하고 읽기 쉬워요 ABC xyz · a/b/c/d · a,b · 0123456789 !?@&",+ "terminal": "$ echo \"터미널 글꼴 미리보기\"\n터미널 글꼴 미리보기\n0123456789 0O 1lI"}},"singleVariant": {diff --git a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.jsonindex 9cfd9a8fc6..7142a12832 100644--- a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json+++ b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json@@ -1762,6 +1762,16 @@"description": "仅调整代码块、修改对比和编辑器字号;不影响行内代码、状态数字、徽标和路径标签","aria": "调整代码字号"},+ "terminalFamily": {+ "label": "终端字体",+ "description": "仅用于内置终端,建议使用等宽字体。",+ "aria": "选择终端字体"+ },+ "terminalSize": {+ "label": "终端字号",+ "description": "调整内置终端中的文字大小。",+ "aria": "调整终端字号"+ },"presetsUi": {"default": "Inter(默认)","codexStyle": "Codex 风格",@@ -1771,8 +1781,12 @@"default": "Codex 风格(默认)","jetbrainsMono": "JetBrains Mono"},+ "presetsTerminal": {+ "default": "等宽字体(默认)"+ },"previewSamples": {- "ui": "中文字体预览,清晰锐利 ABC xyz · a/b/c/d · a,b · 0123456789 !?@&"+ "ui": "中文字体预览,清晰锐利 ABC xyz · a/b/c/d · a,b · 0123456789 !?@&",+ "terminal": "$ echo \"终端字体预览\"\n终端字体预览\n0123456789 0O 1lI"}},"singleVariant": {diff --git a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.jsonindex 6bdc7dae7c..058ea14667 100644--- a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json+++ b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json@@ -1762,6 +1762,16 @@"description": "僅調整程式碼區塊、修改比較和編輯器字級;不影響行內程式碼、狀態數字、徽章和路徑標籤","aria": "調整程式碼字號"},+ "terminalFamily": {+ "label": "終端字型",+ "description": "僅用於內建終端,建議使用等寬字型。",+ "aria": "選擇終端字型"+ },+ "terminalSize": {+ "label": "終端字號",+ "description": "調整內建終端中的文字大小。",+ "aria": "調整終端字號"+ },"presetsUi": {"default": "Inter(預設)","codexStyle": "Codex 風格",@@ -1771,8 +1781,12 @@"default": "Codex 風格(預設)","jetbrainsMono": "JetBrains Mono"},+ "presetsTerminal": {+ "default": "等寬字型(預設)"+ },"previewSamples": {- "ui": "中文字型預覽,清晰銳利 ABC xyz · a/b/c/d · a,b · 0123456789 !?@&"+ "ui": "中文字型預覽,清晰銳利 ABC xyz · a/b/c/d · a,b · 0123456789 !?@&",+ "terminal": "$ echo \"終端字型預覽\"\n終端字型預覽\n0123456789 0O 1lI"}},"singleVariant": {diff --git a/apps/desktop/src/shared/__tests__/appearanceSettings.test.ts b/apps/desktop/src/shared/__tests__/appearanceSettings.test.tsnew file mode 100644index 0000000000..267ec8eace--- /dev/null+++ b/apps/desktop/src/shared/__tests__/appearanceSettings.test.ts@@ -0,0 +1,38 @@+import { describe, expect, it } from 'vitest';++import {+ DEFAULT_APPEARANCE_SETTINGS,+ DEFAULT_TERMINAL_FONT_FAMILY,+ clampAppearanceTerminalSize,+ normalizeAppearanceSettings,+} from '../appearanceSettings';++describe('terminal appearance settings', () => {+ it('adds the existing terminal defaults to old settings without inheriting code fonts', () => {+ const oldSettings = {+ uiFamily: 'Inter', codeFamily: 'JetBrains Mono', uiSize: 16, codeSize: 22, windowZoom: 1.2,+ };+ expect(normalizeAppearanceSettings(oldSettings)).toEqual({+ ...DEFAULT_APPEARANCE_SETTINGS, ...oldSettings, terminalFamily: '', terminalSize: 13,+ });+ expect(DEFAULT_TERMINAL_FONT_FAMILY).toBe(+ '"SF Mono", Menlo, Monaco, "Cascadia Code", "Courier New", monospace',+ );+ });++ it('normalizes terminal input without changing unrelated defaults', () => {+ expect(normalizeAppearanceSettings({ terminalFamily: ' Menlo ', terminalSize: 18.6 })).toEqual({+ ...DEFAULT_APPEARANCE_SETTINGS, terminalFamily: 'Menlo', terminalSize: 19,+ });+ expect(normalizeAppearanceSettings({ terminalFamily: 3, terminalSize: '19' })).toEqual(+ DEFAULT_APPEARANCE_SETTINGS,+ );+ expect(normalizeAppearanceSettings({ terminalFamily: 'x'.repeat(300) }).terminalFamily).toHaveLength(256);+ });++ it.each([+ [9, 10], [25, 24], [13.6, 14], [NaN, 13], [Infinity, 13], [-Infinity, 13],+ ])('clamps terminal size %s to %s', (input, expected) => {+ expect(clampAppearanceTerminalSize(input)).toBe(expected);+ });+});diff --git a/apps/desktop/src/shared/__tests__/appearanceWallpaper.test.ts b/apps/desktop/src/shared/__tests__/appearanceWallpaper.test.tsindex 08994481c8..bd18fe0d92 100644--- a/apps/desktop/src/shared/__tests__/appearanceWallpaper.test.ts+++ b/apps/desktop/src/shared/__tests__/appearanceWallpaper.test.ts@@ -92,6 +92,8 @@ describe('wallpaper catalog compatibility', () => {windowZoom: 1.2,});expect(settings).toEqual({+ terminalFamily: '',+ terminalSize: 13,wallpaperId: 'none',customWallpaperUrl: '',wallpaperMotion: 'dynamic',diff --git a/apps/desktop/src/shared/appearanceSettings.ts b/apps/desktop/src/shared/appearanceSettings.tsindex bb65ed87e4..f1ef9a8669 100644--- a/apps/desktop/src/shared/appearanceSettings.ts+++ b/apps/desktop/src/shared/appearanceSettings.ts@@ -12,6 +12,8 @@ export interface AppearanceOverrides {codeFamily?: string;uiSize?: number;codeSize?: number;+ terminalFamily?: string;+ terminalSize?: number;windowZoom?: number;wallpaperId?: WallpaperId;wallpaperOverlay?: number;@@ -40,6 +42,8 @@ export interface AppearanceSettings {codeFamily: string;uiSize: number;codeSize: number;+ terminalFamily: string;+ terminalSize: number;windowZoom: number;wallpaperId: WallpaperId;wallpaperOverlay: number;@@ -51,11 +55,17 @@ export interface AppearanceSettings {customWallpaperUrl?: string;}+/** Keep the terminal's existing platform fallbacks independent of code fonts. */+export const DEFAULT_TERMINAL_FONT_FAMILY =+ '"SF Mono", Menlo, Monaco, "Cascadia Code", "Courier New", monospace';+export const DEFAULT_APPEARANCE_SETTINGS: AppearanceSettings = {uiFamily: '',codeFamily: '',uiSize: DEFAULT_FONT_SIZES.uiSize,codeSize: DEFAULT_FONT_SIZES.codeSize,+ terminalFamily: '',+ terminalSize: 13,windowZoom: 1,wallpaperId: 'none',wallpaperOverlay: 0.2,@@ -66,6 +76,7 @@ export const DEFAULT_APPEARANCE_SETTINGS: AppearanceSettings = {export const APPEARANCE_LIMITS = {uiSize: { min: 12, max: 24 },codeSize: { min: 10, max: 24 },+ terminalSize: { min: 10, max: 24 },windowZoom: { min: 0.5, max: 3, step: 0.1 },wallpaperOverlay: { min: 0, max: 1, step: 0.05 },wallpaperVisibility: { min: 0, max: 1, step: 0.01 },@@ -176,6 +187,18 @@ export function clampAppearanceCodeSize();}+export function clampAppearanceTerminalSize(+ value: number,+ fallback = DEFAULT_APPEARANCE_SETTINGS.terminalSize,+): number {+ return clampInteger(+ value,+ APPEARANCE_LIMITS.terminalSize.min,+ APPEARANCE_LIMITS.terminalSize.max,+ fallback,+ );+}+export function clampAppearanceWindowZoom(value: number,fallback = DEFAULT_APPEARANCE_SETTINGS.windowZoom,@@ -197,6 +220,7 @@ export function normalizeAppearanceSettings(raw: unknown): AppearanceSettings {return {uiFamily: normalizeFamily(value.uiFamily),codeFamily: normalizeFamily(value.codeFamily),+ terminalFamily: normalizeFamily(value.terminalFamily),uiSize:typeof value.uiSize === 'number'? clampAppearanceUiSize(value.uiSize)@@ -205,6 +229,10 @@ export function normalizeAppearanceSettings(raw: unknown): AppearanceSettings {typeof value.codeSize === 'number'? clampAppearanceCodeSize(value.codeSize): DEFAULT_APPEARANCE_SETTINGS.codeSize,+ terminalSize:+ typeof value.terminalSize === 'number'+ ? clampAppearanceTerminalSize(value.terminalSize)+ : DEFAULT_APPEARANCE_SETTINGS.terminalSize,windowZoom:typeof value.windowZoom === 'number'? clampAppearanceWindowZoom(value.windowZoom)diff --git a/docs/design-rules/design-inventory.md b/docs/design-rules/design-inventory.mdindex 8d34b5cb50..db48a55281 100644--- a/docs/design-rules/design-inventory.md+++ b/docs/design-rules/design-inventory.md@@ -38,8 +38,8 @@| `desktop.overlay.toast` | desktop | Toast | App 常驻 ToastContainer(用户可见出口,不展开业务逻辑) | Toast, ToastContainer | apps/desktop/src/renderer/components/ui/toast/DownloadToast.tsx, 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 | 7 | 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, GhostPluginActions, GhostPluginDetailView, GhostPluginPage, MarketPluginDetailView, MyPublishesSection, PluginDevicePicker, PluginManagementLayout, PluginProjectMenu, RemotePluginConfiguration, RemotePluginPage, RemotePluginReadOnlyDetail, UpdateAllDialog | apps/desktop/src/renderer/features/plugin/AddMarketplaceDialog.tsx, apps/desktop/src/renderer/features/plugin/GhostPluginActions.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/PluginDevicePicker.tsx, apps/desktop/src/renderer/features/plugin/PluginManagementLayout.tsx, apps/desktop/src/renderer/features/plugin/PluginScopePicker.tsx, apps/desktop/src/renderer/features/plugin/RemotePluginConfiguration.tsx, apps/desktop/src/renderer/features/plugin/RemotePluginPage.tsx, apps/desktop/src/renderer/features/plugin/RemotePluginReadOnlyDetail.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/AddSpeechModelsDialog.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/AvatarCropEditor.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/LocalAgentSection.settings-search.ts, apps/desktop/src/renderer/components/settings/LocalAgentSection.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/SpeechModelChoices.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/VoiceSpeakerEnrollmentDialog.tsx, apps/desktop/src/renderer/components/settings/VoiceSpeakerFilterCard.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/avatarCropGeometry.ts, apps/desktop/src/renderer/components/settings/avatarCropImage.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/settingsRowClasses.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/UsageFilterSelect.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 | 95 | 548 |-| `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/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/SidebarTabWindowLayout.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/NewTag.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/sidebar/useHoverOpenMenu.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/TabDragController.tsx, apps/desktop/src/renderer/features/right-sidebar/TabGroupPanel.tsx, apps/desktop/src/renderer/features/right-sidebar/botMenuOwnerContext.ts, apps/desktop/src/renderer/features/right-sidebar/globalTabs.ts, 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/hooks/useRetainedBrowserTabHosts.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/mailPreview.test.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mailPreview.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mergeSidebarWindowBack.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/openInSidebarBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openInSidebarFileBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openPluginTaskTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openRoutinesTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openSideChatTab.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/lib/tabHosting.ts, apps/desktop/src/renderer/features/right-sidebar/lib/useTabCreationMenu.ts, apps/desktop/src/renderer/features/right-sidebar/moveTab.ts, apps/desktop/src/renderer/features/right-sidebar/pluginPlacement.ts, 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/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/mail-preview/MailCardBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailConversationView.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailPreview.test.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/index.tsx, 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/plugin-task/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/plugin-view/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/side-chat/SideChatTabBody.test.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/SideChatTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/state.ts, 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/tabGroupHost.tsx, apps/desktop/src/renderer/features/right-sidebar/tabGroupPanes.ts, apps/desktop/src/renderer/features/right-sidebar/tabGroups.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 | 147 | 46 | 201 |+| `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/AddSpeechModelsDialog.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/AvatarCropEditor.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/LocalAgentSection.settings-search.ts, apps/desktop/src/renderer/components/settings/LocalAgentSection.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/SpeechModelChoices.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/VoiceSpeakerEnrollmentDialog.tsx, apps/desktop/src/renderer/components/settings/VoiceSpeakerFilterCard.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/avatarCropGeometry.ts, apps/desktop/src/renderer/components/settings/avatarCropImage.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/settingsRowClasses.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/UsageFilterSelect.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 | 95 | 549 |+| `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/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/SidebarTabWindowLayout.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/NewTag.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/sidebar/useHoverOpenMenu.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/TabDragController.tsx, apps/desktop/src/renderer/features/right-sidebar/TabGroupPanel.tsx, apps/desktop/src/renderer/features/right-sidebar/botMenuOwnerContext.ts, apps/desktop/src/renderer/features/right-sidebar/globalTabs.ts, 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/hooks/useRetainedBrowserTabHosts.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/mailPreview.test.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mailPreview.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mergeSidebarWindowBack.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/openInSidebarBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openInSidebarFileBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openPluginTaskTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openRoutinesTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openSideChatTab.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/lib/tabHosting.ts, apps/desktop/src/renderer/features/right-sidebar/lib/useTabCreationMenu.ts, apps/desktop/src/renderer/features/right-sidebar/moveTab.ts, apps/desktop/src/renderer/features/right-sidebar/pluginPlacement.ts, 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/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/mail-preview/MailCardBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailConversationView.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailPreview.test.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/index.tsx, 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/plugin-task/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/plugin-view/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/side-chat/SideChatTabBody.test.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/SideChatTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/state.ts, 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/terminalFont.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/lib/useTerminalFontSettings.ts, 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/tabGroupHost.tsx, apps/desktop/src/renderer/features/right-sidebar/tabGroupPanes.ts, apps/desktop/src/renderer/features/right-sidebar/tabGroups.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 | 147 | 46 | 201 || `desktop.skillhub.local` | desktop | SkillHub 本地技能 | hash `/skillhub/local` 及统一详情 `/skillhub/detail`(旧详情链接重定向) | InstallTargetPicker, PluginDevicePicker, PluginManagementLayout, RemoteSkillsPage, SkillCategoryFilterBar, SkillDetailLayout, SkillhubDetailRoute, SkillhubDetailView, SkillhubFeatureLayout, SkillhubHomeView, SkillhubLocalLayout, SkillhubMarketDetailView | apps/desktop/src/renderer/features/plugin/PluginDevicePicker.tsx, apps/desktop/src/renderer/features/plugin/PluginManagementLayout.tsx, apps/desktop/src/renderer/features/skillhub/RemoteSkillsPage.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/SkillCategoryFilterBar.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillDetailLayout.tsx, apps/desktop/src/renderer/features/skillhub/skillhub-home.css | 39 | 0 | 45 || `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 | 42 | 0 | 35 || `desktop.window.computer-permission-guide` | desktop | 电脑使用权限引导 | `?view=computer-permission-guide` → ComputerPermissionGuideWindow;backdrop 同文件 | ComputerPermissionBackdrop, ComputerPermissionGuideWindow | apps/desktop/src/main/computer-permission-guide/MacComputerPermissionGuideNativeHost.ts, apps/desktop/src/main/computer-permission-guide/placement.ts, apps/desktop/src/main/computer-permission-guide/request.ts, apps/desktop/src/main/computer-permission-guide/switch-target.ts, apps/desktop/src/main/computer-permission-guide/window.ts, apps/desktop/src/renderer/components/settings/ComputerPermissionGuideWindow.tsx | 7 | 2 | 9 |@@ -47,7 +47,7 @@| `desktop.window.resource-usage` | desktop | 资源用量窗口 | `?resourceUsageWindow=1` → renderer/resource-usage-entry.tsx(不走 router.tsx) | ResourceUsageWindowLayout, ResourceUsageWindowRoot | apps/desktop/src/main/resource-usage-window/controller.ts, apps/desktop/src/main/resource-usage-window/ipc.ts, apps/desktop/src/main/resource-usage-window/open-sender.ts, apps/desktop/src/main/resource-usage-window/registry.ts, apps/desktop/src/main/resource-usage-window/window.ts, apps/desktop/src/renderer/components/resource-usage/ResourceUsageWindowLayout.tsx, apps/desktop/src/renderer/resource-usage-entry.tsx, apps/desktop/src/renderer/styles/generated/tokens.css, apps/desktop/src/renderer/styles/globals.css | 79 | 38 | 15 || `desktop.window.review-artifact-confirm` | desktop | Review 成果确认窗 | main/reviewer/reviewArtifactConfirmWindow.ts 内联 HTML/CSS(不走 renderer 路由) | reviewArtifactConfirmWindow | apps/desktop/src/main/reviewer/reviewArtifactConfirmWindow.ts | 8 | 18 | 2 || `desktop.window.session-drag-preview` | desktop | 会话拖拽预览 | main/session-drag-preview.ts 透明预览窗 | session-drag-preview | apps/desktop/src/main/session-drag-preview.ts | 0 | 1 | 0 |-| `desktop.window.sidebar` | desktop | 右侧栏独立窗口 | `?sidebarWindow=1` → renderer/sidebar-window-entry.tsx;hash `/sidebar-window` | RightSidebar, RightSidebarShell, SidebarWindowLayout | apps/desktop/src/main/right-sidebar-window/controller.ts, apps/desktop/src/main/right-sidebar-window/ipc.ts, apps/desktop/src/main/right-sidebar-window/registry.ts, apps/desktop/src/main/right-sidebar-window/resolveHostContext.ts, apps/desktop/src/main/right-sidebar-window/settings-store.ts, apps/desktop/src/main/right-sidebar-window/window.ts, apps/desktop/src/renderer/components/layout/SidebarWindowLayout.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/TabDragController.tsx, apps/desktop/src/renderer/features/right-sidebar/TabGroupPanel.tsx, apps/desktop/src/renderer/features/right-sidebar/botMenuOwnerContext.ts, apps/desktop/src/renderer/features/right-sidebar/globalTabs.ts, 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/hooks/useRetainedBrowserTabHosts.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/mailPreview.test.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mailPreview.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mergeSidebarWindowBack.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/openInSidebarBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openInSidebarFileBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openPluginTaskTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openRoutinesTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openSideChatTab.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/lib/tabHosting.ts, apps/desktop/src/renderer/features/right-sidebar/lib/useTabCreationMenu.ts, apps/desktop/src/renderer/features/right-sidebar/moveTab.ts, apps/desktop/src/renderer/features/right-sidebar/pluginPlacement.ts, 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/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/mail-preview/MailCardBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailConversationView.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailPreview.test.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/index.tsx, 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/plugin-task/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/plugin-view/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/side-chat/SideChatTabBody.test.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/SideChatTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/state.ts, 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/tabGroupHost.tsx, apps/desktop/src/renderer/features/right-sidebar/tabGroupPanes.ts, apps/desktop/src/renderer/features/right-sidebar/tabGroups.ts, apps/desktop/src/renderer/features/right-sidebar/types.ts, apps/desktop/src/renderer/sidebar-window-entry.tsx, apps/desktop/src/renderer/styles/generated/tokens.css, apps/desktop/src/renderer/styles/globals.css | 113 | 45 | 120 |+| `desktop.window.sidebar` | desktop | 右侧栏独立窗口 | `?sidebarWindow=1` → renderer/sidebar-window-entry.tsx;hash `/sidebar-window` | RightSidebar, RightSidebarShell, SidebarWindowLayout | apps/desktop/src/main/right-sidebar-window/controller.ts, apps/desktop/src/main/right-sidebar-window/ipc.ts, apps/desktop/src/main/right-sidebar-window/registry.ts, apps/desktop/src/main/right-sidebar-window/resolveHostContext.ts, apps/desktop/src/main/right-sidebar-window/settings-store.ts, apps/desktop/src/main/right-sidebar-window/window.ts, apps/desktop/src/renderer/components/layout/SidebarWindowLayout.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/TabDragController.tsx, apps/desktop/src/renderer/features/right-sidebar/TabGroupPanel.tsx, apps/desktop/src/renderer/features/right-sidebar/botMenuOwnerContext.ts, apps/desktop/src/renderer/features/right-sidebar/globalTabs.ts, 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/hooks/useRetainedBrowserTabHosts.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/mailPreview.test.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mailPreview.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mergeSidebarWindowBack.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/openInSidebarBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openInSidebarFileBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openPluginTaskTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openRoutinesTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openSideChatTab.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/lib/tabHosting.ts, apps/desktop/src/renderer/features/right-sidebar/lib/useTabCreationMenu.ts, apps/desktop/src/renderer/features/right-sidebar/moveTab.ts, apps/desktop/src/renderer/features/right-sidebar/pluginPlacement.ts, 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/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/mail-preview/MailCardBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailConversationView.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailPreview.test.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/index.tsx, 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/plugin-task/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/plugin-view/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/side-chat/SideChatTabBody.test.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/SideChatTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/state.ts, 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/terminalFont.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/lib/useTerminalFontSettings.ts, 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/tabGroupHost.tsx, apps/desktop/src/renderer/features/right-sidebar/tabGroupPanes.ts, apps/desktop/src/renderer/features/right-sidebar/tabGroups.ts, apps/desktop/src/renderer/features/right-sidebar/types.ts, apps/desktop/src/renderer/sidebar-window-entry.tsx, apps/desktop/src/renderer/styles/generated/tokens.css, apps/desktop/src/renderer/styles/globals.css | 113 | 45 | 120 || `desktop.window.voice-dictionary-toast` | desktop | 语音词典 Toast 窗 | `?view=voice-input-dictionary-toast` → main-entry.tsx → VoiceInputDictionaryToast | VoiceInputDictionaryToast | apps/desktop/src/renderer/voice-input/VoiceInputDictionaryToast.tsx | 6 | 0 | 2 || `desktop.window.voice-overlay` | desktop | 语音输入浮窗 | `?view=voice-input-overlay` → main-entry.tsx → VoiceInputOverlay | VoiceInputOverlay, VoiceInputStatusNotice | apps/desktop/src/main/voice-input/global.ts, apps/desktop/src/renderer/styles/generated/tokens.css, apps/desktop/src/renderer/styles/globals.css, apps/desktop/src/renderer/voice-input/VoiceInputOverlay.tsx, apps/desktop/src/renderer/voice-input/VoiceInputStatusNotice.tsx | 84 | 38 | 20 || `mobile.account-deletion` | mobile | 账号注销 | app/account-deletion.tsx | AdaptiveWindow, AnchoredPullDownMenu, AnchoredPullDownMenu.android, AndroidUpdateSheet, AppText, AuthContext, BlurBackdrop, CenteredScreen, ConnectionBanner, ConnectionNoticeOverlay, DeviceLinkContext, DirectLinkTransport, FoldTouchpad, HomeEntryProvider, HomeHeaderGlassButton, HomeHeaderGlassButton.ios, HomeNativeStackHeader, HomeStackHeader, IncomingShareBridge, McpAppViews, MobileLoginHandoffContext, MobileLoginHandoffStage, MobileOutboxBridge, MobilePrimitives, NativeBottomSheet, NativeBottomSheet.android, NativeChromeBackButton.ios, NativeChromeButton.ios, NativeMcpAppSurface, NativePullDownMenu, NativeRemoteDesktopView, NativeResidentHistory, NativeSwitch, OutsideTap, PermissionGuide, PermissionGuideView, PermissionGuideView.ios, PushNotificationsBridge, QuietSyncIndicator, RecentMessageHistories, RemoteDesktopActionButton, RemoteDesktopActionButton.ios, RemoteDesktopBackButton, RemoteDesktopBackButton.ios, RemoteDesktopChrome, RemoteDesktopChrome.ios, RemoteDesktopClipboardButton, RemoteDesktopControls, RemoteDesktopDisplaySettings, RemoteDesktopHost, RemoteDesktopIcons, RemoteDesktopMouseControls, RemoteDesktopMouseControls.ios, RemoteDesktopNetworkStatus, RemoteDesktopPanelButton, RemoteDesktopPanelButton.ios, RemoteDesktopScreen, RemoteDesktopSecuritySettings, RemoteDesktopWindows, RemoteHistoryPrefetchBridge, ResidentHomeList, SheetModal, SimpleStackHeader, StartupSplashOverlay, ThemeProvider, _layout, account-deletion, gestureHandler, nativeToolbarMenuItems, peerFileTransport, useLocale | apps/mobile/app/_layout.tsx, apps/mobile/app/account-deletion.tsx, apps/mobile/src/auth/AuthContext.tsx, apps/mobile/src/auth/MobileLoginHandoffContext.tsx, apps/mobile/src/components/AppText.tsx, apps/mobile/src/components/CenteredScreen.tsx, apps/mobile/src/components/ConnectionBanner.tsx, apps/mobile/src/components/ConnectionNoticeOverlay.tsx, apps/mobile/src/components/MobileLoginHandoffStage.tsx, apps/mobile/src/components/MobilePrimitives.tsx, apps/mobile/src/components/QuietSyncIndicator.tsx, apps/mobile/src/components/StartupSplashOverlay.tsx, apps/mobile/src/device-link/DeviceLinkContext.tsx, apps/mobile/src/device-link/DirectLinkTransport.tsx, apps/mobile/src/device-link/peerFileTransport.tsx, apps/mobile/src/i18n/useLocale.tsx, apps/mobile/src/notifications/PushNotificationsBridge.tsx, apps/mobile/src/platform/AdaptiveWindow.tsx, apps/mobile/src/platform/OutsideTap.tsx, apps/mobile/src/platform/chrome/AnchoredPullDownMenu.android.tsx, apps/mobile/src/platform/chrome/AnchoredPullDownMenu.tsx, apps/mobile/src/platform/chrome/HomeNativeStackHeader.tsx, apps/mobile/src/platform/chrome/HomeStackHeader.tsx, apps/mobile/src/platform/chrome/NativeChromeBackButton.ios.tsx, apps/mobile/src/platform/chrome/NativeChromeButton.ios.tsx, apps/mobile/src/platform/chrome/NativePullDownMenu.tsx, apps/mobile/src/platform/chrome/NativeSwitch.tsx, apps/mobile/src/platform/chrome/SimpleStackHeader.tsx, apps/mobile/src/platform/chrome/nativeToolbarMenuItems.tsx, apps/mobile/src/platform/gestureHandler.tsx, apps/mobile/src/remote-desktop/FoldTouchpad.tsx, apps/mobile/src/remote-desktop/NativeRemoteDesktopView.tsx, apps/mobile/src/remote-desktop/PermissionGuide.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.ios.tsx, apps/mobile/src/remote-desktop/PermissionGuideView.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopActionButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopBackButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopChrome.tsx, apps/mobile/src/remote-desktop/RemoteDesktopClipboardButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopDisplaySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopHost.tsx, apps/mobile/src/remote-desktop/RemoteDesktopIcons.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopMouseControls.tsx, apps/mobile/src/remote-desktop/RemoteDesktopNetworkStatus.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.ios.tsx, apps/mobile/src/remote-desktop/RemoteDesktopPanelButton.tsx, apps/mobile/src/remote-desktop/RemoteDesktopScreen.tsx, apps/mobile/src/remote-desktop/RemoteDesktopSecuritySettings.tsx, apps/mobile/src/remote-desktop/RemoteDesktopWindows.tsx, apps/mobile/src/remote-desktop/viewerHtml.ts, apps/mobile/src/session/BlurBackdrop.tsx, apps/mobile/src/session/HomeEntryProvider.tsx, apps/mobile/src/session/HomeHeaderGlassButton.ios.tsx, apps/mobile/src/session/HomeHeaderGlassButton.tsx, apps/mobile/src/session/IncomingShareBridge.tsx, apps/mobile/src/session/McpAppViews.tsx, apps/mobile/src/session/MobileOutboxBridge.tsx, apps/mobile/src/session/NativeBottomSheet.android.tsx, apps/mobile/src/session/NativeBottomSheet.tsx, apps/mobile/src/session/NativeMcpAppSurface.tsx, apps/mobile/src/session/NativeResidentHistory.tsx, apps/mobile/src/session/RecentMessageHistories.tsx, apps/mobile/src/session/RemoteHistoryPrefetchBridge.tsx, apps/mobile/src/session/ResidentHomeList.tsx, apps/mobile/src/session/SheetModal.tsx, apps/mobile/src/theme/ThemeProvider.tsx, apps/mobile/src/theme/navigationTheme.ts, apps/mobile/src/theme/tokens.ts, apps/mobile/src/update/AndroidUpdateSheet.tsx | 0 | 218 | 59 |