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。

fix(settings): 修正配置读取与保存完成的时序

Dash8f7fa4f4afd9
diff --git a/apps/desktop/src/renderer/components/settings/ComputerUseSection.tsx b/apps/desktop/src/renderer/components/settings/ComputerUseSection.tsx
index 5353aa0506..c564008b8a 100644
--- a/apps/desktop/src/renderer/components/settings/ComputerUseSection.tsx
+++ b/apps/desktop/src/renderer/components/settings/ComputerUseSection.tsx
@@ -780,13 +780,13 @@ export function ComputerUseSection({ workingDir }: ComputerUseSectionProps) {
setComputerStatus(nextStatus);
if (!isComputerPermissionReady(nextStatus)) {
setComputerPermissionPending(false);
- setComputerEnabled(false);
- if (computerEnabled) {
- await window.electronAPI.maker.plugins
- .setEnabled(COMPUTER_PLUGIN_ID, false)
- .catch((error) =>
- log.warn('disabling computer after permission reset failed', error),
- );
+ try {
+ // Unknown opt-in may still be enabled in main. Only publish off
+ // after persisting it, keeping the initial read alive on failure.
+ await window.electronAPI.maker.plugins.setEnabled(COMPUTER_PLUGIN_ID, false);
+ if (computerUseSectionMountedRef.current) setComputerEnabled(false);
+ } catch (error) {
+ log.warn('disabling computer after permission reset failed', error);
}
toast.warning(t('settings.computerUse.directControl.toast.permissionPending'));
}
@@ -801,7 +801,7 @@ export function ComputerUseSection({ workingDir }: ComputerUseSectionProps) {
}
}
},
- [computerEnabled, refreshDriverUpdateCheck, setComputerEnabled, t],
+ [refreshDriverUpdateCheck, setComputerEnabled, t],
);
useEffect(() => {
diff --git a/apps/desktop/src/renderer/components/settings/__tests__/ComputerUseSection.browserHealth.test.tsx b/apps/desktop/src/renderer/components/settings/__tests__/ComputerUseSection.browserHealth.test.tsx
index f3e2b1af00..68042842b3 100644
--- a/apps/desktop/src/renderer/components/settings/__tests__/ComputerUseSection.browserHealth.test.tsx
+++ b/apps/desktop/src/renderer/components/settings/__tests__/ComputerUseSection.browserHealth.test.tsx
@@ -268,6 +268,35 @@ describe('ComputerUseSection browser backend health loading', () => {
expect(toggle.getAttribute('aria-checked')).toBe('false');
});
+ it('keeps the current project read alive when a previous project save completes', async () => {
+ const save = deferred<void>();
+ const current = deferred<{ effectiveEnabled: boolean }>();
+ vi.mocked(window.electronAPI.maker.plugins.setProjectEnabled).mockReturnValue(save.promise);
+ api.getPluginState.mockImplementation(async (id: string, directory?: string) =>
+ id === 'browser' && directory === '/tmp/current'
+ ? current.promise
+ : { effectiveEnabled: id === 'browser' },
+ );
+ const { rerender } = render(<ComputerUseSection workingDir="/tmp/previous" />);
+ const toggle = (await screen.findByRole('switch', {
+ name: 'settings.computerUse.browser.toggleAria',
+ })) as HTMLButtonElement;
+ await waitFor(() => expect(toggle.disabled).toBe(false));
+ fireEvent.click(toggle);
+ await act(async () => {
+ rerender(<ComputerUseSection workingDir="/tmp/current" />);
+ });
+ await act(async () => {
+ save.resolve();
+ });
+ expect(toggle.disabled).toBe(true);
+ await act(async () => {
+ current.resolve({ effectiveEnabled: true });
+ });
+ expect(toggle.disabled).toBe(false);
+ expect(toggle.getAttribute('aria-checked')).toBe('true');
+ });
+
it('cancels pending recovery when the panel is closed', async () => {
vi.useFakeTimers();
api.getBackendState.mockRejectedValue(new Error('unavailable'));
diff --git a/apps/desktop/src/renderer/components/settings/__tests__/ComputerUseSection.driverUpdate.test.tsx b/apps/desktop/src/renderer/components/settings/__tests__/ComputerUseSection.driverUpdate.test.tsx
index 51b04df308..f3dce12057 100644
--- a/apps/desktop/src/renderer/components/settings/__tests__/ComputerUseSection.driverUpdate.test.tsx
+++ b/apps/desktop/src/renderer/components/settings/__tests__/ComputerUseSection.driverUpdate.test.tsx
@@ -23,27 +23,43 @@ const newVersion = '0.33.1';
function deferred<T>() {
let resolve!: (value: T) => void;
let reject!: (error: Error) => void;
- const promise = new Promise<T>((res, rej) => { resolve = res; reject = rej; });
+ const promise = new Promise<T>((res, rej) => {
+ resolve = res;
+ reject = rej;
+ });
return { promise, resolve, reject };
}
function driverStatus(version = oldVersion, macos = false): ComputerDriverStatus {
return {
- installed: true, version, executablePath: 'cua-driver', daemonRunning: true,
- installCommand: 'noop', docsUrl: 'https://example.invalid/docs',
+ installed: true,
+ version,
+ executablePath: 'cua-driver',
+ daemonRunning: true,
+ installCommand: 'noop',
+ docsUrl: 'https://example.invalid/docs',
permissionState: {
- platform: macos ? 'macos' : 'windows', required: macos, canGrant: macos,
+ platform: macos ? 'macos' : 'windows',
+ required: macos,
+ canGrant: macos,
status: macos ? 'granted' : 'not_required',
- accessibility: 'granted', screenRecording: 'granted', screenRecordingCapturable: 'granted',
+ accessibility: 'granted',
+ screenRecording: 'granted',
+ screenRecordingCapturable: 'granted',
},
};
}
const offer: ComputerDriverUpdateCheck = {
- currentVersion: '0.33.0', latestVersion: '0.33.1', updateAvailable: true, updating: false,
+ currentVersion: '0.33.0',
+ latestVersion: '0.33.1',
+ updateAvailable: true,
+ updating: false,
};
const upToDate: ComputerDriverUpdateCheck = {
- ...offer, currentVersion: '0.33.1', updateAvailable: false,
+ ...offer,
+ currentVersion: '0.33.1',
+ updateAvailable: false,
};
function installed(macos = false): ComputerDriverInstallResult {
return { ok: true, stdout: '', stderr: '', status: driverStatus(newVersion, macos) };
@@ -51,7 +67,8 @@ function installed(macos = false): ComputerDriverInstallResult {
function installApi(macos = false) {
const computer = {
- status: vi.fn<(...args: unknown[]) => Promise<ComputerDriverStatus>>()
+ status: vi
+ .fn<(...args: unknown[]) => Promise<ComputerDriverStatus>>()
.mockResolvedValue(driverStatus(oldVersion, macos)),
checkUpdate: vi.fn().mockResolvedValueOnce(offer).mockResolvedValue(upToDate),
updateDriver: vi.fn().mockResolvedValue(installed(macos)),
@@ -61,7 +78,9 @@ function installApi(macos = false) {
cancelPermissionGrant: vi.fn(async () => {}),
};
const setEnabled = vi.fn(async () => ({ codexMcpRefreshed: true }));
- const getState = vi.fn(async (pluginId: string) => ({ effectiveEnabled: pluginId === 'computer' }));
+ const getState = vi.fn(async (pluginId: string) => ({
+ effectiveEnabled: pluginId === 'computer',
+ }));
Object.defineProperty(window, 'electronAPI', {
configurable: true,
value: {
@@ -91,19 +110,58 @@ afterEach(() => {
});
describe('ComputerUseSection driver update completion', () => {
- it.each(['response', 'rejection'])('labels a retained offer after a failed recheck (%s)', async (failure) => {
- const { computer } = installApi();
- render(<ComputerUseSection />);
- await screen.findByText(`${updateKey}.available: ${newVersion}`);
- if (failure === 'response') computer.checkUpdate.mockResolvedValue({ ...offer, checkStatus: 'error' });
- else computer.checkUpdate.mockRejectedValue(new Error('offline'));
- fireEvent.click(screen.getByRole('button', { name: `${updateKey}.check` }));
- await screen.findByText(`${updateKey}.checkFailed`);
- expect(screen.getByText(`${updateKey}.previouslyAvailable: ${newVersion}`)).toBeTruthy();
- expect(screen.queryByText(`${updateKey}.available: ${newVersion}`)).toBeNull();
- expect((screen.getByRole('button', { name: `${updateKey}.action` }) as HTMLButtonElement).disabled).toBe(false);
- expect(screen.getByRole('button', { name: `${updateKey}.retry` })).toBeTruthy();
- });
+ // PR #7584: independent loading makes driver updates available before opt-in
+ // resolves. The switch must only become off after the backend confirms it;
+ // earlier update tests always started with the opt-in already loaded (unit).
+ it.each([false, true])(
+ 'preserves persisted opt-in while update disables a still-loading configuration (write fails: %s)',
+ async (fails) => {
+ const { computer, getState, setEnabled } = installApi(true);
+ const optIn = deferred<{ effectiveEnabled: boolean }>();
+ const disabling = deferred<{ codexMcpRefreshed: boolean }>();
+ getState.mockImplementation((id) =>
+ id === 'computer' ? optIn.promise : Promise.resolve({ effectiveEnabled: false }),
+ );
+ setEnabled.mockReturnValue(disabling.promise);
+ render(<ComputerUseSection />);
+ await screen.findByText(`${updateKey}.available: ${newVersion}`);
+ computer.status.mockRejectedValue(new Error('permission probe unavailable'));
+ await clickUpdate();
+ await waitFor(() => expect(setEnabled).toHaveBeenCalledWith('computer', false));
+ const toggle = screen.getByRole('switch', {
+ name: 'settings.computerUse.directControl.toggleAria',
+ }) as HTMLButtonElement;
+ expect(toggle.disabled).toBe(true);
+ await act(async () => {
+ if (fails) disabling.reject(new Error('write failed'));
+ else disabling.resolve({ codexMcpRefreshed: true });
+ });
+ await act(async () => {
+ optIn.resolve({ effectiveEnabled: true });
+ });
+ expect(toggle.getAttribute('aria-checked')).toBe(fails ? 'true' : 'false');
+ },
+ );
+
+ it.each(['response', 'rejection'])(
+ 'labels a retained offer after a failed recheck (%s)',
+ async (failure) => {
+ const { computer } = installApi();
+ render(<ComputerUseSection />);
+ await screen.findByText(`${updateKey}.available: ${newVersion}`);
+ if (failure === 'response')
+ computer.checkUpdate.mockResolvedValue({ ...offer, checkStatus: 'error' });
+ else computer.checkUpdate.mockRejectedValue(new Error('offline'));
+ fireEvent.click(screen.getByRole('button', { name: `${updateKey}.check` }));
+ await screen.findByText(`${updateKey}.checkFailed`);
+ expect(screen.getByText(`${updateKey}.previouslyAvailable: ${newVersion}`)).toBeTruthy();
+ expect(screen.queryByText(`${updateKey}.available: ${newVersion}`)).toBeNull();
+ expect(
+ (screen.getByRole('button', { name: `${updateKey}.action` }) as HTMLButtonElement).disabled,
+ ).toBe(false);
+ expect(screen.getByRole('button', { name: `${updateKey}.retry` })).toBeTruthy();
+ },
+ );
it('finishes local permission recovery even when the post-install network check is slow', async () => {
const { computer, setEnabled } = installApi(true);
@@ -114,12 +172,19 @@ describe('ComputerUseSection driver update completion', () => {
computer.status.mockRejectedValue(new Error('permission probe unavailable'));
await clickUpdate();
await waitFor(() => expect(setEnabled).toHaveBeenCalledWith('computer', false));
- expect(computer.status).toHaveBeenCalledWith({ forcePermissionProbe: true, freshPermissionProbe: true });
- expect(toast.warning).toHaveBeenCalledWith('settings.computerUse.directControl.toast.permissionPending');
+ expect(computer.status).toHaveBeenCalledWith({
+ forcePermissionProbe: true,
+ freshPermissionProbe: true,
+ });
+ expect(toast.warning).toHaveBeenCalledWith(
+ 'settings.computerUse.directControl.toast.permissionPending',
+ );
await screen.findByText(`${updateKey}.checking`);
expect(screen.getByText(`${versionKey}: ${newVersion}`)).toBeTruthy();
expect(screen.queryByText(`${updateKey}.updating`)).toBeNull();
- await act(async () => { check.resolve(upToDate); });
+ await act(async () => {
+ check.resolve(upToDate);
+ });
});
it('distinguishes reading the local version from checking for updates and shows the final result', async () => {
@@ -131,36 +196,52 @@ describe('ComputerUseSection driver update completion', () => {
render(<ComputerUseSection />);
await screen.findByText(`${updateKey}.readingVersion`);
expect(computer.checkUpdate).not.toHaveBeenCalled();
- await act(async () => { status.resolve(driverStatus()); });
+ await act(async () => {
+ status.resolve(driverStatus());
+ });
await screen.findByText(`${updateKey}.checking`);
expect(screen.queryByText(`${updateKey}.upToDate`)).toBeNull();
- expect((screen.getByRole('button', { name: `${updateKey}.check` }) as HTMLButtonElement).disabled).toBe(true);
- await act(async () => { check.resolve({ ...upToDate, checkStatus: 'success', checkedAt: Date.now() }); });
+ expect(
+ (screen.getByRole('button', { name: `${updateKey}.check` }) as HTMLButtonElement).disabled,
+ ).toBe(true);
+ await act(async () => {
+ check.resolve({ ...upToDate, checkStatus: 'success', checkedAt: Date.now() });
+ });
await screen.findByText(`${updateKey}.upToDate`);
expect(screen.getByText(new RegExp(`${updateKey}.lastChecked:`))).toBeTruthy();
expect(screen.queryByText(`${updateKey}.checking`)).toBeNull();
});
- it.each(['response', 'rejection'])('shows a failed check and lets retry bypass the cache (%s)', async (failure) => {
- const { computer } = installApi();
- computer.checkUpdate.mockReset();
- if (failure === 'response') {
- computer.checkUpdate.mockResolvedValueOnce({ ...offer, latestVersion: null, updateAvailable: false, checkStatus: 'error' });
- } else {
- computer.checkUpdate.mockRejectedValueOnce(new Error('offline'));
- }
- const retry = deferred<ComputerDriverUpdateCheck>();
- computer.checkUpdate.mockReturnValue(retry.promise);
- render(<ComputerUseSection />);
- await screen.findByText(`${updateKey}.checkFailed`);
- expect(screen.queryByText(`${updateKey}.upToDate`)).toBeNull();
- fireEvent.click(screen.getByRole('button', { name: `${updateKey}.retry` }));
- expect(computer.checkUpdate).toHaveBeenLastCalledWith({ force: true });
- await screen.findByText(`${updateKey}.checking`);
- await act(async () => { retry.resolve(offer); });
- await screen.findByText(`${updateKey}.available: ${newVersion}`);
- expect(screen.queryByText(`${updateKey}.checkFailed`)).toBeNull();
- });
+ it.each(['response', 'rejection'])(
+ 'shows a failed check and lets retry bypass the cache (%s)',
+ async (failure) => {
+ const { computer } = installApi();
+ computer.checkUpdate.mockReset();
+ if (failure === 'response') {
+ computer.checkUpdate.mockResolvedValueOnce({
+ ...offer,
+ latestVersion: null,
+ updateAvailable: false,
+ checkStatus: 'error',
+ });
+ } else {
+ computer.checkUpdate.mockRejectedValueOnce(new Error('offline'));
+ }
+ const retry = deferred<ComputerDriverUpdateCheck>();
+ computer.checkUpdate.mockReturnValue(retry.promise);
+ render(<ComputerUseSection />);
+ await screen.findByText(`${updateKey}.checkFailed`);
+ expect(screen.queryByText(`${updateKey}.upToDate`)).toBeNull();
+ fireEvent.click(screen.getByRole('button', { name: `${updateKey}.retry` }));
+ expect(computer.checkUpdate).toHaveBeenLastCalledWith({ force: true });
+ await screen.findByText(`${updateKey}.checking`);
+ await act(async () => {
+ retry.resolve(offer);
+ });
+ await screen.findByText(`${updateKey}.available: ${newVersion}`);
+ expect(screen.queryByText(`${updateKey}.checkFailed`)).toBeNull();
+ },
+ );
it('keeps manual checking available when up to date and displays a newly found update', async () => {
const { computer } = installApi();
@@ -176,14 +257,19 @@ describe('ComputerUseSection driver update completion', () => {
const { computer, getState } = installApi();
const optIn = deferred<{ effectiveEnabled: boolean }>();
const check = deferred<ComputerDriverUpdateCheck>();
- getState.mockImplementation((pluginId) => pluginId === 'computer'
- ? optIn.promise : Promise.resolve({ effectiveEnabled: false }));
+ getState.mockImplementation((pluginId) =>
+ pluginId === 'computer' ? optIn.promise : Promise.resolve({ effectiveEnabled: false }),
+ );
computer.checkUpdate.mockReset().mockReturnValue(check.promise);
render(<ComputerUseSection />);
await waitFor(() => expect(computer.checkUpdate).toHaveBeenCalledOnce());
- await act(async () => { optIn.resolve({ effectiveEnabled: true }); });
+ await act(async () => {
+ optIn.resolve({ effectiveEnabled: true });
+ });
computer.checkUpdate.mockResolvedValue(upToDate);
- await act(async () => { check.resolve({ ...offer, updating: true }); });
+ await act(async () => {
+ check.resolve({ ...offer, updating: true });
+ });
await screen.findByText(`${versionKey}: ${newVersion}`);
expect(computer.updateDriver).toHaveBeenCalledExactlyOnceWith({ joinOnly: true });
expect(screen.queryByRole('button', { name: `${updateKey}.action` })).toBeNull();
@@ -199,24 +285,29 @@ describe('ComputerUseSection driver update completion', () => {
expect(screen.queryByRole('button', { name: `${updateKey}.action` })).toBeNull();
});
- it.each([true, false])('refreshes actual state after an installer error (binary replaced: %s)', async (replaced) => {
- const { computer } = installApi();
- computer.updateDriver.mockRejectedValue(new Error('installer cleanup failed'));
- render(<ComputerUseSection />);
- await screen.findByText(`${versionKey}: ${oldVersion}`);
- computer.status.mockResolvedValue(driverStatus(replaced ? newVersion : oldVersion));
- computer.checkUpdate.mockResolvedValue(replaced ? upToDate : offer);
- await clickUpdate();
- await waitFor(() => expect(computer.status).toHaveBeenCalledWith({ skipPermissionProbe: true }));
- await waitFor(() => expect(computer.checkUpdate).toHaveBeenCalledTimes(2));
- await screen.findByText(`${versionKey}: ${replaced ? newVersion : oldVersion}`);
- await waitFor(() => {
- const button = screen.queryByRole('button', { name: `${updateKey}.action` });
- if (replaced) expect(button).toBeNull();
- else expect((button as HTMLButtonElement).disabled).toBe(false);
- });
- expect(toast.success).not.toHaveBeenCalled();
- });
+ it.each([true, false])(
+ 'refreshes actual state after an installer error (binary replaced: %s)',
+ async (replaced) => {
+ const { computer } = installApi();
+ computer.updateDriver.mockRejectedValue(new Error('installer cleanup failed'));
+ render(<ComputerUseSection />);
+ await screen.findByText(`${versionKey}: ${oldVersion}`);
+ computer.status.mockResolvedValue(driverStatus(replaced ? newVersion : oldVersion));
+ computer.checkUpdate.mockResolvedValue(replaced ? upToDate : offer);
+ await clickUpdate();
+ await waitFor(() =>
+ expect(computer.status).toHaveBeenCalledWith({ skipPermissionProbe: true }),
+ );
+ await waitFor(() => expect(computer.checkUpdate).toHaveBeenCalledTimes(2));
+ await screen.findByText(`${versionKey}: ${replaced ? newVersion : oldVersion}`);
+ await waitFor(() => {
+ const button = screen.queryByRole('button', { name: `${updateKey}.action` });
+ if (replaced) expect(button).toBeNull();
+ else expect((button as HTMLButtonElement).disabled).toBe(false);
+ });
+ expect(toast.success).not.toHaveBeenCalled();
+ },
+ );
it('publishes the new version before a slow permission check and reports its failure separately', async () => {
const { computer, setEnabled } = installApi(true);
@@ -227,10 +318,14 @@ describe('ComputerUseSection driver update completion', () => {
await clickUpdate();
await screen.findByText(`${versionKey}: ${newVersion}`);
expect(screen.queryByRole('button', { name: `${updateKey}.action` })).toBeNull();
- await act(async () => { permissions.reject(new Error('permission probe failed')); });
- await waitFor(() => expect(toast.warning).toHaveBeenCalledWith(
- 'settings.computerUse.directControl.toast.permissionPending',
- ));
+ await act(async () => {
+ permissions.reject(new Error('permission probe failed'));
+ });
+ await waitFor(() =>
+ expect(toast.warning).toHaveBeenCalledWith(
+ 'settings.computerUse.directControl.toast.permissionPending',
+ ),
+ );
expect(toast.error).not.toHaveBeenCalled();
expect(setEnabled).toHaveBeenCalledWith('computer', false);
expect(screen.getByText(`${versionKey}: ${newVersion}`)).toBeTruthy();
@@ -242,7 +337,9 @@ describe('ComputerUseSection driver update completion', () => {
render(<ComputerUseSection />);
await screen.findByText(`${versionKey}: ${oldVersion}`);
computer.status.mockResolvedValue({
- ...driverStatus(newVersion, true), installed: false, version: null,
+ ...driverStatus(newVersion, true),
+ installed: false,
+ version: null,
permissionState: { platform: 'macos', required: true, canGrant: true, status: 'unknown' },
});
await clickUpdate();
@@ -251,26 +348,31 @@ describe('ComputerUseSection driver update completion', () => {
expect(toast.error).not.toHaveBeenCalled();
});
- it.each([true, false])('joins the existing update after reopening (installer succeeds: %s)', async (succeeds) => {
- const { computer } = installApi();
- const installation = deferred<ComputerDriverInstallResult>();
- computer.updateDriver.mockReturnValue(installation.promise);
- const first = render(<ComputerUseSection />);
- await clickUpdate();
- first.unmount();
- computer.checkUpdate.mockResolvedValue({ ...offer, updating: true });
- render(<ComputerUseSection />);
- await waitFor(() => expect(computer.updateDriver).toHaveBeenLastCalledWith({ joinOnly: true }));
- computer.status.mockResolvedValue(driverStatus(newVersion));
- computer.checkUpdate.mockResolvedValue(upToDate);
- await act(async () => {
- if (succeeds) installation.resolve(installed());
- else installation.reject(new Error('installer cleanup failed'));
- });
- await screen.findByText(`${versionKey}: ${newVersion}`);
- expect(computer.updateDriver.mock.calls).toEqual([[undefined], [{ joinOnly: true }]]);
- expect(screen.queryByRole('button', { name: `${updateKey}.action` })).toBeNull();
- expect(toast.success).toHaveBeenCalledTimes(succeeds ? 1 : 0);
- expect(toast.error).toHaveBeenCalledTimes(succeeds ? 0 : 1);
- });
+ it.each([true, false])(
+ 'joins the existing update after reopening (installer succeeds: %s)',
+ async (succeeds) => {
+ const { computer } = installApi();
+ const installation = deferred<ComputerDriverInstallResult>();
+ computer.updateDriver.mockReturnValue(installation.promise);
+ const first = render(<ComputerUseSection />);
+ await clickUpdate();
+ first.unmount();
+ computer.checkUpdate.mockResolvedValue({ ...offer, updating: true });
+ render(<ComputerUseSection />);
+ await waitFor(() =>
+ expect(computer.updateDriver).toHaveBeenLastCalledWith({ joinOnly: true }),
+ );
+ computer.status.mockResolvedValue(driverStatus(newVersion));
+ computer.checkUpdate.mockResolvedValue(upToDate);
+ await act(async () => {
+ if (succeeds) installation.resolve(installed());
+ else installation.reject(new Error('installer cleanup failed'));
+ });
+ await screen.findByText(`${versionKey}: ${newVersion}`);
+ expect(computer.updateDriver.mock.calls).toEqual([[undefined], [{ joinOnly: true }]]);
+ expect(screen.queryByRole('button', { name: `${updateKey}.action` })).toBeNull();
+ expect(toast.success).toHaveBeenCalledTimes(succeeds ? 1 : 0);
+ expect(toast.error).toHaveBeenCalledTimes(succeeds ? 0 : 1);
+ },
+ );
});
diff --git a/apps/desktop/src/renderer/components/settings/useAutomationSettingsRead.ts b/apps/desktop/src/renderer/components/settings/useAutomationSettingsRead.ts
index a1056a975b..8a65540bc7 100644
--- a/apps/desktop/src/renderer/components/settings/useAutomationSettingsRead.ts
+++ b/apps/desktop/src/renderer/components/settings/useAutomationSettingsRead.ts
@@ -17,7 +17,7 @@ export function useAutomationSettingsRead<T>(name: string, load: () => Promise<T
status: ReadStatus;
}>({ owner: load, value: null, status: 'loading' });
const [revision, setRevision] = useState(0);
- const cancelRef = useRef(() => {});
+ const cancelRef = useRef<{ owner: typeof load; cancel: () => void } | null>(null);
useEffect(() => {
let cancelled = false;
@@ -27,7 +27,7 @@ export function useAutomationSettingsRead<T>(name: string, load: () => Promise<T
cancelled = true;
clearTimeout(timer);
};
- cancelRef.current = cancel;
+ cancelRef.current = { owner: load, cancel };
setState({ owner: load, value: null, status: 'loading' });
const run = (isRetry: boolean) => {
@@ -52,11 +52,15 @@ export function useAutomationSettingsRead<T>(name: string, load: () => Promise<T
}, fail);
};
run(false);
- return cancel;
+ return () => {
+ cancel();
+ if (cancelRef.current?.cancel === cancel) cancelRef.current = null;
+ };
}, [load, name, revision]);
const retry = useCallback(() => {
- cancelRef.current();
+ if (cancelRef.current?.owner !== load) return;
+ cancelRef.current.cancel();
setState({ owner: load, value: null, status: 'loading' });
setRevision((current) => current + 1);
}, [load]);
@@ -65,17 +69,22 @@ export function useAutomationSettingsRead<T>(name: string, load: () => Promise<T
// or scheduled retry must not revert it.
const setValue = useCallback(
(next: SetStateAction<T | null>) => {
- cancelRef.current();
- setState((current) => ({
- owner: load,
- value:
- typeof next === 'function'
- ? (next as (previous: T | null) => T | null)(
- current.owner === load ? current.value : null,
- )
- : next,
- status: 'ready',
- }));
+ // A previous project's save can settle after this hook has a new loader.
+ // It must neither cancel the current read nor publish the old ownership.
+ if (cancelRef.current?.owner !== load) return;
+ cancelRef.current.cancel();
+ setState((current) =>
+ current.owner !== load
+ ? current
+ : {
+ owner: load,
+ value:
+ typeof next === 'function'
+ ? (next as (previous: T | null) => T | null)(current.value)
+ : next,
+ status: 'ready',
+ },
+ );
},
[load],
);
diff --git a/docs/design-rules/design-inventory.md b/docs/design-rules/design-inventory.md
index 72ba0aad89..4e7b35c776 100644
--- a/docs/design-rules/design-inventory.md
+++ b/docs/design-rules/design-inventory.md
@@ -38,7 +38,7 @@
| `desktop.overlay.toast` | desktop | Toast | App 常驻 ToastContainer(用户可见出口,不展开业务逻辑) | Toast, ToastContainer | apps/desktop/src/renderer/components/ui/toast/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/ImConnectionRecovery.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/ModelCompactionSettings.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/ProviderAccountUsageModule.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 | 552 |
+| `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/ImConnectionRecovery.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/ModelCompactionSettings.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/ProviderAccountUsageModule.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/useAutomationSettingsRead.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 | 552 |
| `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/MailParticipant.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 | 199 |
| `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 |