Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
fix(desktop): 恢复模型列表初始化失败后的重试与错误提示 (#4589)
Lizi11a380099a4e
diff --git a/apps/desktop/src/renderer/App.tsx b/apps/desktop/src/renderer/App.tsxindex ed10600de8..eb5ae6504d 100644--- a/apps/desktop/src/renderer/App.tsx+++ b/apps/desktop/src/renderer/App.tsx@@ -47,6 +47,7 @@ import { installCcMgrUpgradeListener } from '@/state/ccMgrUpgradeStore';import {preloadLocalCatalogSnapshot,refreshLocalCatalogSnapshot,+ startLocalCatalogRecovery,} from '@/lib/localCatalogSnapshot';import { useResyncAgentIslandSettingsAfterLogin } from '@/hooks/useAgentIslandSettings';import {@@ -177,6 +178,7 @@ function MakerBootstrap() {}, [dataOwnerId, dataOwnerRecoveryEpoch]);useEffect(() => {+ const stopCatalogRecovery = startLocalCatalogRecovery();makerChatStore.syncActiveTurnsFromMain();// main 先提交 active catalog + capabilities 再广播;renderer 收到任一目录/鉴权变化后// 联合重拉 providers 与两份 capabilities,整组成功且代际最新时才切换。@@ -186,6 +188,7 @@ function MakerBootstrap() {const offAuth = window.electronAPI.maker.auth.onStateChanged(refresh);const offProviders = window.electronAPI.maker.onProvidersChanged(refresh);return () => {+ stopCatalogRecovery();offAuth?.();offProviders?.();};diff --git a/apps/desktop/src/renderer/__tests__/localCatalogSnapshot.test.ts b/apps/desktop/src/renderer/__tests__/localCatalogSnapshot.test.tsindex 16472cc352..728e1ade1d 100644--- a/apps/desktop/src/renderer/__tests__/localCatalogSnapshot.test.ts+++ b/apps/desktop/src/renderer/__tests__/localCatalogSnapshot.test.ts@@ -1,6 +1,5 @@import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';import type { ProviderView } from '@cindy/model-providers';-import { setDataOwnerGeneration } from '@/contexts/dataOwnerGeneration';const mocks = vi.hoisted(() => ({beginCapabilities: vi.fn(),@@ -13,6 +12,8 @@ const mocks = vi.hoisted(() => ({providersCurrent: vi.fn(),loadProviders: vi.fn(),initializeVisibility: vi.fn(),+ initializationFailure: vi.fn(),+ cachedProviders: vi.fn(),warn: vi.fn(),}));@@ -27,6 +28,7 @@ vi.mock('@/lib/providersSnapshotStore', () => ({beginProvidersRefresh: mocks.beginProviders,commitProvidersSnapshot: mocks.commitProviders,failProvidersRefresh: mocks.failProviders,+ getCachedProvidersSnapshot: mocks.cachedProviders,isProvidersRefreshCurrent: mocks.providersCurrent,loadProvidersSnapshot: mocks.loadProviders,}));@@ -37,9 +39,12 @@ vi.mock('@/lib/logger', () => ({vi.mock('@/state/modelVisibilityPrefs', () => ({migrateModelVisibilityDefaults: mocks.initializeVisibility,+ getModelVisibilityInitializationFailure: mocks.initializationFailure,}));-import { preloadLocalCatalogSnapshot, refreshLocalCatalogSnapshot } from '@/lib/localCatalogSnapshot';+import { preloadLocalCatalogSnapshot, refreshLocalCatalogSnapshot, startLocalCatalogRecovery } from '@/lib/localCatalogSnapshot';+import { getDataOwnerGeneration, setDataOwnerGeneration } from '@/contexts/dataOwnerGeneration';+import { getLocalCatalogFailure, setLocalCatalogFailure } from '@/lib/localCatalogLoadState';function deferred<T>() {let resolve!: (value: T) => void;@@ -51,6 +56,158 @@ function deferred<T>() {return { promise, resolve, reject };}+describe('local catalog recovery lifecycle', () => {+ let stop: () => void;+ let events: EventTarget;+ const snapshot = { dataOwnerId: 'owner-a', ownerGeneration: 7, providers: [], providerOrder: [] };++ beforeEach(() => {+ vi.useFakeTimers({ toFake: ['setTimeout', 'clearTimeout', 'setInterval', 'clearInterval'] });+ vi.clearAllMocks();+ setDataOwnerGeneration('owner-a', 7);+ setLocalCatalogFailure(getDataOwnerGeneration(), null);+ mocks.beginProviders.mockReturnValue(1);+ mocks.beginCapabilities.mockReturnValue(1);+ mocks.providersCurrent.mockReturnValue(true);+ mocks.capabilitiesCurrent.mockReturnValue(true);+ mocks.loadProviders.mockResolvedValue(snapshot);+ mocks.loadCapabilities.mockResolvedValue([]);+ mocks.initializeVisibility.mockResolvedValue(false);+ mocks.initializationFailure.mockReturnValue('legacy-busy');+ mocks.cachedProviders.mockReturnValue(null);+ events = new EventTarget();+ vi.stubGlobal('window', events);+ vi.stubGlobal('document', Object.assign(new EventTarget(), { visibilityState: 'visible' }));+ stop = startLocalCatalogRecovery();+ });++ afterEach(() => {+ stop();+ setLocalCatalogFailure(getDataOwnerGeneration(), null);+ setDataOwnerGeneration(null, 0);+ vi.restoreAllMocks();+ vi.unstubAllGlobals();+ vi.useRealTimers();+ });++ it('recovers after the three startup attempts without another catalog event, preserving legacy off switches', async () => {+ const legacyKey = 'xdt:modelVisibilityPrefs:v1';+ const legacy = JSON.stringify({ 'pi:xd:hidden': false });+ const saved = new Map<string, string>([[legacyKey, legacy]]);+ const storage = {+ getItem: (key: string) => saved.get(key) ?? null,+ setItem: (key: string, value: string) => { saved.set(key, value); },+ removeItem: (key: string) => { saved.delete(key); },+ };+ let exclusive = false;+ const sync = vi.fn(async () => undefined);+ Object.assign(events, { localStorage: storage, electronAPI: { maker: {+ syncModelVisibility: sync,+ claimLegacyModelVisibilityOwner: () => ({ dataOwnerId: 'owner-a', ownerGeneration: 7,+ canWriteOwnerScoped: true, claimed: true, claimedByOtherOwner: false,+ canInitialize: exclusive, profileOrigin: 'existing' }),+ } } });+ vi.stubGlobal('localStorage', storage);+ vi.stubGlobal('navigator', { locks: { request: async (_key: string, run: () => boolean) => run() } });+ vi.resetModules();+ const prefs = await vi.importActual<typeof import('@/state/modelVisibilityPrefs')>('@/state/modelVisibilityPrefs');+ const models = Array.from({ length: 29 }, (_,i) => ({ id: i === 0 ? 'hidden' : `model-${i}`, defaultEnabled: true }));+ const provider = { id: 'xd', agents: ['pi'], routing: {}, models: { pi: models } } as unknown as ProviderView;+ const catalog = { ...snapshot, providers: [provider] };+ mocks.loadProviders.mockResolvedValue(catalog);+ mocks.initializeVisibility.mockImplementation(prefs.migrateModelVisibilityDefaults);+ mocks.initializationFailure.mockImplementation(prefs.getModelVisibilityInitializationFailure);+ try {+ await prefs.setModelVisibilityOwner('owner-a', 7, 'cloud');+ const preload = preloadLocalCatalogSnapshot();+ await vi.advanceTimersByTimeAsync(1_000);+ await preload;+ expect(mocks.loadProviders).toHaveBeenCalledTimes(3);+ expect(mocks.commitProviders).not.toHaveBeenCalled();+ expect(getLocalCatalogFailure()?.reason).toBe('legacy-busy');+ await vi.advanceTimersByTimeAsync(2_000);+ expect(mocks.loadProviders).toHaveBeenCalledTimes(4);+ exclusive = true;+ await vi.advanceTimersByTimeAsync(5_000);+ expect(mocks.commitProviders).toHaveBeenCalledExactlyOnceWith(1, catalog);+ expect(prefs.isModelEnabled('pi', 'xd', models[0]!)).toBe(false);+ expect(prefs.isModelEnabled('pi', 'xd', models[1]!)).toBe(true);+ expect(saved.get(legacyKey)).toBe(legacy);+ expect(getLocalCatalogFailure()).toBeNull();+ expect(vi.getTimerCount()).toBe(0);+ } finally { prefs.__resetForTest(); }+ });++ it('bounds automatic retries and recovers when the user returns after fixing storage', async () => {+ mocks.initializationFailure.mockReturnValue('storage-quota');+ await refreshLocalCatalogSnapshot();+ await vi.advanceTimersByTimeAsync(300_000);+ expect(mocks.loadProviders).toHaveBeenCalledTimes(6);+ expect(mocks.commitProviders).not.toHaveBeenCalled();+ expect(getLocalCatalogFailure()?.reason).toBe('storage-quota');+ mocks.initializeVisibility.mockResolvedValue(true);+ events.dispatchEvent(new Event('focus'));+ await vi.advanceTimersByTimeAsync(0);+ expect(mocks.commitProviders).toHaveBeenCalledOnce();+ expect(getLocalCatalogFailure()).toBeNull();+ expect(vi.getTimerCount()).toBe(0);+ });++ it('does not keep retrying corrupt preferences but allows an explicit retry after repair', async () => {+ mocks.initializationFailure.mockReturnValue('preferences-corrupt');+ await refreshLocalCatalogSnapshot();+ await vi.advanceTimersByTimeAsync(300_000);+ expect(mocks.loadProviders).toHaveBeenCalledOnce();+ expect(getLocalCatalogFailure()?.reason).toBe('preferences-corrupt');+ mocks.initializeVisibility.mockResolvedValue(true);+ await expect(refreshLocalCatalogSnapshot()).resolves.toBe(true);+ expect(getLocalCatalogFailure()).toBeNull();+ });++ it('does not carry a failed account retry or error across an owner generation change', async () => {+ await refreshLocalCatalogSnapshot();+ setDataOwnerGeneration('owner-b', 8);+ expect(getLocalCatalogFailure()).toBeNull();+ await vi.advanceTimersByTimeAsync(60_000);+ expect(mocks.loadProviders).toHaveBeenCalledOnce();+ mocks.initializeVisibility.mockResolvedValue(true);+ mocks.loadProviders.mockResolvedValue({ ...snapshot, dataOwnerId: 'owner-b', ownerGeneration: 8 });+ events.dispatchEvent(new Event('focus'));+ await vi.advanceTimersByTimeAsync(0);+ expect(mocks.commitProviders).toHaveBeenCalledOnce();+ });++ it('stops an old preload instead of spending its remaining attempts in a different account', async () => {+ const preload = preloadLocalCatalogSnapshot();+ await vi.advanceTimersByTimeAsync(0);+ setDataOwnerGeneration('owner-b', 8);+ await vi.advanceTimersByTimeAsync(60_000);+ await preload;+ expect(mocks.loadProviders).toHaveBeenCalledOnce();+ expect(mocks.commitProviders).not.toHaveBeenCalled();+ });++ it('retries a snapshot invalidated only by an independent capability refresh', async () => {+ mocks.capabilitiesCurrent.mockReturnValue(false);+ await refreshLocalCatalogSnapshot();+ mocks.capabilitiesCurrent.mockReturnValue(true);+ mocks.initializeVisibility.mockResolvedValue(true);+ await vi.advanceTimersByTimeAsync(2_000);+ expect(mocks.commitProviders).toHaveBeenCalledOnce();+ });++ it('removes retry timers and window listeners when the owning UI is disposed', async () => {+ await refreshLocalCatalogSnapshot();+ stop();+ stop = () => {};+ events.dispatchEvent(new Event('focus'));+ events.dispatchEvent(new Event('online'));+ await vi.advanceTimersByTimeAsync(300_000);+ expect(mocks.loadProviders).toHaveBeenCalledOnce();+ expect(vi.getTimerCount()).toBe(0);+ });+});+describe('refreshLocalCatalogSnapshot', () => {beforeEach(() => {vi.clearAllMocks();@@ -63,6 +220,9 @@ describe('refreshLocalCatalogSnapshot', () => {mocks.commitProviders.mockReturnValue(true);mocks.commitCapabilities.mockReturnValue(true);mocks.initializeVisibility.mockResolvedValue(true);+ mocks.initializationFailure.mockReturnValue(null);+ setDataOwnerGeneration(null, 0);+ setLocalCatalogFailure(getDataOwnerGeneration(), null);});afterEach(() => {@@ -90,6 +250,7 @@ describe('refreshLocalCatalogSnapshot', () => {expect(mocks.commitProviders).not.toHaveBeenCalled();expect(mocks.commitCapabilities).not.toHaveBeenCalled();expect(mocks.warn).toHaveBeenCalledOnce();+ expect(mocks.failProviders).toHaveBeenCalledWith(1);});it('waits for sibling reads after a failure before starting the trailing round', async () => {@@ -231,6 +392,7 @@ describe('refreshLocalCatalogSnapshot', () => {mocks.loadProviders.mockResolvedValue(snapshot);mocks.loadCapabilities.mockResolvedValue([]);mocks.initializeVisibility.mockImplementation(prefs.migrateModelVisibilityDefaults);+ mocks.initializationFailure.mockImplementation(prefs.getModelVisibilityInitializationFailure);await expect(refreshLocalCatalogSnapshot()).resolves.toBe(true);expect(mocks.commitProviders).toHaveBeenCalledWith(expect.anything(), snapshot);expect(prefs.isModelEnabled('pi', 'xd', { id: 'recommended', defaultEnabled: true })).toBe(true);@@ -296,6 +458,7 @@ describe('refreshLocalCatalogSnapshot', () => {mocks.loadProviders.mockResolvedValue(providers);mocks.loadCapabilities.mockResolvedValue([['pi', { availableModels: provider.models.pi }]]);mocks.initializeVisibility.mockImplementation(prefs.migrateModelVisibilityDefaults);+ mocks.initializationFailure.mockImplementation(prefs.getModelVisibilityInitializationFailure);rejectWrite = failure === 'storage';rejectLock = failure === 'lock';const preload = preloadLocalCatalogSnapshot();diff --git a/apps/desktop/src/renderer/__tests__/modelSelectorProviderGroups.test.tsx b/apps/desktop/src/renderer/__tests__/modelSelectorProviderGroups.test.tsxindex 98e6cebe0a..d9260748bb 100644--- a/apps/desktop/src/renderer/__tests__/modelSelectorProviderGroups.test.tsx+++ b/apps/desktop/src/renderer/__tests__/modelSelectorProviderGroups.test.tsx@@ -223,10 +223,12 @@ const providersRef = vi.hoisted(() => {},},] as unknown[];- return { DEFAULT_PROVIDERS, providers: DEFAULT_PROVIDERS, loading: false, loadFailed: false };+ return { DEFAULT_PROVIDERS, providers: DEFAULT_PROVIDERS, loading: false, loadFailed: false,+ error: null as { reason: 'legacy-busy' } | null, refetch: vi.fn(async () => true) };});vi.mock('@/hooks/useProviders', () => ({- useProviders: () => ({ providers: providersRef.providers, providerOrder: [], loading: providersRef.loading, loadFailed: providersRef.loadFailed }),+ useProviders: () => ({ providers: providersRef.providers, providerOrder: [],+ loading: providersRef.loading, loadFailed: providersRef.loadFailed, error: providersRef.error, refetch: providersRef.refetch }),}));vi.mock('@/hooks/useDeviceProviders', () => ({@@ -282,6 +284,8 @@ beforeEach(() => {providersRef.providers = providersRef.DEFAULT_PROVIDERS;providersRef.loading = false;providersRef.loadFailed = false;+ providersRef.error = null;+ providersRef.refetch.mockClear();modelAccessState.accountTier = null;visibleModelsRef.models = [];(window as unknown as { electronAPI: unknown }).electronAPI = {@@ -562,6 +566,52 @@ async function waitForSearchInputFocus(): Promise<HTMLElement> {}describe('ModelSelector provider groups', () => {+ it.each([false, true])('offers recovery instead of an empty local catalog (unified=%s)', async (unifiedPanel) => {+ providersRef.providers = [];+ providersRef.loading = true;+ providersRef.error = { reason: 'legacy-busy' };+ renderSelector({ unifiedPanel });+ await openDropdown();+ expect(screen.getByRole('status').textContent).toContain('catalogRecovery.legacy');+ await act(async () => {+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.catalogRecovery.retry' }));+ });+ expect(providersRef.refetch).toHaveBeenCalledOnce();+ });++ it('retains the usable local list when a subsequent refresh fails', async () => {+ providersRef.error = { reason: 'legacy-busy' };+ renderSelector();+ await openDropdown();+ expect(screen.getByRole('status').textContent).toContain('catalogRecovery.legacy');+ expect(screen.getAllByRole('option').length).toBeGreaterThan(0);+ });++ it('keeps classic-picker recovery visible when the snapshot has no connected source for the current engine', async () => {+ providersRef.providers = [{+ id: 'gemini', name: 'Gemini', source: 'builtin', connected: true,+ agents: [], models: {}, auth: { method: 'api-key' },+ }];+ providersRef.error = { reason: 'legacy-busy' };+ renderSelector({ onNavigateToProviders: vi.fn() });+ await openDropdown();+ expect(screen.getByRole('status').textContent).toContain('catalogRecovery.legacy');+ expect(screen.getByRole('button', { name: 'newChat.modelSelector.source.connectCta' })).toBeTruthy();+ await act(async () => {+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.catalogRecovery.retry' }));+ });+ expect(providersRef.refetch).toHaveBeenCalledOnce();+ });++ it('never presents the local recovery action in a remote device picker', async () => {+ providersRef.loading = true;+ providersRef.error = { reason: 'legacy-busy' };+ renderSelector({ deviceId: 'remote-device' });+ await openDropdown();+ expect(screen.queryByText('settings.providers.catalogRecovery.legacy')).toBeNull();+ expect(screen.queryByRole('button', { name: 'settings.providers.catalogRecovery.retry' })).toBeNull();+ });+it('offers source navigation with only a connected media provider and no chat candidates', async () => {providersRef.providers = [{id: 'gemini', name: 'Gemini', source: 'builtin', connected: true,diff --git a/apps/desktop/src/renderer/__tests__/modelVisibilityPrefs.test.ts b/apps/desktop/src/renderer/__tests__/modelVisibilityPrefs.test.tsindex e358dab3a9..397d8414cb 100644--- a/apps/desktop/src/renderer/__tests__/modelVisibilityPrefs.test.ts+++ b/apps/desktop/src/renderer/__tests__/modelVisibilityPrefs.test.ts@@ -143,6 +143,167 @@ describe('shared origin readiness', () => {});});+describe('initialization failure diagnostics', () => {+ afterEach(() => vi.restoreAllMocks());++ it('reports damaged owner preferences even after legacy migration completed', async () => {+ ownerClaim.profileOrigin = 'existing';+ const key = 'xdt:modelVisibilityPrefs:v1.owner.owner-a';+ memStorage.setItem('xdt:modelVisibilityPrefs:v1.migration-complete.owner.owner-a', '1');+ memStorage.setItem(key, '{ damaged owner preferences');+ const prefs = await loadModuleForOwner();+ expect(await prefs.migrateModelVisibilityDefaults('owner-a', 1, [])).toBe(false);+ expect(prefs.getModelVisibilityInitializationFailure('owner-a', 1)).toBe('preferences-corrupt');+ expect(memStorage.getItem(key)).toBe('{ damaged owner preferences');+ memStorage.setItem(key, JSON.stringify({ 'pi:xd:kept-off': false }));+ expect(await prefs.migrateModelVisibilityDefaults('owner-a', 1, [])).toBe(true);+ expect(prefs.isModelEnabled('pi', 'xd', { id: 'kept-off', defaultEnabled: true })).toBe(false);+ });++ it('删除损坏的 owner 偏好后,同一生命周期内重新加载可恢复目录', async () => {+ ownerClaim.profileOrigin = 'existing';+ const key = 'xdt:modelVisibilityPrefs:v1.owner.owner-a';+ memStorage.setItem('xdt:modelVisibilityPrefs:v1.migration-complete.owner.owner-a', '1');+ memStorage.setItem(key, '{ damaged owner preferences');+ const prefs = await loadModuleForOwner();+ const catalog = {+ id: 'xd', agents: ['pi'], routing: {},+ models: { pi: [{ id: 'recovered', defaultEnabled: true }] },+ } as unknown as ProviderView;++ expect(await prefs.migrateModelVisibilityDefaults('owner-a', 1, [catalog])).toBe(false);+ expect(prefs.getModelVisibilityInitializationFailure('owner-a', 1)).toBe('preferences-corrupt');+ expect(memStorage.getItem(key)).toBe('{ damaged owner preferences');+ expect(prefs.isModelEnabled('pi', 'xd', { id: 'recovered', defaultEnabled: true })).toBe(false);++ memStorage.removeItem(key);+ expect(await prefs.migrateModelVisibilityDefaults('owner-a', 1, [catalog])).toBe(true);+ expect(prefs.getModelVisibilityInitializationFailure('owner-a', 1)).toBeNull();+ expect(memStorage.getItem(key)).toBeNull();+ expect(prefs.isModelEnabled('pi', 'xd', { id: 'recovered', defaultEnabled: false })).toBe(false);+ expect(prefs.isModelEnabled('pi', 'xd', { id: 'recovered', defaultEnabled: true })).toBe(true);+ });++ it('保留损坏的 initialization,直到显式恢复默认后才允许目录迁移', async () => {+ ownerClaim.profileOrigin = 'existing';+ const initializationKey = 'xdt:modelVisibilityPrefs:v1.initialization.owner.owner-a';+ const mapKey = 'xdt:modelVisibilityPrefs:v1.owner.owner-a';+ const initialization = '{ damaged initialization';+ const map = JSON.stringify({ 'pi:xd:kept-off': false });+ memStorage.setItem('xdt:modelVisibilityPrefs:v1.migration-complete.owner.owner-a', '1');+ memStorage.setItem(initializationKey, initialization);+ memStorage.setItem(mapKey, map);+ const prefs = await loadModuleForOwner();+ const catalog = {+ id: 'xd', agents: ['pi'], routing: {},+ models: { pi: [{ id: 'recovered', defaultEnabled: true }] },+ } as unknown as ProviderView;++ expect(prefs.getModelVisibilityInitializationFailure('owner-a', 1)).toBe('preferences-corrupt');+ expect(await prefs.migrateModelVisibilityDefaults('owner-a', 1, [catalog])).toBe(false);+ expect(memStorage.getItem(initializationKey)).toBe(initialization);+ expect(memStorage.getItem(mapKey)).toBe(map);+ expect(prefs.getModelVisibilityInitializationFailure('owner-a', 1)).toBe('preferences-corrupt');++ expect(await prefs.resetModelVisibilities('xd', [{ agent: 'pi', modelId: 'recovered' }])).toBe(true);+ expect(prefs.getModelVisibilityInitializationFailure('owner-a', 1)).toBeNull();+ expect(JSON.parse(memStorage.getItem(initializationKey)!)).toMatchObject({+ eligibleForDefaults: false,+ followCatalogKeys: ['pi:xd:recovered'],+ });+ expect(await prefs.migrateModelVisibilityDefaults('owner-a', 1, [catalog])).toBe(true);+ expect(prefs.isModelEnabled('pi', 'xd', { id: 'recovered', defaultEnabled: false })).toBe(false);+ expect(prefs.isModelEnabled('pi', 'xd', { id: 'recovered', defaultEnabled: true })).toBe(true);+ expect(prefs.isModelEnabled('pi', 'xd', { id: 'kept-off', defaultEnabled: true })).toBe(false);+ });++ it('外部修好损坏 initialization 后,同一生命周期内重新加载可恢复目录', async () => {+ ownerClaim.profileOrigin = 'existing';+ const initializationKey = 'xdt:modelVisibilityPrefs:v1.initialization.owner.owner-a';+ const mapKey = 'xdt:modelVisibilityPrefs:v1.owner.owner-a';+ const initialization = '{ damaged initialization';+ const map = JSON.stringify({ 'pi:xd:kept-off': false });+ const repaired = JSON.stringify({+ eligibleForDefaults: false,+ defaults: {},+ scopes: [],+ followCatalogKeys: ['pi:xd:recovered'],+ });+ memStorage.setItem('xdt:modelVisibilityPrefs:v1.migration-complete.owner.owner-a', '1');+ memStorage.setItem(initializationKey, initialization);+ memStorage.setItem(mapKey, map);+ const prefs = await loadModuleForOwner();+ const catalog = {+ id: 'xd', agents: ['pi'], routing: {},+ models: { pi: [{ id: 'recovered', defaultEnabled: true }] },+ } as unknown as ProviderView;++ expect(prefs.getModelVisibilityInitializationFailure('owner-a', 1)).toBe('preferences-corrupt');+ expect(await prefs.migrateModelVisibilityDefaults('owner-a', 1, [catalog])).toBe(false);+ expect(memStorage.getItem(initializationKey)).toBe(initialization);++ memStorage.setItem(initializationKey, repaired);+ expect(await prefs.migrateModelVisibilityDefaults('owner-a', 1, [catalog])).toBe(true);+ expect(prefs.getModelVisibilityInitializationFailure('owner-a', 1)).toBeNull();+ expect(JSON.parse(memStorage.getItem(initializationKey)!)).toMatchObject({+ eligibleForDefaults: false,+ followCatalogKeys: ['pi:xd:recovered'],+ });+ expect(memStorage.getItem(mapKey)).toBe(map);+ expect(prefs.isModelEnabled('pi', 'xd', { id: 'recovered', defaultEnabled: false })).toBe(false);+ expect(prefs.isModelEnabled('pi', 'xd', { id: 'recovered', defaultEnabled: true })).toBe(true);+ expect(prefs.isModelEnabled('pi', 'xd', { id: 'kept-off', defaultEnabled: true })).toBe(false);+ });++ it('does not attribute a late lock rejection to the next account', async () => {+ let reject!: (error: Error) => void;+ const locks = new Locks();+ vi.spyOn(locks, 'request').mockImplementationOnce(() => new Promise((_resolve, fail) => { reject = fail; }));+ vi.stubGlobal('navigator', { locks });+ const prefs = await loadModule();+ const oldOwner = prefs.setModelVisibilityOwner('owner-a', 1, 'cloud');+ setOwnerClaim('owner-b', 2);+ await prefs.setModelVisibilityOwner('owner-b', 2, 'cloud');+ reject(new Error('old lock failed'));+ await oldOwner;+ expect(prefs.getModelVisibilityInitializationFailure('owner-b', 2)).toBeNull();+ });++ it('reports quota exhaustion without changing preferences or logging their contents', async () => {+ ownerClaim.profileOrigin = 'existing';+ const key = 'xdt:modelVisibilityPrefs:v1';+ const original = JSON.stringify({ 'pi:xd:private-model-name': false });+ memStorage.setItem(key, original);+ const write = vi.spyOn(memStorage, 'setItem').mockImplementation(() => {+ throw Object.assign(new Error('private storage contents'), { name: 'QuotaExceededError' });+ });+ const prefs = await loadModuleForOwner();+ expect(await prefs.migrateModelVisibilityDefaults('owner-a', 1, [])).toBe(false);+ expect(prefs.getModelVisibilityInitializationFailure('owner-a', 1)).toBe('storage-quota');+ expect(prefs.getModelVisibilityInitializationFailure('owner-b', 1)).toBeNull();+ expect(memStorage.getItem(key)).toBe(original);+ expect(JSON.stringify(logToMain.mock.calls)).not.toContain('private');+ write.mockRestore();+ expect(await prefs.migrateModelVisibilityDefaults('owner-a', 1, [])).toBe(true);+ expect(prefs.getModelVisibilityInitializationFailure('owner-a', 1)).toBeNull();+ });++ it('distinguishes damaged settings from unavailable migration ownership and retains the original bytes', async () => {+ ownerClaim.profileOrigin = 'existing';+ const key = 'xdt:modelVisibilityPrefs:v1';+ memStorage.setItem(key, '{ damaged preferences');+ const prefs = await loadModuleForOwner();+ expect(await prefs.migrateModelVisibilityDefaults('owner-a', 1, [])).toBe(false);+ expect(prefs.getModelVisibilityInitializationFailure('owner-a', 1)).toBe('preferences-corrupt');+ expect(memStorage.getItem(key)).toBe('{ damaged preferences');+ setOwnerClaim('owner-b', 2, false, false);+ await prefs.setModelVisibilityOwner('owner-b', 2, 'cloud');+ expect(await prefs.migrateModelVisibilityDefaults('owner-b', 2, [])).toBe(false);+ expect(prefs.getModelVisibilityInitializationFailure('owner-b', 2)).toBe('legacy-owner-unavailable');+ expect(prefs.getModelVisibilityInitializationFailure('owner-a', 1)).toBeNull();+ });+});+describe('local profile visibility adoption', () => {const initKey = (owner: string) => `xdt:modelVisibilityPrefs:v1.initialization.owner.${owner}`;const mapKey = (owner: string) => `xdt:modelVisibilityPrefs:v1.owner.${owner}`;diff --git a/apps/desktop/src/renderer/__tests__/providersSectionUnavailableModels.test.tsx b/apps/desktop/src/renderer/__tests__/providersSectionUnavailableModels.test.tsxindex 0eb4356758..13ab64a536 100644--- a/apps/desktop/src/renderer/__tests__/providersSectionUnavailableModels.test.tsx+++ b/apps/desktop/src/renderer/__tests__/providersSectionUnavailableModels.test.tsx@@ -37,6 +37,8 @@ const {customConnected: true,mediaReady: false,customOverride: null as ProviderView | null,+ loading: false,+ error: null as { reason: 'storage-quota' } | null,},wizardSpy: vi.fn(),}));@@ -112,7 +114,7 @@ vi.mock('@/hooks/useProviders', () => ({}return {providers:- providerSnapshotState.dataOwnerId === authState.dataOwnerId ? [...byId.values()] : [],+ providerSnapshotState.dataOwnerId === authState.dataOwnerId && !providerSnapshotState.loading ? [...byId.values()] : [],providerOrder:providerSnapshotState.dataOwnerId === authState.dataOwnerId? providerSnapshotState.order@@ -121,7 +123,8 @@ vi.mock('@/hooks/useProviders', () => ({providerSnapshotState.dataOwnerId === authState.dataOwnerId? providerSnapshotState.ownerGeneration: null,- loading: providerSnapshotState.dataOwnerId !== authState.dataOwnerId,+ loading: providerSnapshotState.dataOwnerId !== authState.dataOwnerId || providerSnapshotState.loading,+ error: providerSnapshotState.error,refetch: refetchProvidersSpy,};},@@ -211,6 +214,8 @@ beforeEach(() => {providerSnapshotState.customConnected = true;providerSnapshotState.mediaReady = false;providerSnapshotState.customOverride = null;+ providerSnapshotState.loading = false;+ providerSnapshotState.error = null;providerSnapshotState.order = ['anthropic', 'xd', 'custom'];scanResult = { detections: [] };(window as unknown as { electronAPI: unknown }).electronAPI = {@@ -230,6 +235,19 @@ afterEach(() => {});describe('ProvidersSection — 双栏管理', () => {+ it('keeps a recovery action accessible when the first complete catalog could not be published', async () => {+ providerSnapshotState.loading = true;+ providerSnapshotState.error = { reason: 'storage-quota' };+ refetchProvidersSpy.mockResolvedValue(true);+ render(<MemoryRouter><ProvidersSection /></MemoryRouter>);+ expect(screen.getByRole('status').textContent).toContain('catalogRecovery.quota');+ await act(async () => {+ fireEvent.click(screen.getByRole('button', { name: 'settings.providers.catalogRecovery.retry' }));+ });+ expect(refetchProvidersSpy).toHaveBeenCalledOnce();+ expect(screen.queryByRole('switch', { name: 'Custom model' })).toBeNull();+ });+it.each([['openrouter-existing', 'oauth', true],['openrouter-new', 'oauth', false],diff --git a/apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx b/apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsxnew file mode 100644index 0000000000..f4b5b1bf19--- /dev/null+++ b/apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx@@ -0,0 +1,48 @@+import { useState } from 'react';+import { useTranslation } from 'react-i18next';+import { Button } from '@/components/ui/button';+import type { LocalCatalogFailure, LocalCatalogFailureReason } from '@/lib/localCatalogLoadState';++const MESSAGE_KEYS: Record<LocalCatalogFailureReason, string> = {+ 'owner-pending': 'settings.providers.catalogRecovery.pending',+ 'profile-pending': 'settings.providers.catalogRecovery.pending',+ 'legacy-owner-unavailable': 'settings.providers.catalogRecovery.legacy',+ 'legacy-busy': 'settings.providers.catalogRecovery.legacy',+ 'preferences-corrupt': 'settings.providers.catalogRecovery.corrupt',+ 'storage-quota': 'settings.providers.catalogRecovery.quota',+ 'storage-unavailable': 'settings.providers.catalogRecovery.storage',+ 'lock-unavailable': 'settings.providers.catalogRecovery.storage',+ 'preferences-unavailable': 'settings.providers.catalogRecovery.pending',+ 'catalog-unavailable': 'settings.providers.catalogRecovery.catalog',+};++/** One recovery message for local pickers and provider settings; remote state stays separate. */+export function LocalModelCatalogNotice({+ failure,+ onRetry,+}: {+ failure: LocalCatalogFailure;+ onRetry: () => Promise<boolean>;+}) {+ const { t } = useTranslation();+ const [retrying, setRetrying] = useState(false);+ return (+ <div+ role="status"+ className="flex shrink-0 flex-col items-start gap-2 rounded-xl border border-[var(--border-default)] bg-[var(--surface-elevated)] p-3 text-13 leading-[1.5] text-[var(--text-secondary)]"+ >+ <p>{t(MESSAGE_KEYS[failure.reason])}</p>+ <Button+ variant="secondary"+ loading={retrying}+ onClick={() => {+ setRetrying(true);+ // The catalog coordinator owns error reporting and retains the valid snapshot.+ void onRetry().catch(() => undefined).finally(() => setRetrying(false));+ }}+ >+ {t('settings.providers.catalogRecovery.retry')}+ </Button>+ </div>+ );+}diff --git a/apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx b/apps/desktop/src/renderer/components/new-chat/ModelSelector.tsxindex 001dbbed69..2ecae4cd89 100644--- a/apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx+++ b/apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx@@ -73,6 +73,7 @@ import { useConnectedSource } from '@/hooks/useConnectedSource';import { useGatewayModelPricing, useReferenceModelPricing } from '@/hooks/useModelPricing';import { useModelAccessStatus } from '@/hooks/useModelAccessStatus';import { useProviders } from '@/hooks/useProviders';+import { LocalModelCatalogNotice } from './LocalModelCatalogNotice';import { providerDisplayName as sharedProviderDisplayName } from '@/lib/providerDisplayName';import {evictDeviceProviders,@@ -2756,6 +2757,19 @@ function ModelSelectorContentView({if (providersOverrideState && providersOverrideState.status !== 'ready') {return <RemoteModelLoadNotice status={providersOverrideState.status} onRetry={providersOverrideState.refresh} />;}++ const localCatalogNotice = !deviceId && !providersOverride && localProviders.error+ ? <LocalModelCatalogNotice failure={localProviders.error} onRetry={localProviders.refetch} /> : null;+ // 后续刷新失败时,快照里可能仍没有当前引擎的已连接来源。emptyState 不得盖住恢复提示;+ // 有引导卡时叠在下方,连接入口仍可用。+ if (localCatalogNotice && (localProviders.loading || emptyState)) {+ return (+ <div className="flex w-[320px] max-w-full flex-col">+ <div className={emptyState ? 'p-2 pb-0' : 'p-2'}>{localCatalogNotice}</div>+ {emptyState}+ </div>+ );+ }if (emptyState) return emptyState;const hasAnyModel = sections ? sections.length > 0 : (flatModels?.length ?? 0) > 0;@@ -2864,6 +2878,7 @@ function ModelSelectorContentView({aria-label={t('newChat.modelSelector.search.placeholderAll')}/></div>+ {localCatalogNotice && <div className="shrink-0 p-2">{localCatalogNotice}</div>}<UnifiedModelPaneldeviceId={deviceId}localProviderUsage={!deviceId && !providersOverride}@@ -3082,6 +3097,7 @@ function ModelSelectorContentView({</>)}{searchField}+ {localCatalogNotice}{/* 模型列表 —— 单栏;分段(供应商)或 flat。 */}<divdiff --git a/apps/desktop/src/renderer/components/new-chat/__tests__/localModelCatalogNotice.test.tsx b/apps/desktop/src/renderer/components/new-chat/__tests__/localModelCatalogNotice.test.tsxnew file mode 100644index 0000000000..ba9831a9ce--- /dev/null+++ b/apps/desktop/src/renderer/components/new-chat/__tests__/localModelCatalogNotice.test.tsx@@ -0,0 +1,26 @@+// @vitest-environment jsdom+import { act, fireEvent, render, screen, cleanup } from '@testing-library/react';+import { afterEach, describe, expect, it, vi } from 'vitest';+import { LocalModelCatalogNotice } from '../LocalModelCatalogNotice';++vi.mock('react-i18next', () => ({ useTranslation: () => ({ t: (key: string) => key }) }));+afterEach(cleanup);++describe('local catalog recovery notice', () => {+ it('explains the local failure and makes retry await the complete catalog refresh', async () => {+ let resolve!: (value: boolean) => void;+ const retry = vi.fn(() => new Promise<boolean>((done) => { resolve = done; }));+ const view = render(<LocalModelCatalogNotice failure={{ reason: 'legacy-busy' }} onRetry={retry} />);+ expect(screen.getByRole('status').textContent).toContain('catalogRecovery.legacy');+ const button = screen.getByRole('button', { name: 'settings.providers.catalogRecovery.retry' });+ fireEvent.click(button);+ fireEvent.click(button);+ expect(retry).toHaveBeenCalledOnce();+ expect((button as HTMLButtonElement).disabled).toBe(true);+ await act(async () => resolve(false));+ expect((button as HTMLButtonElement).disabled).toBe(false);+ view.rerender(<LocalModelCatalogNotice failure={{ reason: 'storage-quota' }} onRetry={retry} />);+ expect(screen.getByRole('status').textContent).toContain('catalogRecovery.quota');+ expect(screen.getByRole('status').textContent).not.toContain('remote');+ });+});diff --git a/apps/desktop/src/renderer/components/settings/ProvidersSection.tsx b/apps/desktop/src/renderer/components/settings/ProvidersSection.tsxindex ffa83fd97f..91a6494b27 100644--- a/apps/desktop/src/renderer/components/settings/ProvidersSection.tsx+++ b/apps/desktop/src/renderer/components/settings/ProvidersSection.tsx@@ -36,6 +36,7 @@ import {import { cn } from '@/lib/utils';import { useProviders } from '@/hooks/useProviders';+import { LocalModelCatalogNotice } from '@/components/new-chat/LocalModelCatalogNotice';import { isChatGptConnectionConnected, useCodexAuth } from '@/hooks/useCodexAuth';import { codexRecoveryActionKey, codexRecoveryDescriptionKey } from '@/hooks/codexAuthRecovery';import { useApiKey } from '@/hooks/useApiKey';@@ -2229,7 +2230,7 @@ export function ProvidersSection() {const { dataOwnerId } = useAuth();const { confirm } = useConfirmDialog();const confirmProviderChange = useProviderChangeConfirmation();- const { providers, providerOrder, ownerGeneration, loading, refetch } = useProviders();+ const { providers, providerOrder, ownerGeneration, loading, error: catalogError, refetch } = useProviders();// OpenAI 的 reconnect-required 是 useCodexAuth 独有状态(目录 connected 此时为 false):// 该状态下 OpenAI 行必须留在左栏,否则「重新连接」入口不可达,用户被迫从向导重发现。const codexAuth = useCodexAuth();@@ -2811,6 +2812,7 @@ export function ProvidersSection() {猜多了下方空一条(叠上外层 pb-32 就是那 128px),猜少了则溢出。设置页右栏本身已是 h-full min-h-0 的 flex 列(providers 与 import / ghosts 同属内部滚动一档),所以这里 flex-1 就是真实可用高度。min-h-0 允许小窗口收缩,左右栏各自内部滚动。 */}+ {catalogError && <LocalModelCatalogNotice failure={catalogError} onRetry={refetch} />}{!loading && (<divclassName="flex min-h-0 flex-1 overflow-hidden rounded-xl border"diff --git a/apps/desktop/src/renderer/hooks/useProviders.ts b/apps/desktop/src/renderer/hooks/useProviders.tsindex 6f7fc84286..e16e20d8e6 100644--- a/apps/desktop/src/renderer/hooks/useProviders.ts+++ b/apps/desktop/src/renderer/hooks/useProviders.ts@@ -11,11 +11,16 @@* true,IPC 返回后一次性填充)。*/-import { useCallback, useEffect, useState } from 'react';+import { useCallback, useEffect, useState, useSyncExternalStore } from 'react';import type { ProviderView } from '@cindy/model-providers';import { getDataOwnerGeneration } from '@/contexts/dataOwnerGeneration';import { refreshLocalCatalogSnapshot } from '@/lib/localCatalogSnapshot';+import {+ getLocalCatalogFailure,+ subscribeLocalCatalogFailure,+ type LocalCatalogFailure,+} from '@/lib/localCatalogLoadState';import {getCachedProvidersSnapshot,hasProvidersSnapshotLoadFailed,@@ -28,6 +33,7 @@ export interface UseProvidersReturn {providerOrder: string[];ownerGeneration: number | null;loading: boolean;+ error: LocalCatalogFailure | null;/** A refresh failed; loading still means no usable snapshot for existing readiness guards. */loadFailed: boolean;refetch: () => Promise<boolean>;@@ -46,6 +52,7 @@ export interface UseProvidersReturn {* 只缓存"快照"不缓存"是否在拉取中",故不破坏 refetch 的现有刷新语义。*/export function useProviders(): UseProvidersReturn {+ const error = useSyncExternalStore(subscribeLocalCatalogFailure, getLocalCatalogFailure, getLocalCatalogFailure);const { dataOwnerId } = getDataOwnerGeneration();const [{ snapshot }, setSnapshotState] = useState(() => ({snapshot: getCachedProvidersSnapshot(),@@ -74,6 +81,7 @@ export function useProviders(): UseProvidersReturn {providerOrder: currentSnapshot?.providerOrder ?? [],ownerGeneration: currentSnapshot?.ownerGeneration ?? null,loading: currentSnapshot == null,+ error,loadFailed: hasProvidersSnapshotLoadFailed(),refetch,};diff --git a/apps/desktop/src/renderer/i18n/locales/en/common.json b/apps/desktop/src/renderer/i18n/locales/en/common.jsonindex 00db1b35ae..c06c32366e 100644--- a/apps/desktop/src/renderer/i18n/locales/en/common.json+++ b/apps/desktop/src/renderer/i18n/locales/en/common.json@@ -1762,6 +1762,15 @@}},"providers": {+ "catalogRecovery": {+ "pending": "Model settings are not ready yet. Wait a moment, then reload the models.",+ "legacy": "Previous model settings are temporarily unavailable. Close other Cindy instances, then reload the models.",+ "corrupt": "Saved model settings could not be read. Your settings have been kept. Contact support for help recovering them.",+ "quota": "Model settings could not be saved because local storage has reached its limit. Contact support for help, then reload the models.",+ "storage": "Local model settings could not be read or saved. Reload the models; if this continues, contact support.",+ "catalog": "The model list could not be updated. Reload the models to try again.",+ "retry": "Reload Models"+ },"title": "Providers","subtitle": "The source used when picking a model. Each source offers its own models and billing, switchable per session.","import": {diff --git a/apps/desktop/src/renderer/i18n/locales/ja/common.json b/apps/desktop/src/renderer/i18n/locales/ja/common.jsonindex e09c3343ea..6cda17e1eb 100644--- a/apps/desktop/src/renderer/i18n/locales/ja/common.json+++ b/apps/desktop/src/renderer/i18n/locales/ja/common.json@@ -1762,6 +1762,15 @@}},"providers": {+ "catalogRecovery": {+ "pending": "モデル設定の準備ができていません。しばらく待ってからモデルを再読み込みしてください。",+ "legacy": "以前のモデル設定を一時的に読み込めません。他の Cindy を終了してから、モデルを再読み込みしてください。",+ "corrupt": "保存済みのモデル設定を読み込めません。元の設定は保持されています。復旧についてサポートにお問い合わせください。",+ "quota": "ローカルストレージが上限に達したため、モデル設定を保存できません。サポートにお問い合わせのうえ、モデルを再読み込みしてください。",+ "storage": "このコンピューターのモデル設定を読み込むか保存することができません。モデルを再読み込みし、問題が続く場合はサポートにお問い合わせください。",+ "catalog": "モデル一覧を更新できません。モデルを再読み込みして再試行してください。",+ "retry": "モデルを再読み込み"+ },"title": "モデルプロバイダー","subtitle": "モデルを選ぶときのソースです。各ソースは対応するモデルと課金方式を提供し、セッションごとに切り替えられます。","import": {diff --git a/apps/desktop/src/renderer/i18n/locales/ko/common.json b/apps/desktop/src/renderer/i18n/locales/ko/common.jsonindex 5beb84f7c0..7d95995dff 100644--- a/apps/desktop/src/renderer/i18n/locales/ko/common.json+++ b/apps/desktop/src/renderer/i18n/locales/ko/common.json@@ -1762,6 +1762,15 @@}},"providers": {+ "catalogRecovery": {+ "pending": "모델 설정이 아직 준비되지 않았습니다. 잠시 후 모델을 다시 불러오세요.",+ "legacy": "이전 모델 설정을 일시적으로 읽을 수 없습니다. 실행 중인 다른 Cindy를 종료한 후 모델을 다시 불러오세요.",+ "corrupt": "저장된 모델 설정을 읽을 수 없습니다. 기존 설정은 보존되어 있습니다. 복구하려면 지원팀에 문의하세요.",+ "quota": "로컬 저장소의 한도에 도달하여 모델 설정을 저장할 수 없습니다. 지원팀에 문의한 후 모델을 다시 불러오세요.",+ "storage": "이 컴퓨터의 모델 설정을 읽거나 저장할 수 없습니다. 모델을 다시 불러오고, 문제가 계속되면 지원팀에 문의하세요.",+ "catalog": "모델 목록을 업데이트할 수 없습니다. 모델을 다시 불러오세요.",+ "retry": "모델 다시 불러오기"+ },"title": "모델 제공자","subtitle": "모델을 선택할 때의 소스입니다. 각 소스는 지원하는 모델과 과금 방식을 제공하며, 세션별로 전환할 수 있습니다.","import": {diff --git a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.jsonindex 265fd6f00b..74bb8690e3 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,15 @@}},"providers": {+ "catalogRecovery": {+ "pending": "模型设置尚未就绪,请稍后重新加载模型。",+ "legacy": "旧模型设置暂时无法读取,请退出其他正在运行的 Cindy 后重新加载模型。",+ "corrupt": "已保存的模型设置无法读取。原设置已保留,请联系支持协助恢复。",+ "quota": "本机设置存储额度已满,无法保存模型设置。请联系支持处理后重新加载模型。",+ "storage": "无法读取或保存本机模型设置。请重新加载模型;若持续出现,请联系支持。",+ "catalog": "模型列表暂时无法更新,请重新加载模型。",+ "retry": "重新加载模型"+ },"title": "模型供应商","subtitle": "选择模型时的来源。每个来源提供它支持的模型与计费方式,可按任务分别切换。","import": {diff --git a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.jsonindex 90f1f5e1ca..d2f7026260 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,15 @@}},"providers": {+ "catalogRecovery": {+ "pending": "模型設定尚未就緒,請稍後重新載入模型。",+ "legacy": "舊模型設定暫時無法讀取,請結束其他正在執行的 Cindy 後重新載入模型。",+ "corrupt": "無法讀取已儲存的模型設定。原設定已保留,請聯絡支援人員協助復原。",+ "quota": "本機設定儲存額度已滿,無法儲存模型設定。請聯絡支援人員處理後重新載入模型。",+ "storage": "無法讀取或儲存本機模型設定。請重新載入模型;若持續出現,請聯絡支援人員。",+ "catalog": "模型清單暫時無法更新,請重新載入模型。",+ "retry": "重新載入模型"+ },"title": "模型供應商","subtitle": "選擇模型時的來源。每個來源提供它支援的模型與計費方式,可按任務分別切換。","import": {diff --git a/apps/desktop/src/renderer/lib/localCatalogLoadState.ts b/apps/desktop/src/renderer/lib/localCatalogLoadState.tsnew file mode 100644index 0000000000..c2dee63299--- /dev/null+++ b/apps/desktop/src/renderer/lib/localCatalogLoadState.ts@@ -0,0 +1,33 @@+import {+ isDataOwnerGenerationCurrent,+ type DataOwnerGeneration,+} from '@/contexts/dataOwnerGeneration';+import type { ModelVisibilityInitializationFailure } from '@/state/modelVisibilityPrefs';++export type LocalCatalogFailureReason = ModelVisibilityInitializationFailure+ | 'preferences-unavailable' | 'catalog-unavailable';++export interface LocalCatalogFailure {+ readonly reason: LocalCatalogFailureReason;+}++// Error state is separate from the last complete catalog: a failed refresh must+// neither erase usable models nor show another account's failure after a switch.+let failure: { owner: DataOwnerGeneration; value: LocalCatalogFailure } | null = null;+const listeners = new Set<() => void>();++export function getLocalCatalogFailure(): LocalCatalogFailure | null {+ return failure && isDataOwnerGenerationCurrent(failure.owner) ? failure.value : null;+}++export function subscribeLocalCatalogFailure(listener: () => void): () => void {+ listeners.add(listener);+ return () => { listeners.delete(listener); };+}++export function setLocalCatalogFailure(owner: DataOwnerGeneration, reason: LocalCatalogFailureReason | null): void {+ if (!isDataOwnerGenerationCurrent(owner)) return;+ if (getLocalCatalogFailure()?.reason === reason || (!failure && reason === null)) return;+ failure = reason === null ? null : { owner, value: { reason } };+ for (const listener of listeners) listener();+}diff --git a/apps/desktop/src/renderer/lib/localCatalogSnapshot.ts b/apps/desktop/src/renderer/lib/localCatalogSnapshot.tsindex acf7be2506..c682bd995b 100644--- a/apps/desktop/src/renderer/lib/localCatalogSnapshot.ts+++ b/apps/desktop/src/renderer/lib/localCatalogSnapshot.ts@@ -8,8 +8,21 @@*/import { createLogger } from '@/lib/logger';import { createCoalescedRefresh } from '@/lib/coalescedRefresh';-import { getDataOwnerGeneration } from '@/contexts/dataOwnerGeneration';-import { migrateModelVisibilityDefaults } from '@/state/modelVisibilityPrefs';+import {+ getModelVisibilityInitializationFailure,+ migrateModelVisibilityDefaults,+} from '@/state/modelVisibilityPrefs';+import {+ getDataOwnerGeneration,+ isDataOwnerGenerationCurrent,+ type DataOwnerGeneration,+} from '@/contexts/dataOwnerGeneration';+import {+ getLocalCatalogFailure,+ setLocalCatalogFailure,+ type LocalCatalogFailureReason,+} from './localCatalogLoadState';+import { extractIpcError } from '@/utils/ipcError';import {beginLocalCapabilitiesRefresh,commitLocalCapabilitiesSnapshot,@@ -20,6 +33,7 @@ import {beginProvidersRefresh,commitProvidersSnapshot,failProvidersRefresh,+ getCachedProvidersSnapshot,isProvidersRefreshCurrent,loadProvidersSnapshot,} from '@/lib/providersSnapshotStore';@@ -28,9 +42,66 @@ const log = createLogger('localCatalogSnapshot');let refreshGeneration = 0;let refreshOwner = getDataOwnerGeneration();let scheduleRefresh = createCoalescedRefresh<boolean>();+const RECOVERY_DELAYS_MS = [2_000, 5_000, 10_000, 20_000, 30_000] as const;+let recoveryTimer: ReturnType<typeof setTimeout> | undefined;+let recoveryAttempt = 0;+let recoveryOwners = 0;++function cancelRecovery(): void {+ clearTimeout(recoveryTimer);+ recoveryTimer = undefined;+}++function failed(owner: DataOwnerGeneration, reason: LocalCatalogFailureReason): void {+ if (!isDataOwnerGenerationCurrent(owner)) return;+ setLocalCatalogFailure(owner, reason);+ // Corrupt bytes need deliberate repair, not repeated writes or a reset to+ // factory defaults. Other failures receive a bounded recovery window.+ if (!recoveryOwners || reason === 'preferences-corrupt'+ || recoveryAttempt >= RECOVERY_DELAYS_MS.length) return;+ cancelRecovery();+ recoveryTimer = setTimeout(() => {+ recoveryTimer = undefined;+ if (!isDataOwnerGenerationCurrent(owner)) return;+ recoveryAttempt += 1;+ void refreshSnapshot();+ }, RECOVERY_DELAYS_MS[recoveryAttempt]);+}++/** Main-window lifecycle owns recovery. Never leave polling behind after unmount/HMR. */+export function startLocalCatalogRecovery(): () => void {+ recoveryOwners += 1;+ const retry = (): void => {+ const owner = getDataOwnerGeneration();+ const snapshot = getCachedProvidersSnapshot();+ // An owner-generation change hides the previous failure. A foreground+ // retry may still be needed if this account has no current complete snapshot.+ if (getLocalCatalogFailure() || (owner.dataOwnerId && (!snapshot+ || snapshot.ownerGeneration !== owner.generation))) void refreshLocalCatalogSnapshot();+ };+ const onVisible = (): void => {+ if (document.visibilityState === 'visible') retry();+ };+ window.addEventListener('focus', retry);+ window.addEventListener('online', retry);+ document.addEventListener('visibilitychange', onVisible);+ return () => {+ recoveryOwners -= 1;+ window.removeEventListener('focus', retry);+ window.removeEventListener('online', retry);+ document.removeEventListener('visibilitychange', onVisible);+ if (!recoveryOwners) cancelRecovery();+ };+}/** 联合刷新 providers + 可用 agent capabilities,并只提交最新的完整结果。 */export async function refreshLocalCatalogSnapshot(): Promise<boolean> {+ recoveryAttempt = 0;+ return refreshSnapshot();+}++async function refreshSnapshot(): Promise<boolean> {+ cancelRecovery();const owner = getDataOwnerGeneration();if (owner !== refreshOwner) {// A new owner must not wait for an old owner's outstanding IPC.@@ -55,11 +126,13 @@ export async function refreshLocalCatalogSnapshot(): Promise<boolean> {if (capabilitiesResult.status === 'rejected') throw capabilitiesResult.reason;const providers = providerResult.value;const capabilities = capabilitiesResult.value;- const isCurrent = (): boolean =>- refreshGeneration === generation &&- isProvidersRefreshCurrent(providersGeneration, providers) &&- isLocalCapabilitiesRefreshCurrent(capabilitiesGeneration);- if (!isCurrent()) return false;+ const isCurrent = (): boolean => refreshGeneration === generation+ && isProvidersRefreshCurrent(providersGeneration, providers)+ && isLocalCapabilitiesRefreshCurrent(capabilitiesGeneration);+ if (!isCurrent()) {+ if (refreshGeneration === generation) failed(owner, 'owner-pending');+ return false;+ }const initialized = await migrateModelVisibilityDefaults(providers.dataOwnerId,providers.ownerGeneration,@@ -68,19 +141,33 @@ export async function refreshLocalCatalogSnapshot(): Promise<boolean> {);// Failed persistence/locking must reach preload's retry loop. Waiting for another// renderer's preference write must not publish a stale catalog either.- if (!initialized || !isCurrent()) {+ if (!isCurrent()) {+ if (refreshGeneration === generation) failed(owner, 'owner-pending');failProvidersRefresh(providersGeneration);return false;}+ if (!initialized) {+ failProvidersRefresh(providersGeneration);+ failed(owner, getModelVisibilityInitializationFailure(providers.dataOwnerId, providers.ownerGeneration)+ ?? 'preferences-unavailable');+ return false;+ }// 两次提交均为同步通知;React 会把同一事件循环内的 hook 更新批处理到同一帧。commitLocalCapabilitiesSnapshot(capabilitiesGeneration, capabilities);commitProvidersSnapshot(providersGeneration, providers);+ recoveryAttempt = 0;+ setLocalCatalogFailure(owner, null);return true;} catch (error) {if (refreshGeneration === generation) {failProvidersRefresh(providersGeneration);- log.warn('local catalog snapshot refresh failed; keeping last valid snapshot', error);+ if (isDataOwnerGenerationCurrent(owner)) {+ log.warn('local catalog snapshot refresh failed; keeping last valid snapshot', {+ code: extractIpcError(error)?.code ?? 'UNKNOWN',+ });+ failed(owner, 'catalog-unavailable');+ }}return false;}@@ -89,9 +176,13 @@ export async function refreshLocalCatalogSnapshot(): Promise<boolean> {/** 启动预热保留原有三次瞬时 IPC 重试语义;每次仍按可用快照原子提交。 */export async function preloadLocalCatalogSnapshot(): Promise<void> {+ const owner = getDataOwnerGeneration();for (let attempt = 0; attempt < 3; attempt += 1) {+ if (!isDataOwnerGenerationCurrent(owner)) return;if (await refreshLocalCatalogSnapshot()) return;if (attempt < 2) await new Promise((resolve) => setTimeout(resolve, 500));}- log.warn('local catalog snapshot preload failed after 3 attempts');+ if (isDataOwnerGenerationCurrent(owner)) {+ log.warn('local catalog snapshot preload failed after 3 attempts');+ }}diff --git a/apps/desktop/src/renderer/state/modelVisibilityPrefs.ts b/apps/desktop/src/renderer/state/modelVisibilityPrefs.tsindex 0cb5f7bc33..155c4573ee 100644--- a/apps/desktop/src/renderer/state/modelVisibilityPrefs.ts+++ b/apps/desktop/src/renderer/state/modelVisibilityPrefs.ts@@ -42,6 +42,46 @@ import { createLogger } from '@/lib/logger';const log = createLogger('ModelVisibilityPrefs');+export type ModelVisibilityInitializationFailure =+ | 'owner-pending'+ | 'profile-pending'+ | 'legacy-owner-unavailable'+ | 'legacy-busy'+ | 'preferences-corrupt'+ | 'storage-quota'+ | 'storage-unavailable'+ | 'lock-unavailable';++let initializationFailure: ModelVisibilityInitializationFailure | null = null;++/** Keep diagnostics owner-scoped and never log preference contents or storage error messages. */+function recordInitializationFailure(reason: ModelVisibilityInitializationFailure): void {+ if (initializationFailure !== reason) {+ log.warn('model visibility initialization blocked', { reason });+ }+ initializationFailure = reason;+}++/** Startup profile classification is pending, rather than a storage or lock failure. */+class ProfilePendingError extends Error {}++function initializationErrorReason(+ error: unknown,+ fallback: ModelVisibilityInitializationFailure = 'storage-unavailable',+): ModelVisibilityInitializationFailure {+ if (error instanceof ProfilePendingError) return 'profile-pending';+ return error && typeof error === 'object' && 'name' in error && error.name === 'QuotaExceededError'+ ? 'storage-quota' : fallback;+}++export function getModelVisibilityInitializationFailure(+ ownerId: string | null,+ ownerGeneration: number,+): ModelVisibilityInitializationFailure | null {+ return ownerId === activeOwnerId && ownerGeneration === activeOwnerGeneration+ ? initializationFailure : null;+}+const LEGACY_STORAGE_KEY = 'xdt:modelVisibilityPrefs:v1';const STORAGE_KEY_PREFIX = `${LEGACY_STORAGE_KEY}.owner`;const INITIALIZATION_KEY_PREFIX = `${LEGACY_STORAGE_KEY}.initialization.owner`;@@ -75,6 +115,10 @@ let cache: VisibilityMap | null = null;let mapCorrupt = false;/** adopt-local 源损坏时保持 latch,不因目标 map 合法而提前清掉。 */let adoptionSourceCorrupt = false;+/** Initialization corruption is scoped to the owner generation that observed it. */+let initializationCorruptOwner: { ownerId: string; ownerGeneration: number } | null = null;+/** A corrupt local initialization must block cloud adoption until the source is repaired. */+let adoptionInitializationSourceCorrupt = false;let activeOwnerId: string | null = null;let activeOwnerGeneration = 0;let activeOwnerReadyForWrites = false;@@ -94,31 +138,65 @@ function emptyInitialization(eligibleForDefaults = false): InitializationState {return { eligibleForDefaults, defaults: {}, scopes: [], followCatalogKeys: [] };}+interface InitializationReadResult {+ state: InitializationState | null;+ corrupt: boolean;+}++function isActiveInitializationCorrupt(): boolean {+ return !!activeOwnerId+ && initializationCorruptOwner?.ownerId === activeOwnerId+ && initializationCorruptOwner.ownerGeneration === activeOwnerGeneration;+}++function latchInitializationCorruption(ownerId: string): void {+ if (ownerId !== activeOwnerId || !activeOwnerId) return;+ initializationCorruptOwner = { ownerId, ownerGeneration: activeOwnerGeneration };+ recordInitializationFailure('preferences-corrupt');+}++function clearInitializationCorruption(ownerId: string): void {+ if (ownerId !== activeOwnerId || !isActiveInitializationCorrupt()) return;+ initializationCorruptOwner = null;+}+function initializationKey(ownerId: string): string {return `${INITIALIZATION_KEY_PREFIX}.${encodeURIComponent(ownerId)}`;}-function readInitialization(ownerId: string): InitializationState | null {+function readInitialization(ownerId: string): InitializationReadResult {const raw = window.localStorage.getItem(initializationKey(ownerId));- if (raw === null) return null;+ if (raw === null) {+ // A deleted record is a successful read of current storage, not evidence of+ // the previously observed corrupt bytes. Reloading must be able to recover.+ clearInitializationCorruption(ownerId);+ return { state: null, corrupt: false };+ }try {const parsed = JSON.parse(raw);const strings = (value: unknown): string[] => Array.isArray(value)? value.filter((item): item is string => typeof item === 'string') : [];- return { eligibleForDefaults: parsed?.eligibleForDefaults === true,- defaults: sanitize(parsed?.defaults), scopes: strings(parsed?.scopes), followCatalogKeys: strings(parsed?.followCatalogKeys) };+ clearInitializationCorruption(ownerId);+ return { state: { eligibleForDefaults: parsed?.eligibleForDefaults === true,+ defaults: sanitize(parsed?.defaults), scopes: strings(parsed?.scopes), followCatalogKeys: strings(parsed?.followCatalogKeys) }, corrupt: false };} catch {- return emptyInitialization();+ latchInitializationCorruption(ownerId);+ return { state: null, corrupt: true };}}-function saveInitialization(next: InitializationState): boolean {+function saveInitialization(next: InitializationState, allowCorruptRecovery = false): boolean {if (!activeOwnerId) return false;+ if (!allowCorruptRecovery && isActiveInitializationCorrupt()) {+ recordInitializationFailure('preferences-corrupt');+ return false;+ }try {window.localStorage.setItem(initializationKey(activeOwnerId), JSON.stringify(next));initialization = next;mayInitializeDefaults = next.eligibleForDefaults;+ if (allowCorruptRecovery && isActiveInitializationCorrupt()) initializationCorruptOwner = null;return true;} catch (error) {- log.warn('model visibility initialization write failed', error);+ recordInitializationFailure(initializationErrorReason(error));return false;}}@@ -131,11 +209,20 @@ function adoptLocalModelVisibility(ownerId: string): void {const claim = window.electronAPI?.maker?.claimLegacyModelVisibilityOwner?.();if (claim?.dataOwnerId !== ownerId || claim.ownerGeneration !== activeOwnerGeneration|| !claim.canWriteOwnerScoped) return;- if (claim.profileOrigin === 'pending') throw new Error('Local profile adoption is not ready');+ if (claim.profileOrigin === 'pending') throw new ProfilePendingError('Local profile adoption is not ready');if (claim.profileOrigin !== 'adopted-local') return;- const source = readInitialization(LOCAL_OWNER_ID) ?? emptyInitialization();- const target = readInitialization(ownerId);+ const sourceResult = readInitialization(LOCAL_OWNER_ID);+ if (sourceResult.corrupt) {+ adoptionInitializationSourceCorrupt = true;+ recordInitializationFailure('preferences-corrupt');+ return;+ }+ adoptionInitializationSourceCorrupt = false;+ const targetResult = readInitialization(ownerId);+ if (targetResult.corrupt) return;+ const source = sourceResult.state ?? emptyInitialization();+ const target = targetResult.state;const targetPrefixes = (target?.scopes ?? []).flatMap((scope) => {try {const parsed: unknown = JSON.parse(scope);@@ -176,19 +263,20 @@ function adoptLocalModelVisibility(ownerId: string): void {/** Adopt the latest owner state only after all storage reads succeed. */function readOwnerState(ownerId: string): void {- const nextInitialization = readInitialization(ownerId);+ const nextInitializationResult = readInitialization(ownerId);+ const nextInitialization = nextInitializationResult.state;const raw = window.localStorage.getItem(ownerStorageKey(ownerId));let newProfile = false;- if (!nextInitialization) {+ if (!nextInitialization && !nextInitializationResult.corrupt) {const claim = window.electronAPI?.maker?.claimLegacyModelVisibilityOwner?.();if (claim?.dataOwnerId === ownerId && claim.ownerGeneration === activeOwnerGeneration) {// Auth can precede DB creation. Do not consume eligibility by writing migration// artifacts until Main has classified this profile. Old Main versions fail closed.- if (claim.profileOrigin === 'pending') throw new Error('Model defaults profile is not ready');+ if (claim.profileOrigin === 'pending') throw new ProfilePendingError('Model defaults profile is not ready');newProfile = claim.profileOrigin === 'new';}}- const eligible = nextInitialization?.eligibleForDefaults ?? (newProfile && raw === null+ const eligible = nextInitializationResult.corrupt ? false : nextInitialization?.eligibleForDefaults ?? (newProfile && raw === null&& window.localStorage.getItem(ownerMigrationCompleteKey(ownerId)) === null&& window.localStorage.getItem(`${DEFAULTS_MIGRATION_KEY_PREFIX}.${encodeURIComponent(ownerId)}`) === null&& !hasAnyProviderModelOverride() && !hasProviderModelHistory()@@ -210,11 +298,13 @@ async function withOwnerLock(operation: () => boolean,): Promise<boolean> {if (!ownerId) return false;+ let operationFailed = false;const run = (): boolean => {if (ownerId !== activeOwnerId || ownerGeneration !== activeOwnerGeneration|| activeOwnerMode === 'signed-out') return false;const snapshot = (): string => JSON.stringify([- cache, initialization, mayInitializeDefaults, activeOwnerReadyForWrites, activeOwnerMigrationPending, mapCorrupt, adoptionSourceCorrupt,+ cache, initialization, mayInitializeDefaults, activeOwnerReadyForWrites, activeOwnerMigrationPending,+ mapCorrupt, adoptionSourceCorrupt, initializationCorruptOwner, adoptionInitializationSourceCorrupt,]);const before = snapshot();let completed = false;@@ -224,8 +314,10 @@ async function withOwnerLock(completed = operation();return completed;} catch (error) {+ operationFailed = true;activeOwnerReadyForWrites = false;activeOwnerMigrationPending = true;+ recordInitializationFailure(initializationErrorReason(error));throw error;} finally {// A no-op catalog/owner refresh must still deliver the effective table:@@ -248,7 +340,11 @@ async function withOwnerLock(return needsLocalLock ? locks.request(initializationKey(LOCAL_OWNER_ID), run) : run();}) : run();} catch (error) {- log.warn('model visibility update failed', error);+ // Errors from the operation were classified above; a rejected Web Lock has+ // no storage operation and must remain distinguishable from disk/quota errors.+ if (!operationFailed && ownerId === activeOwnerId && ownerGeneration === activeOwnerGeneration) {+ recordInitializationFailure(initializationErrorReason(error, 'lock-unavailable'));+ }return false;}}@@ -277,7 +373,7 @@ function parseStoredMap(raw: string | null): { map: VisibilityMap; corrupt: boolfunction readStoredMap(raw: string | null): VisibilityMap {const parsed = parseStoredMap(raw);if (parsed.corrupt) mapCorrupt = true;- else if (raw !== null && raw !== '' && !adoptionSourceCorrupt) mapCorrupt = false;+ else if (!adoptionSourceCorrupt) mapCorrupt = false;return parsed.map;}@@ -295,7 +391,11 @@ const BLOCKED_MIGRATION: MigrationState = {migrationPending: true,};-function migrateLegacyVisibility(ownerId: string, ownerGeneration: number): MigrationState {+function migrateLegacyVisibility(+ ownerId: string,+ ownerGeneration: number,+ allowInitializationRecovery = false,+): MigrationState {if (typeof window === 'undefined') return BLOCKED_MIGRATION;try {const scopedKey = ownerStorageKey(ownerId);@@ -312,12 +412,15 @@ function migrateLegacyVisibility(ownerId: string, ownerGeneration: number): Migr|| claim.ownerGeneration !== ownerGeneration|| claim.canWriteOwnerScoped !== true) {+ recordInitializationFailure('owner-pending');return BLOCKED_MIGRATION;}// Preserve first-run eligibility before writing any migration artifacts or allowing// manual overrides. An empty scopes list is pending; each nonempty catalog records// its own completion later. Failed persistence leaves migration retryable.- const stored = readInitialization(ownerId);+ const storedResult = readInitialization(ownerId);+ if (storedResult.corrupt && !allowInitializationRecovery) return BLOCKED_MIGRATION;+ const stored = storedResult.state;if (stored) {initialization = stored;mayInitializeDefaults = stored.eligibleForDefaults;@@ -327,7 +430,7 @@ function migrateLegacyVisibility(ownerId: string, ownerGeneration: number): Migrif ((!stored && mayInitializeDefaults) || (stored?.eligibleForDefaults && !mayInitializeDefaults)) {if (!saveInitialization(stored? { ...stored, eligibleForDefaults: false }- : emptyInitialization(true))) return BLOCKED_MIGRATION;+ : emptyInitialization(true), allowInitializationRecovery)) return BLOCKED_MIGRATION;}if (claim.claimedByOtherOwner === true) {// 旧快照永久属于另一账号;写入本 owner 的完成标记,后续无需依赖全局 marker 继续读写。@@ -347,10 +450,12 @@ function migrateLegacyVisibility(ownerId: string, ownerGeneration: number): Migr// A missing/blocked legacy marker only defers importing the pre-account snapshot. The// stable current owner can still write its isolated key; a later import merges scoped// values last, so these new settings win without mutating the legacy input.+ recordInitializationFailure('legacy-owner-unavailable');return { readyForWrites: true, migrationPending: true };}if (claim.canInitialize !== true) {// 归属已经明确时,新设置可以安全写进 owner namespace;只把旧全局快照的导入推迟到独占时。+ recordInitializationFailure('legacy-busy');return { readyForWrites: true, migrationPending: true };}@@ -358,12 +463,14 @@ function migrateLegacyVisibility(ownerId: string, ownerGeneration: number): Migrconst scopedParsed = parseStoredMap(window.localStorage.getItem(scopedKey));if (scopedParsed.corrupt) {mapCorrupt = true;+ recordInitializationFailure('preferences-corrupt');return BLOCKED_MIGRATION;}if (legacyParsed.corrupt) {// Don't import a broken snapshot as empty, and don't mark complete just because// the scoped key already has incremental writes from the deferred-import window.mapCorrupt = true;+ recordInitializationFailure('preferences-corrupt');return { readyForWrites: true, migrationPending: true };}const legacy = legacyParsed.map;@@ -376,19 +483,20 @@ function migrateLegacyVisibility(ownerId: string, ownerGeneration: number): MigrreadyForWrites: window.localStorage.getItem(migrationCompleteKey) === '1',migrationPending: false,};- } catch {+ } catch (error) {// localStorage / 同步 owner 仲裁不可用时 fail closed:不读取未归属的旧数据。+ recordInitializationFailure(initializationErrorReason(error));return BLOCKED_MIGRATION;}}-function ensureActiveOwnerReadyForWrites(): boolean {+function ensureActiveOwnerReadyForWrites(allowInitializationRecovery = false): boolean {if (!activeOwnerId) return false;if (activeOwnerReadyForWrites && !activeOwnerMigrationPending&& (window.localStorage.getItem(ownerMigrationCompleteKey(activeOwnerId)) === '1'|| window.localStorage.getItem(LEGACY_STORAGE_KEY) === null)) return true;if (activeOwnerMode === 'signed-out') return false;- const migration = migrateLegacyVisibility(activeOwnerId, activeOwnerGeneration);+ const migration = migrateLegacyVisibility(activeOwnerId, activeOwnerGeneration, allowInitializationRecovery);activeOwnerReadyForWrites = migration.readyForWrites;activeOwnerMigrationPending = migration.migrationPending;if (!activeOwnerReadyForWrites) return false;@@ -432,10 +540,11 @@ function mirrorToMain(map: VisibilityMap): void {const generation = activeOwnerGeneration;const pending = !!ownerId && (activeOwnerMigrationPending|| (mayInitializeDefaults && !initialization?.scopes.length));+ const preferencesCorrupt = mapCorrupt || isActiveInitializationCorrupt() || adoptionInitializationSourceCorrupt;const policy = ownerId ? {followCatalogKeys: initialization?.followCatalogKeys ?? [],...(pending ? { pending: true as const } : {}),- ...(mapCorrupt ? { fallback: false as const } : {}),+ ...(preferencesCorrupt ? { fallback: false as const } : {}),} : undefined;const snapshot = effectiveMap(map);const send = (attempt: number): void => {@@ -482,12 +591,15 @@ function persist(map: VisibilityMap, context: VisibilityWriteContext): boolean {try {window.localStorage.setItem(ownerStorageKey(activeOwnerId), JSON.stringify(map));} catch (error) {+ const storageReason = initializationErrorReason(error);+ recordInitializationFailure(storageReason);log.warn('model visibility write failed', {reason: 'storage-write-failed',+ storageReason,...context,ownerGeneration: activeOwnerGeneration,mode: activeOwnerMode,- }, error);+ });return false;}// 先确认落盘成功,再更新受控开关状态,避免界面显示成功但重启后设置丢失。@@ -528,6 +640,8 @@ export async function setModelVisibilityOwner(&& activeOwnerMode === mode) return;activeOwnerId = ownerId;+ initializationFailure = null;+ initializationCorruptOwner = null;activeOwnerGeneration = ownerGeneration;activeOwnerMode = mode;activeOwnerReadyForWrites = false;@@ -535,6 +649,7 @@ export async function setModelVisibilityOwner(cache = null;mapCorrupt = false;adoptionSourceCorrupt = false;+ adoptionInitializationSourceCorrupt = false;initialization = null;mayInitializeDefaults = false;if (ownerId && mode !== 'signed-out') {@@ -564,10 +679,20 @@ export async function migrateModelVisibilityDefaults(): Promise<boolean> {// Signed-out catalogs have no owner preferences to initialize.if (!ownerId) return true;- return withOwnerLock(ownerId, ownerGeneration, () => {+ const initialized = await withOwnerLock(ownerId, ownerGeneration, () => {if (!isCurrent() || !ensureActiveOwnerReadyForWrites() || activeOwnerMigrationPending) return false;+ if (mapCorrupt) {+ recordInitializationFailure('preferences-corrupt');+ return false;+ }+ if (isActiveInitializationCorrupt() || adoptionInitializationSourceCorrupt) {+ recordInitializationFailure('preferences-corrupt');+ return false;+ }try {- const stored = readInitialization(ownerId);+ const storedResult = readInitialization(ownerId);+ if (storedResult.corrupt) return false;+ const stored = storedResult.state;// Re-read other windows' completed scopes and overrides before adding anything.const state = stored ?? initialization ?? emptyInitialization();const next: InitializationState = { ...state, defaults: { ...state.defaults }, scopes: [...state.scopes], followCatalogKeys: [...state.followCatalogKeys] };@@ -605,10 +730,14 @@ export async function migrateModelVisibilityDefaults(cache = aliases;return true;} catch (error) {- log.warn('model visibility initialization deferred', error);+ recordInitializationFailure(initializationErrorReason(error));return false;}});+ if (initialized && activeOwnerId === ownerId && activeOwnerGeneration === ownerGeneration) {+ initializationFailure = null;+ }+ return initialized;}/**@@ -624,6 +753,7 @@ export function isModelEnabled(const key = keyOf(agent, providerId, model.id);const override = load()[key];if (override !== undefined) return override;+ if (isActiveInitializationCorrupt() || adoptionInitializationSourceCorrupt) return false;// Restore defaults 记在独立 initialization 里:偏好 map 损坏时仍跟随目录。if (initialization?.followCatalogKeys.includes(key)) {return isModelVisible(undefined, model.defaultEnabled);@@ -747,13 +877,20 @@ export async function resetModelVisibilities(targets: readonly { agent: AgentKind; modelId: string }[],): Promise<boolean> {return withOwnerLock(activeOwnerId, activeOwnerGeneration, () => {- if (!ensureActiveOwnerReadyForWrites()) return false;+ // Restore defaults is the explicit action that may replace a corrupt+ // initialization record after owner readiness has been established.+ const hadCorruptInitialization = isActiveInitializationCorrupt();+ if (!ensureActiveOwnerReadyForWrites(hadCorruptInitialization)) return false;const map = load();const next = { ...map };if (targets.length === 0) return true;let state: InitializationState;+ let recoveringInitialization = false;try {- state = readInitialization(activeOwnerId!) ?? initialization ?? emptyInitialization();+ const storedResult = readInitialization(activeOwnerId!);+ recoveringInitialization = hadCorruptInitialization+ || storedResult.corrupt || isActiveInitializationCorrupt();+ state = storedResult.state ?? (recoveringInitialization ? emptyInitialization() : initialization ?? emptyInitialization());} catch (error) {log.warn('model visibility reset read failed', error);return false;@@ -766,8 +903,13 @@ export async function resetModelVisibilities(}// Write permission to follow defaults first; the old explicit value keeps winning until// its removal succeeds. A failed override write can be retried without losing the choice.- if (!saveInitialization({ ...state, followCatalogKeys: [...follows] })) return false;- return persist(next, { operation: 'bulk', providerId, enabled: false, modelCount: targets.length });+ if (!saveInitialization({ ...state, followCatalogKeys: [...follows] }, recoveringInitialization)) return false;+ const persisted = persist(next, { operation: 'bulk', providerId, enabled: false, modelCount: targets.length });+ if (persisted && recoveringInitialization && !isActiveInitializationCorrupt()+ && !adoptionInitializationSourceCorrupt && !mapCorrupt && !activeOwnerMigrationPending) {+ initializationFailure = null;+ }+ return persisted;});}@@ -816,6 +958,8 @@ export function useModelVisibilityVersion(): number {/** 测试用 —— 重置缓存 + 清 localStorage(其它代码不应调用)。 */export function __resetForTest(): void {+ initializationFailure = null;+ initializationCorruptOwner = null;mirrorRevision += 1;clearTimeout(mirrorRetryTimer);const currentScopedKey = activeOwnerId ? ownerStorageKey(activeOwnerId) : null;@@ -824,6 +968,7 @@ export function __resetForTest(): void {cache = null;mapCorrupt = false;adoptionSourceCorrupt = false;+ adoptionInitializationSourceCorrupt = false;initialization = null;mayInitializeDefaults = false;activeOwnerId = null;diff --git a/docs/design-rules/design-inventory.md b/docs/design-rules/design-inventory.mdindex 1a33a64c5d..73551ae88e 100644--- a/docs/design-rules/design-inventory.md+++ b/docs/design-rules/design-inventory.md@@ -18,12 +18,12 @@| `desktop.auth.add-account` | desktop | 添加账号 | hash `/add-account`(ProtectedRoute → AddAccountLoginPage) | AddAccountLoginPage | apps/desktop/src/renderer/components/login/AddAccountLoginPage.tsx, apps/desktop/src/renderer/components/login/LoginBrandStage.tsx, apps/desktop/src/renderer/components/login/LoginCaptchaOverlay.tsx, apps/desktop/src/renderer/components/login/LoginControls.tsx, apps/desktop/src/renderer/components/login/LoginPage.tsx, apps/desktop/src/renderer/components/login/loginDesignTokens.ts | 59 | 0 | 20 || `desktop.auth.legacy-migration` | desktop | 首登数据迁移弹窗 | App 顶层挂载 LegacyMigrationDialog(仅主窗;main 检测到旧版 userData 经 `legacy-migration:state` 驱动) | LegacyMigrationDialog | apps/desktop/src/renderer/components/auth/LegacyMigrationDialog.tsx | 8 | 0 | 2 || `desktop.auth.login` | desktop | 登录页 | hash `/login`(GuestRoute → LoginPage) | LoginBrandStage, LoginCaptchaOverlay, LoginControls, LoginPage | apps/desktop/src/renderer/components/login/LoginBrandStage.tsx, apps/desktop/src/renderer/components/login/LoginCaptchaOverlay.tsx, apps/desktop/src/renderer/components/login/LoginControls.tsx, apps/desktop/src/renderer/components/login/LoginPage.tsx, apps/desktop/src/renderer/components/login/loginDesignTokens.ts | 59 | 0 | 20 |-| `desktop.bots` | desktop | 伙伴(列表 / 对话 / 设置 / 历史 / 伙伴私聊) | hash `/bots`、`/bots/list`、`/bots/:botId`、`/bots/roster` 及伙伴当前/历史任务、伙伴私聊路由(BotsFeatureLayout) | BotBasicProfileFields, BotCollaborationCard, BotDirectMessageView, BotHistorySessionView, BotLifecycleSettings, BotModelChainEditor, BotRosterView, BotSessionView, BotSettingsDrawer, BotsHomeView, BotsListView, RemoteBotSessionView | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/bots/BotAuthorizationCard.tsx, apps/desktop/src/renderer/features/bots/BotAvatar.tsx, apps/desktop/src/renderer/features/bots/BotBasicProfileFields.tsx, apps/desktop/src/renderer/features/bots/BotCapabilitySettings.tsx, apps/desktop/src/renderer/features/bots/BotCollaborationCard.tsx, apps/desktop/src/renderer/features/bots/BotConnectionStatus.tsx, apps/desktop/src/renderer/features/bots/BotCreateMenu.tsx, apps/desktop/src/renderer/features/bots/BotDeleteDialog.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageCard.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageView.tsx, apps/desktop/src/renderer/features/bots/BotGenerationLabel.tsx, apps/desktop/src/renderer/features/bots/BotHistorySessionView.tsx, apps/desktop/src/renderer/features/bots/BotInvitationWelcome.tsx, apps/desktop/src/renderer/features/bots/BotLifecycleSettings.tsx, apps/desktop/src/renderer/features/bots/BotMemorySettings.tsx, apps/desktop/src/renderer/features/bots/BotModelChainEditor.tsx, apps/desktop/src/renderer/features/bots/BotPortraitPicker.tsx, apps/desktop/src/renderer/features/bots/BotRosterView.tsx, apps/desktop/src/renderer/features/bots/BotRoutines.tsx, apps/desktop/src/renderer/features/bots/BotSessionContentHeader.tsx, apps/desktop/src/renderer/features/bots/BotSessionView.tsx, apps/desktop/src/renderer/features/bots/BotSettingsBlock.tsx, apps/desktop/src/renderer/features/bots/BotSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotWorkingStatus.tsx, apps/desktop/src/renderer/features/bots/BotsFeatureLayout.tsx, apps/desktop/src/renderer/features/bots/BotsGlobalSettingsSection.tsx, apps/desktop/src/renderer/features/bots/BotsHomeView.tsx, apps/desktop/src/renderer/features/bots/BotsListView.tsx, apps/desktop/src/renderer/features/bots/BotsSidebar.tsx, apps/desktop/src/renderer/features/bots/CindyDevicePicker.tsx, apps/desktop/src/renderer/features/bots/CindyDeviceRow.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSessionView.tsx, apps/desktop/src/renderer/features/bots/botAvatarIdentity.ts, apps/desktop/src/renderer/features/bots/botCapabilityDefaults.ts, apps/desktop/src/renderer/features/bots/botChatPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationTimeline.ts, apps/desktop/src/renderer/features/bots/botDelegationLive.ts, apps/desktop/src/renderer/features/bots/botGeneratedArtifacts.ts, apps/desktop/src/renderer/features/bots/botListDisplay.ts, apps/desktop/src/renderer/features/bots/botNavigation.ts, apps/desktop/src/renderer/features/bots/botPronounContext.tsx, apps/desktop/src/renderer/features/bots/botReadState.ts, apps/desktop/src/renderer/features/bots/botRosterDisplay.ts, apps/desktop/src/renderer/features/bots/botSessionOwners.ts, apps/desktop/src/renderer/features/bots/botSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/botStore.ts, apps/desktop/src/renderer/features/bots/botWelcomeContext.ts, apps/desktop/src/renderer/features/bots/cindyDeviceRoster.ts, apps/desktop/src/renderer/features/bots/remoteBotRoster.ts, apps/desktop/src/renderer/features/bots/useBotGeneratedFileDeliveries.ts, apps/desktop/src/renderer/features/bots/useBotIslandVisibleSession.ts, apps/desktop/src/renderer/features/bots/useBotSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/useRemoteBots.ts, apps/desktop/src/renderer/features/bots/useWorkingStatusCopy.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 276 | 43 | 442 |+| `desktop.bots` | desktop | 伙伴(列表 / 对话 / 设置 / 历史 / 伙伴私聊) | hash `/bots`、`/bots/list`、`/bots/:botId`、`/bots/roster` 及伙伴当前/历史任务、伙伴私聊路由(BotsFeatureLayout) | BotBasicProfileFields, BotCollaborationCard, BotDirectMessageView, BotHistorySessionView, BotLifecycleSettings, BotModelChainEditor, BotRosterView, BotSessionView, BotSettingsDrawer, BotsHomeView, BotsListView, RemoteBotSessionView | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/bots/BotAuthorizationCard.tsx, apps/desktop/src/renderer/features/bots/BotAvatar.tsx, apps/desktop/src/renderer/features/bots/BotBasicProfileFields.tsx, apps/desktop/src/renderer/features/bots/BotCapabilitySettings.tsx, apps/desktop/src/renderer/features/bots/BotCollaborationCard.tsx, apps/desktop/src/renderer/features/bots/BotConnectionStatus.tsx, apps/desktop/src/renderer/features/bots/BotCreateMenu.tsx, apps/desktop/src/renderer/features/bots/BotDeleteDialog.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageCard.tsx, apps/desktop/src/renderer/features/bots/BotDirectMessageView.tsx, apps/desktop/src/renderer/features/bots/BotGenerationLabel.tsx, apps/desktop/src/renderer/features/bots/BotHistorySessionView.tsx, apps/desktop/src/renderer/features/bots/BotInvitationWelcome.tsx, apps/desktop/src/renderer/features/bots/BotLifecycleSettings.tsx, apps/desktop/src/renderer/features/bots/BotMemorySettings.tsx, apps/desktop/src/renderer/features/bots/BotModelChainEditor.tsx, apps/desktop/src/renderer/features/bots/BotPortraitPicker.tsx, apps/desktop/src/renderer/features/bots/BotRosterView.tsx, apps/desktop/src/renderer/features/bots/BotRoutines.tsx, apps/desktop/src/renderer/features/bots/BotSessionContentHeader.tsx, apps/desktop/src/renderer/features/bots/BotSessionView.tsx, apps/desktop/src/renderer/features/bots/BotSettingsBlock.tsx, apps/desktop/src/renderer/features/bots/BotSettingsDrawer.tsx, apps/desktop/src/renderer/features/bots/BotWorkingStatus.tsx, apps/desktop/src/renderer/features/bots/BotsFeatureLayout.tsx, apps/desktop/src/renderer/features/bots/BotsGlobalSettingsSection.tsx, apps/desktop/src/renderer/features/bots/BotsHomeView.tsx, apps/desktop/src/renderer/features/bots/BotsListView.tsx, apps/desktop/src/renderer/features/bots/BotsSidebar.tsx, apps/desktop/src/renderer/features/bots/CindyDevicePicker.tsx, apps/desktop/src/renderer/features/bots/CindyDeviceRow.tsx, apps/desktop/src/renderer/features/bots/RemoteBotSessionView.tsx, apps/desktop/src/renderer/features/bots/botAvatarIdentity.ts, apps/desktop/src/renderer/features/bots/botCapabilityDefaults.ts, apps/desktop/src/renderer/features/bots/botChatPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationPresentation.ts, apps/desktop/src/renderer/features/bots/botConversationTimeline.ts, apps/desktop/src/renderer/features/bots/botDelegationLive.ts, apps/desktop/src/renderer/features/bots/botGeneratedArtifacts.ts, apps/desktop/src/renderer/features/bots/botListDisplay.ts, apps/desktop/src/renderer/features/bots/botNavigation.ts, apps/desktop/src/renderer/features/bots/botPronounContext.tsx, apps/desktop/src/renderer/features/bots/botReadState.ts, apps/desktop/src/renderer/features/bots/botRosterDisplay.ts, apps/desktop/src/renderer/features/bots/botSessionOwners.ts, apps/desktop/src/renderer/features/bots/botSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/botStore.ts, apps/desktop/src/renderer/features/bots/botWelcomeContext.ts, apps/desktop/src/renderer/features/bots/cindyDeviceRoster.ts, apps/desktop/src/renderer/features/bots/remoteBotRoster.ts, apps/desktop/src/renderer/features/bots/useBotGeneratedFileDeliveries.ts, apps/desktop/src/renderer/features/bots/useBotIslandVisibleSession.ts, apps/desktop/src/renderer/features/bots/useBotSettingsAutosave.ts, apps/desktop/src/renderer/features/bots/useRemoteBots.ts, apps/desktop/src/renderer/features/bots/useWorkingStatusCopy.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 276 | 43 | 443 || `desktop.chat.files` | desktop | 工作目录文件浏览 | hash `/cc-agent/files/:sessionId`(WorkdirBrowseRoute) | FileBodyView, FileTreeView, WorkdirBrowseRoute | apps/desktop/src/renderer/features/cc-agent/workdir-browse/DocSearchBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/DrawioPreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileBodyView.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileFilterInput.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTabsBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FileTreeView.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/FilterResultList.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/ImagePreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/OpenInSystemActions.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/PdfPreview.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/SessionTabsBar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/UnrenderablePlaceholder.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/WorkdirBrowseRoute.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/WorkdirBrowseSidebar.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useChatRailCollapsed.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useChatRailResize.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useConfirmSwitchAwayIfDirty.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useDelayedFlag.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useFileContent.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useFileTree.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useOpenTabs.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useProjectFileList.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/hooks/useRevealFileInTree.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/activeFileBodyHandle.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/docModeSwitchProjects.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/drawioExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/expandedStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileContentCache.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileIcon.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileMeta.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileScrollStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/fileSelectionParams.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/filterFiles.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/imageExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/markdownAutosave.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/openTabsStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/pdfExt.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/lib/selectedFileStore.ts, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchInput.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchPanel.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/SearchResults.tsx, apps/desktop/src/renderer/features/cc-agent/workdir-browse/search/hooks/useProjectSearch.ts | 17 | 7 | 62 || `desktop.chat.new-draft` | desktop | 新建任务草稿页 | hash `/cc-agent/new`(NewMakerDraftRoute) | NewMakerDraftRoute | apps/desktop/src/renderer/features/cc-agent/NewMakerDraftRoute.tsx | 15 | 0 | 2 |-| `desktop.chat.orca-workflow` | desktop | Orca 协同工作台 | hash `/cc-agent/orca/:sessionId`(OrcaWorkflowRoute) | CCAgentSessionView, OrcaSplitView, OrcaWorkerPanel, OrcaWorkflowRoute | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaSplitView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkerPanel.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkflowRoute.tsx | 256 | 43 | 355 |+| `desktop.chat.orca-workflow` | desktop | Orca 协同工作台 | hash `/cc-agent/orca/:sessionId`(OrcaWorkflowRoute) | CCAgentSessionView, OrcaSplitView, OrcaWorkerPanel, OrcaWorkflowRoute | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaSplitView.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkerPanel.tsx, apps/desktop/src/renderer/features/cc-agent/OrcaWorkflowRoute.tsx | 256 | 43 | 356 || `desktop.chat.scheduled` | desktop | 调度任务列表 | hash `/cc-agent/scheduled`(SchedulerPage) | SchedulerPage | apps/desktop/src/renderer/features/scheduler/SchedulerPage.tsx, apps/desktop/src/renderer/features/scheduler/components/AgentMark.tsx, apps/desktop/src/renderer/features/scheduler/components/BoundSessionCard.tsx, apps/desktop/src/renderer/features/scheduler/components/ProjectAutomationNotifyBridge.tsx, apps/desktop/src/renderer/features/scheduler/components/RunHistoryCard.tsx, apps/desktop/src/renderer/features/scheduler/components/RunHistoryPane.tsx, apps/desktop/src/renderer/features/scheduler/components/ScheduleChips.tsx, apps/desktop/src/renderer/features/scheduler/components/ScheduleFormDialog.tsx, apps/desktop/src/renderer/features/scheduler/components/ScheduleSessionIndexOwner.tsx, apps/desktop/src/renderer/features/scheduler/components/ScheduleStatusChip.tsx, apps/desktop/src/renderer/features/scheduler/components/ScriptCapabilityMultiSelect.tsx, apps/desktop/src/renderer/features/scheduler/components/TaskListCell.tsx, apps/desktop/src/renderer/features/scheduler/components/TaskListFilterPopover.tsx, apps/desktop/src/renderer/features/scheduler/components/TaskListPane.tsx, apps/desktop/src/renderer/features/scheduler/components/TemplateCard.tsx, apps/desktop/src/renderer/features/scheduler/components/TemplateGallery.tsx, apps/desktop/src/renderer/features/scheduler/components/TemplateParamForm.tsx, apps/desktop/src/renderer/features/scheduler/hooks/useDeleteScheduleWithSessions.tsx, apps/desktop/src/renderer/features/scheduler/hooks/useReadFailedScheduleRuns.ts, apps/desktop/src/renderer/features/scheduler/hooks/useRunNowBusyGuard.ts, apps/desktop/src/renderer/features/scheduler/hooks/useRuns.ts, apps/desktop/src/renderer/features/scheduler/hooks/useScheduleForm.ts, apps/desktop/src/renderer/features/scheduler/hooks/useScheduleUnreadRunCounts.ts, apps/desktop/src/renderer/features/scheduler/hooks/useSchedules.ts, apps/desktop/src/renderer/features/scheduler/hooks/useSessionReferences.ts, apps/desktop/src/renderer/features/scheduler/hooks/useTemplates.ts, apps/desktop/src/renderer/features/scheduler/index.ts, apps/desktop/src/renderer/features/scheduler/lib/cronCodexPreset.ts, apps/desktop/src/renderer/features/scheduler/lib/cronToHuman.ts, apps/desktop/src/renderer/features/scheduler/lib/failedScheduleDismissal.ts, apps/desktop/src/renderer/features/scheduler/lib/formatters.ts, apps/desktop/src/renderer/features/scheduler/lib/pluginScheduleCreateIntent.ts, apps/desktop/src/renderer/features/scheduler/lib/projectAutomationConfig.ts, apps/desktop/src/renderer/features/scheduler/lib/projectScheduleSidebarIndex.ts, apps/desktop/src/renderer/features/scheduler/lib/runHistoryGrouping.ts, apps/desktop/src/renderer/features/scheduler/lib/runUnread.ts, apps/desktop/src/renderer/features/scheduler/lib/scheduleFormLogic.ts, apps/desktop/src/renderer/features/scheduler/lib/scheduleRunReadSync.ts, apps/desktop/src/renderer/features/scheduler/lib/scheduleSessionBinding.ts, apps/desktop/src/renderer/features/scheduler/lib/scheduleSidebarIndexRuns.ts, apps/desktop/src/renderer/features/scheduler/lib/schedulesStore.ts, apps/desktop/src/renderer/features/scheduler/lib/statusFilter.ts, apps/desktop/src/renderer/features/scheduler/lib/statusFilterStorage.ts, apps/desktop/src/renderer/features/scheduler/lib/templateLocalization.ts, apps/desktop/src/renderer/features/scheduler/lib/usageLimitScheduleCreateIntent.ts | 37 | 0 | 95 |-| `desktop.chat.session` | desktop | 会话工作台 | hash `/cc-agent/:sessionId`;副窗经 `/cc-agent/boot` 解析后落到同一会话视图 | AssistantMessage, CCAgentFeatureLayout, CCAgentSessionView, ChatInput, PermissionPrompt | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 256 | 43 | 354 |+| `desktop.chat.session` | desktop | 会话工作台 | hash `/cc-agent/:sessionId`;副窗经 `/cc-agent/boot` 解析后落到同一会话视图 | AssistantMessage, CCAgentFeatureLayout, CCAgentSessionView, ChatInput, PermissionPrompt | apps/desktop/src/renderer/components/chat/AgentActionRow.tsx, apps/desktop/src/renderer/components/chat/AgentActionsBlock.tsx, apps/desktop/src/renderer/components/chat/AgentTaskCard.tsx, apps/desktop/src/renderer/components/chat/AskUserQuestionBubble.tsx, apps/desktop/src/renderer/components/chat/AssistantMessage.tsx, apps/desktop/src/renderer/components/chat/AutomationOriginBadge.tsx, apps/desktop/src/renderer/components/chat/ChatAudioCard.tsx, apps/desktop/src/renderer/components/chat/ChatDisplaySnapshotContext.tsx, apps/desktop/src/renderer/components/chat/ChatImageView.tsx, apps/desktop/src/renderer/components/chat/ChatSessionFileContext.tsx, apps/desktop/src/renderer/components/chat/ChatSoundEffectCard.tsx, apps/desktop/src/renderer/components/chat/ChatVideoView.tsx, apps/desktop/src/renderer/components/chat/CindyMakeDoctorCard.tsx, apps/desktop/src/renderer/components/chat/CopyAsImageBlock.tsx, apps/desktop/src/renderer/components/chat/CredentialSwitchWaitBanner.tsx, apps/desktop/src/renderer/components/chat/DiffView.tsx, apps/desktop/src/renderer/components/chat/ErrorBanner.tsx, apps/desktop/src/renderer/components/chat/ErrorMessageCard.tsx, apps/desktop/src/renderer/components/chat/GeneratedFilesCard.tsx, apps/desktop/src/renderer/components/chat/GhostSummonCard.tsx, apps/desktop/src/renderer/components/chat/GhostToolCard.tsx, apps/desktop/src/renderer/components/chat/HookTaskCard.tsx, apps/desktop/src/renderer/components/chat/ImageGalleryContext.tsx, apps/desktop/src/renderer/components/chat/ImageHoverPreview.tsx, apps/desktop/src/renderer/components/chat/ImageLightbox.tsx, apps/desktop/src/renderer/components/chat/ImageMissingPlaceholder.tsx, apps/desktop/src/renderer/components/chat/InlineReferenceChip.tsx, apps/desktop/src/renderer/components/chat/InterruptedTurnBanner.tsx, apps/desktop/src/renderer/components/chat/JumpToBottomChip.tsx, apps/desktop/src/renderer/components/chat/MarkdownDiffBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownMermaidBlock.tsx, apps/desktop/src/renderer/components/chat/MarkdownRenderer.tsx, apps/desktop/src/renderer/components/chat/MermaidLightbox.tsx, apps/desktop/src/renderer/components/chat/MessageActionBar.tsx, apps/desktop/src/renderer/components/chat/MessageNavRail.tsx, apps/desktop/src/renderer/components/chat/MessageStream.tsx, apps/desktop/src/renderer/components/chat/ModelLightbox.tsx, apps/desktop/src/renderer/components/chat/NewMessageIndicator.tsx, apps/desktop/src/renderer/components/chat/PlanReviewBubble.tsx, apps/desktop/src/renderer/components/chat/PrevMessageJumpChip.tsx, apps/desktop/src/renderer/components/chat/ProjectLinkChip.tsx, apps/desktop/src/renderer/components/chat/QuoteChip.tsx, apps/desktop/src/renderer/components/chat/RewindPreviewDialog.tsx, apps/desktop/src/renderer/components/chat/SelectionQuoteButton.tsx, apps/desktop/src/renderer/components/chat/SentAgentReferenceChip.tsx, apps/desktop/src/renderer/components/chat/SentInlineAtomBody.tsx, apps/desktop/src/renderer/components/chat/SessionHandoffCard.tsx, apps/desktop/src/renderer/components/chat/SessionLinkChip.tsx, apps/desktop/src/renderer/components/chat/ShareMessageCheckbox.tsx, apps/desktop/src/renderer/components/chat/ShareSelectionBar.tsx, apps/desktop/src/renderer/components/chat/SlackIcon.tsx, apps/desktop/src/renderer/components/chat/StreamFadeSpan.tsx, apps/desktop/src/renderer/components/chat/StreamingMarkdownChunk.tsx, apps/desktop/src/renderer/components/chat/SystemCard.tsx, apps/desktop/src/renderer/components/chat/TextLightbox.tsx, apps/desktop/src/renderer/components/chat/ThinkingCard.tsx, apps/desktop/src/renderer/components/chat/ThinkingText.tsx, apps/desktop/src/renderer/components/chat/TodoListCard.tsx, apps/desktop/src/renderer/components/chat/ToolCallCard.tsx, apps/desktop/src/renderer/components/chat/ToolPayloadLightbox.tsx, apps/desktop/src/renderer/components/chat/TopRightChipStack.tsx, apps/desktop/src/renderer/components/chat/TurnChangesCard.tsx, apps/desktop/src/renderer/components/chat/UnreadFailedScheduleBanner.tsx, apps/desktop/src/renderer/components/chat/UpgradeBanner.tsx, apps/desktop/src/renderer/components/chat/UserMessage.tsx, apps/desktop/src/renderer/components/chat/UserMessageEditBox.tsx, apps/desktop/src/renderer/components/chat/UserMessageUrlLink.tsx, apps/desktop/src/renderer/components/chat/VideoLightbox.tsx, apps/desktop/src/renderer/components/chat/WorkGroupBlock.tsx, apps/desktop/src/renderer/components/chat/WorktreeRestoreBanner.tsx, apps/desktop/src/renderer/components/chat/XIcon.tsx, apps/desktop/src/renderer/components/chat/activityRowChrome.ts, apps/desktop/src/renderer/components/chat/autoFollowIntent.ts, apps/desktop/src/renderer/components/chat/chatChrome.ts, apps/desktop/src/renderer/components/chat/errorReasonI18n.ts, apps/desktop/src/renderer/components/chat/generatedFilesProjection.ts, apps/desktop/src/renderer/components/chat/imageDisplaySize.ts, apps/desktop/src/renderer/components/chat/lightboxAnnotations.ts, apps/desktop/src/renderer/components/chat/lightboxGestures.ts, apps/desktop/src/renderer/components/chat/markdownImageTargets.ts, apps/desktop/src/renderer/components/chat/messageNavRailModel.ts, apps/desktop/src/renderer/components/chat/messageNavRailWheel.ts, apps/desktop/src/renderer/components/chat/messageProjectionCache.ts, apps/desktop/src/renderer/components/chat/messageStreamIndicatorPosition.ts, apps/desktop/src/renderer/components/chat/messageViewportCompensation.ts, apps/desktop/src/renderer/components/chat/messageWorkGroups.ts, apps/desktop/src/renderer/components/chat/rehypeFencedCodeMarker.ts, apps/desktop/src/renderer/components/chat/rehypeMathBlockMarker.ts, apps/desktop/src/renderer/components/chat/rehypeStreamWordFade.ts, apps/desktop/src/renderer/components/chat/remarkHtmlImages.ts, apps/desktop/src/renderer/components/chat/remarkLocalPathLinks.ts, apps/desktop/src/renderer/components/chat/remarkPreserveRawLocalDestinations.ts, apps/desktop/src/renderer/components/chat/remarkSessionLinks.ts, apps/desktop/src/renderer/components/chat/remarkStrictInlineMath.ts, apps/desktop/src/renderer/components/chat/remarkTruncateCjkUrls.ts, apps/desktop/src/renderer/components/chat/repairStreamingMarkdown.ts, apps/desktop/src/renderer/components/chat/scrollAnchoringDetect.ts, apps/desktop/src/renderer/components/chat/shareSelectionStore.ts, apps/desktop/src/renderer/components/chat/streamingMarkdownBlocks.tsx, apps/desktop/src/renderer/components/chat/streamingMarkdownChunks.ts, apps/desktop/src/renderer/components/chat/toolLoopI18n.ts, apps/desktop/src/renderer/components/chat/unreadCount.ts, apps/desktop/src/renderer/components/chat/useAutomaticHistoryLoadBudget.ts, apps/desktop/src/renderer/components/chat/useCopyAsImage.tsx, apps/desktop/src/renderer/components/chat/useDeleteMessage.ts, apps/desktop/src/renderer/components/chat/useFileChipContextMenu.tsx, apps/desktop/src/renderer/components/chat/useForkAtMessage.ts, apps/desktop/src/renderer/components/chat/useNavigationKeyListener.ts, apps/desktop/src/renderer/components/chat/useOpenWithMenu.tsx, apps/desktop/src/renderer/components/chat/usePrevUserMessageInView.ts, apps/desktop/src/renderer/components/chat/useTurnChangeSets.ts, apps/desktop/src/renderer/components/chat/userMessageCollapse.ts, apps/desktop/src/renderer/components/chat/userMessageDisplayText.ts, apps/desktop/src/renderer/components/chat/userMessageLinkify.ts, apps/desktop/src/renderer/components/chat/viewportFillDetect.ts, apps/desktop/src/renderer/components/new-chat/AddRemoteProjectDialog.tsx, apps/desktop/src/renderer/components/new-chat/AgentSelect.tsx, apps/desktop/src/renderer/components/new-chat/AskUserQuestionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/AtMentionPanel.tsx, apps/desktop/src/renderer/components/new-chat/AttachmentTypeThumb.tsx, apps/desktop/src/renderer/components/new-chat/ChatInput.tsx, apps/desktop/src/renderer/components/new-chat/CjkPunctDecoration.ts, apps/desktop/src/renderer/components/new-chat/CjkPunctuationUtils.ts, apps/desktop/src/renderer/components/new-chat/ComposerListIndentDecoration.ts, apps/desktop/src/renderer/components/new-chat/ComposerListNodes.ts, apps/desktop/src/renderer/components/new-chat/ComposerQuoteNode.tsx, apps/desktop/src/renderer/components/new-chat/DeviceSwitcherPill.tsx, apps/desktop/src/renderer/components/new-chat/EffortSlider.tsx, apps/desktop/src/renderer/components/new-chat/EmptyDocSelectionGuard.ts, apps/desktop/src/renderer/components/new-chat/ExtraDirsButton.tsx, apps/desktop/src/renderer/components/new-chat/FastModeToggle.tsx, apps/desktop/src/renderer/components/new-chat/FolderPickerPopover.tsx, apps/desktop/src/renderer/components/new-chat/FullAccessConfirmContent.tsx, apps/desktop/src/renderer/components/new-chat/GhostCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/GoalAdvancedLimits.tsx, apps/desktop/src/renderer/components/new-chat/GoalIndicator.tsx, apps/desktop/src/renderer/components/new-chat/HomeUsageDashboard.tsx, apps/desktop/src/renderer/components/new-chat/ListComposerTextarea.tsx, apps/desktop/src/renderer/components/new-chat/LocalModelCatalogNotice.tsx, apps/desktop/src/renderer/components/new-chat/MentionChipNode.tsx, apps/desktop/src/renderer/components/new-chat/MentionDragCaretDecoration.ts, apps/desktop/src/renderer/components/new-chat/ModelCompatibilityNotice.tsx, apps/desktop/src/renderer/components/new-chat/ModelConfigFlyout.tsx, apps/desktop/src/renderer/components/new-chat/ModelHarnessPicker.tsx, apps/desktop/src/renderer/components/new-chat/ModelSelector.tsx, apps/desktop/src/renderer/components/new-chat/ModelSourceDetails.tsx, apps/desktop/src/renderer/components/new-chat/NewGoalDialog.tsx, apps/desktop/src/renderer/components/new-chat/PastedTextChipNode.tsx, apps/desktop/src/renderer/components/new-chat/PendingQueuePanel.tsx, apps/desktop/src/renderer/components/new-chat/PermissionPrompt.tsx, apps/desktop/src/renderer/components/new-chat/PermissionSelector.tsx, apps/desktop/src/renderer/components/new-chat/PinnedPlanPanel.tsx, apps/desktop/src/renderer/components/new-chat/PlanActionCard.tsx, apps/desktop/src/renderer/components/new-chat/PlanModeIndicator.tsx, apps/desktop/src/renderer/components/new-chat/PlanViewerCard.tsx, apps/desktop/src/renderer/components/new-chat/PluginConnectionForm.tsx, apps/desktop/src/renderer/components/new-chat/PluginOauthDeviceCode.tsx, apps/desktop/src/renderer/components/new-chat/PluginSetupPrompt.tsx, apps/desktop/src/renderer/components/new-chat/QuickStartPillMark.ts, apps/desktop/src/renderer/components/new-chat/RemoteOauthSetupCard.tsx, apps/desktop/src/renderer/components/new-chat/SendButton.tsx, apps/desktop/src/renderer/components/new-chat/SlashCommandDecoration.ts, apps/desktop/src/renderer/components/new-chat/SlashCommandPalette.tsx, apps/desktop/src/renderer/components/new-chat/TakeoverMask.tsx, apps/desktop/src/renderer/components/new-chat/ThinkingToggle.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedFlyoutHost.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelPanel.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRail.tsx, apps/desktop/src/renderer/components/new-chat/UnifiedModelRow.tsx, apps/desktop/src/renderer/components/new-chat/UsageDailyBars.tsx, apps/desktop/src/renderer/components/new-chat/UsageHeatmap.tsx, apps/desktop/src/renderer/components/new-chat/VendorSegmentedSwitcher.tsx, apps/desktop/src/renderer/components/new-chat/VoiceInputDraftDecoration.ts, apps/desktop/src/renderer/components/new-chat/WindowsSelectionReplacement.ts, apps/desktop/src/renderer/components/new-chat/WorktreeChipsRow.tsx, apps/desktop/src/renderer/components/new-chat/WorktreeCreatingOverlay.tsx, apps/desktop/src/renderer/components/new-chat/agentOptions.ts, apps/desktop/src/renderer/components/new-chat/agentSwitchConfirmation.ts, apps/desktop/src/renderer/components/new-chat/branchPick.ts, apps/desktop/src/renderer/components/new-chat/composerBlankPointerFocus.ts, apps/desktop/src/renderer/components/new-chat/composerContentSerialization.ts, apps/desktop/src/renderer/components/new-chat/composerDocState.ts, apps/desktop/src/renderer/components/new-chat/composerFrameScheduler.ts, apps/desktop/src/renderer/components/new-chat/composerHistoryProjection.ts, apps/desktop/src/renderer/components/new-chat/composerModelSelection.ts, apps/desktop/src/renderer/components/new-chat/composerPromptRecommendation.ts, apps/desktop/src/renderer/components/new-chat/composerRenderGate.ts, apps/desktop/src/renderer/components/new-chat/composerSendOwnership.ts, apps/desktop/src/renderer/components/new-chat/composerSendSnapshot.ts, apps/desktop/src/renderer/components/new-chat/effortChangeQueue.ts, apps/desktop/src/renderer/components/new-chat/extraDirsActions.ts, apps/desktop/src/renderer/components/new-chat/ghostComposerPlacement.ts, apps/desktop/src/renderer/components/new-chat/localAttachmentPicker.ts, apps/desktop/src/renderer/components/new-chat/mentionChipInsertion.ts, apps/desktop/src/renderer/components/new-chat/modelWindowErrorToast.ts, apps/desktop/src/renderer/components/new-chat/pastePipeline.ts, apps/desktop/src/renderer/components/new-chat/pathPaste.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueLocks.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowActivity.ts, apps/desktop/src/renderer/components/new-chat/pendingQueueRowPresentation.ts, apps/desktop/src/renderer/components/new-chat/planModeComposerCommand.ts, apps/desktop/src/renderer/components/new-chat/priceTierMarks.tsx, apps/desktop/src/renderer/components/new-chat/remoteBrowseAdapters.ts, apps/desktop/src/renderer/components/new-chat/remoteExistingProjects.ts, apps/desktop/src/renderer/components/new-chat/restoreComposerDocument.ts, apps/desktop/src/renderer/components/new-chat/sessionLinkPaste.ts, apps/desktop/src/renderer/components/new-chat/sourceSwitch.ts, apps/desktop/src/renderer/components/new-chat/unifiedModelSelection.ts, apps/desktop/src/renderer/components/new-chat/usagePalette.ts, apps/desktop/src/renderer/components/new-chat/useComposerSendFocusRestore.ts, apps/desktop/src/renderer/components/new-chat/useModelDiscoveryPending.ts, apps/desktop/src/renderer/components/new-chat/useProviderWeeklyQuota.ts, apps/desktop/src/renderer/components/new-chat/useUnifiedRowActions.ts, apps/desktop/src/renderer/features/cc-agent/CCAgentFeatureLayout.tsx, apps/desktop/src/renderer/features/cc-agent/CCAgentSessionView.tsx | 256 | 43 | 355 || `desktop.dev.maker-experimental` | desktop | Maker 实验诊断页 | hash `/maker-experimental`(MakerExperimentalView;EXPERIMENTAL_FEATURES 现为空,仍是生产路由) | MakerExperimentalView | apps/desktop/src/renderer/features/maker-experimental/MakerExperimentalView.tsx | 9 | 0 | 7 || `desktop.issues.guide` | desktop | Issue 引导页 | hash `/issues`(IssueTrackerFeatureLayout,已迁 GitHub 后的引导页) | IssueTrackerFeatureLayout | apps/desktop/src/renderer/features/issue-tracker/IssueTrackerFeatureLayout.tsx, apps/desktop/src/renderer/features/issue-tracker/MyIssueList.tsx, apps/desktop/src/renderer/features/issue-tracker/hooks/useMyIssues.ts, apps/desktop/src/renderer/features/issue-tracker/lib/myIssuesNotices.ts, apps/desktop/src/renderer/features/issue-tracker/lib/startIssueChat.ts | 0 | 0 | 7 || `desktop.native.app-menu` | desktop | 应用菜单 | Menu.setApplicationMenu(用户可见出口,不展开业务逻辑) | applicationMenuLabels | apps/desktop/src/main/applicationMenuLabels.ts | 0 | 0 | 0 |diff --git a/docs/dev-rules/model-catalog-runtime.md b/docs/dev-rules/model-catalog-runtime.mdindex ff0f839cfc..e61acbfe47 100644--- a/docs/dev-rules/model-catalog-runtime.md+++ b/docs/dev-rules/model-catalog-runtime.md@@ -192,6 +192,12 @@ GPT `[1m]` 是旧窗口预设,退出 Desktop 管理和新选择清单;完整## 从需求找到代码+Desktop 本机目录只有在 providers、capabilities 和当前账号的模型显示设置均就绪后才提交。+初始化失败保留上一份有效列表,并在选择器和供应商设置页显示原因与重新加载入口;+启动的三次短重试结束后,主窗口还会进行有界退避重试,回到窗口或网络恢复时可再次尝试。+错误与重试均按账号代际隔离。设置损坏不自动重置,原有显示开关和迁移归属检查继续保留;+本机恢复不修改 device-link 的远端目录缓存或重连策略。+| 阶段 | 代码入口与函数 | 相关验证位置 || ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- || 完整 Catalog / Registry 校验 | [catalog.ts](../../packages/model-providers/src/catalog.ts) `parseCatalog`;[modelAccessValidator.ts](../../packages/model-providers/src/modelAccessValidator.ts) `parseModelRegistry` | [catalog.test.ts](../../packages/model-providers/src/__tests__/catalog.test.ts)、[modelAccessValidator.test.ts](../../packages/model-providers/src/__tests__/modelAccessValidator.test.ts) |diff --git a/packages/maker-core/src/agents/pi/windows-git-path-powershell.test.ts b/packages/maker-core/src/agents/pi/windows-git-path-powershell.test.tsindex 36290d3919..7920552c0b 100644--- a/packages/maker-core/src/agents/pi/windows-git-path-powershell.test.ts+++ b/packages/maker-core/src/agents/pi/windows-git-path-powershell.test.ts@@ -105,8 +105,10 @@ describe('Windows Git PATH PowerShell probes', () => {expect(script).toContain('[void]$pending.Add(4321)');expect(script).toContain('Get-CimInstance Win32_Process');expect(script).toContain('ParentProcessId = ');+ expect(script).toContain('-ErrorAction SilentlyContinue');expect(script).toContain('$descendants.Count - 1');- expect(script).toContain('Stop-Process -Id ([int]$descendants[$index]) -Force');+ expect(script).toContain('Stop-Process -Id $childProcessId -Force');+ expect(script).toContain('taskkill.exe /PID $childProcessId /F /T');expect(script).not.toContain('C:\\');expect(() => buildWindowsDescendantCleanupScript(0)).toThrow(RangeError);});@@ -246,24 +248,22 @@ describe('Windows Git PATH PowerShell probes', () => {terminateWindowsPowerShellDescendants(powershell, coordinatorPid);- execFileSync(- powershell,- [- '-NoLogo',- '-NoProfile',- '-NonInteractive',- '-Command',- [- '$deadline = [DateTime]::UtcNow.AddSeconds(8)',- `while (Get-Process -Id ${childPid} -ErrorAction SilentlyContinue) {`,- ' if ([DateTime]::UtcNow -ge $deadline) { exit 1 }',- ' Start-Sleep -Milliseconds 50',- '}',- ].join('\n'),- ],- // PowerShell startup can exceed five seconds on a busy hosted Windows runner;- // the in-script deadline (8s) plus startup must fit the exec timeout.- { stdio: 'ignore', timeout: 15_000, windowsHide: true },+ // EncodedCommand avoids Windows argv splitting of a multi-line -Command.+ // Poll until the orphaned child is gone; a live child after cleanup is a real leak.+ const livenessCommand = Buffer.from(+ `if (Get-Process -Id ${childPid} -ErrorAction SilentlyContinue) { exit 1 } else { exit 0 }`,+ 'utf16le',+ ).toString('base64');+ await vi.waitFor(+ () => {+ const liveness = spawnSync(+ powershell,+ ['-NoLogo', '-NoProfile', '-NonInteractive', '-EncodedCommand', livenessCommand],+ { stdio: 'ignore', timeout: 10_000, windowsHide: true },+ );+ expect(liveness.status).toBe(0);+ },+ { timeout: 8_000, interval: 50 },);} finally {if (coordinatorPid) {diff --git a/packages/maker-core/src/agents/pi/windows-git-path-powershell.ts b/packages/maker-core/src/agents/pi/windows-git-path-powershell.tsindex 79b7e7b853..74b0a89409 100644--- a/packages/maker-core/src/agents/pi/windows-git-path-powershell.ts+++ b/packages/maker-core/src/agents/pi/windows-git-path-powershell.ts@@ -55,7 +55,7 @@ export function buildWindowsDescendantCleanupScript(rootProcessId: number): stri'while ($pending.Count -gt 0) {',' $parentProcessId = [int]$pending[0]',' $pending.RemoveAt(0)',- ' $children = @(Get-CimInstance Win32_Process -Filter ("ParentProcessId = " + $parentProcessId) -ErrorAction Stop)',+ ' $children = @(Get-CimInstance Win32_Process -Filter ("ParentProcessId = " + $parentProcessId) -ErrorAction SilentlyContinue)',' foreach ($child in $children) {',' $childProcessId = [int]$child.ProcessId',' [void]$descendants.Add($childProcessId)',@@ -63,7 +63,9 @@ export function buildWindowsDescendantCleanupScript(rootProcessId: number): stri' }','}','for ($index = $descendants.Count - 1; $index -ge 0; $index -= 1) {',- ' Stop-Process -Id ([int]$descendants[$index]) -Force -ErrorAction SilentlyContinue',+ ' $childProcessId = [int]$descendants[$index]',+ ' Stop-Process -Id $childProcessId -Force -ErrorAction SilentlyContinue',+ " & taskkill.exe /PID $childProcessId /F /T 2>$null | Out-Null",'}',].join('\n');}@@ -75,9 +77,13 @@ export function terminateWindowsPowerShellDescendants(): void {if (typeof rootProcessId !== 'number' || !Number.isInteger(rootProcessId) || rootProcessId <= 0) return;try {+ // EncodedCommand keeps the cleanup script as one argv on Windows. A+ // multiline -Command can be split or fail to parse, which leaves probe+ // descendants running after the coordinator has already exited.+ const encoded = Buffer.from(buildWindowsDescendantCleanupScript(rootProcessId), 'utf16le').toString('base64');execFileSync(powershell,- ['-NoLogo', '-NoProfile', '-NonInteractive', '-Command', buildWindowsDescendantCleanupScript(rootProcessId)],+ ['-NoLogo', '-NoProfile', '-NonInteractive', '-EncodedCommand', encoded],{stdio: 'ignore',timeout: WINDOWS_DESCENDANT_CLEANUP_TIMEOUT_MS,