Skip to content

armgit / cindy

Public Imported from GitHub
0

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

fix(desktop): 恢复模型列表初始化失败后的重试与错误提示 (#4589)

Lizi11a380099a4e
diff --git a/apps/desktop/src/renderer/App.tsx b/apps/desktop/src/renderer/App.tsx
index 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.ts
index 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.tsx
index 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.ts
index 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.tsx
index 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.tsx
new file mode 100644
index 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.tsx
index 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>}
<UnifiedModelPanel
deviceId={deviceId}
localProviderUsage={!deviceId && !providersOverride}
@@ -3082,6 +3097,7 @@ function ModelSelectorContentView({
</>
)}
{searchField}
+ {localCatalogNotice}
{/* 模型列表 —— 单栏;分段(供应商)或 flat。 */}
<div
diff --git a/apps/desktop/src/renderer/components/new-chat/__tests__/localModelCatalogNotice.test.tsx b/apps/desktop/src/renderer/components/new-chat/__tests__/localModelCatalogNotice.test.tsx
new file mode 100644
index 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.tsx
index 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 && (
<div
className="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.ts
index 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.json
index 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.json
index 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.json
index 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.json
index 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.json
index 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.ts
new file mode 100644
index 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.ts
index 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.ts
index 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: bool
function 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): Migr
if ((!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): Migr
const 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): Migr
readyForWrites: 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.md
index 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.md
index 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.ts
index 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.ts
index 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,