Skip to content

armgit / cindy

Public Imported from GitHub
0

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

feat(desktop): 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.ts
index 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.ts
new file mode 100644
index 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.ts
index 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.ts
new file mode 100644
index 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.ts
index 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') as
websiteUrl: 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.ts
new file mode 100644
index 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.ts
index 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.tsx
index 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.tsx
index 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.tsx
new file mode 100644
index 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.tsx
index 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 }: Props
patchState({ 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 }: Props
if (!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 }: Props
const 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.tsx
new file mode 100644
index 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.tsx
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
index 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.ts
index 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.json
index 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.json
index 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.json
index 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.json
index 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.json
index 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.ts
new file mode 100644
index 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.ts
index 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.ts
index 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.md
index 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 |