Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
fix(desktop): 采纳 review:栈外后退、删除清理、账号隔离与测试合并
WZBbiao0000a6155bbf
diff --git a/apps/desktop/src/renderer/components/layout/ChromeActions.tsx b/apps/desktop/src/renderer/components/layout/ChromeActions.tsxindex 11b14812fe..06df65d5dd 100644--- a/apps/desktop/src/renderer/components/layout/ChromeActions.tsx+++ b/apps/desktop/src/renderer/components/layout/ChromeActions.tsx@@ -39,6 +39,7 @@ import { useTranslation } from 'react-i18next';import { MenuButton } from '@/components/title-bar/MenuButton';import { ChromeIconButton } from '@/components/title-bar/ChromeIconButton';import { Tip } from '@/components/ui/tooltip';+import { useAuth } from '@/contexts/AuthContext';import { useMacFullscreen } from '@/hooks/useMacFullscreen';import { useAppShortcutDisplay } from '@/hooks/useAppShortcut';import { useSessionBrowseHistory } from '@/features/cc-agent/useSessionBrowseHistory';@@ -65,7 +66,11 @@ export function ChromeActions({}: ChromeActionsProps) {const { t } = useTranslation();const { isMac, isFullscreen } = useMacFullscreen();- const browseHistory = useSessionBrowseHistory();+ // 浏览栈按数据所有者(账号 + 恢复代次)隔离:切号时不能把上一个账号的任务带过来。+ const { dataOwnerId, dataOwnerRecoveryEpoch } = useAuth();+ const browseHistory = useSessionBrowseHistory({+ ownerKey: `${dataOwnerId ?? 'signed-out'}:${dataOwnerRecoveryEpoch}`,+ });// 钉死左上角:mac 非全屏让位红绿灯(78),其余 8。不随侧栏状态变化。const x =@@ -111,8 +116,8 @@ export function ChromeActions({}/>{/* 任务浏览历史:与浏览器同惯例,左键后退、右键前进;到边界置灰并把- tooltip 换成「为什么不可用」。形状与相邻的菜单/折叠按钮同为 28px- rounded-md(ChromeIconButton 默认圆角留给 TabBar)。 */}+ tooltip 换成「为什么不可用」。尺寸与相邻的菜单/折叠按钮同为 28px,+ 圆角走 ChromeIconButton 默认的控件 pill(DESIGN §5)。 */}<SessionHistoryButtons {...browseHistory} /></div>);@@ -138,7 +143,7 @@ export function SessionHistoryButtons({return (<><ChromeIconButton- className="rounded-md disabled:opacity-40"+ className="disabled:opacity-40"disabled={!canBack}onClick={goBack}tooltip={withShortcut(t('titleBar.historyBack'), backShortcut)}@@ -149,7 +154,7 @@ export function SessionHistoryButtons({<ArrowLeft size={15} /></ChromeIconButton><ChromeIconButton- className="rounded-md disabled:opacity-40"+ className="disabled:opacity-40"disabled={!canForward}onClick={goForward}tooltip={withShortcut(t('titleBar.historyForward'), forwardShortcut)}diff --git a/apps/desktop/src/renderer/components/layout/__tests__/ChromeActions.fullscreen.test.tsx b/apps/desktop/src/renderer/components/layout/__tests__/ChromeActions.fullscreen.test.tsxindex e8508e08c0..13cf493f16 100644--- a/apps/desktop/src/renderer/components/layout/__tests__/ChromeActions.fullscreen.test.tsx+++ b/apps/desktop/src/renderer/components/layout/__tests__/ChromeActions.fullscreen.test.tsx@@ -1,11 +1,43 @@// @vitest-environment jsdom+/**+ * 测试价值+ * - 生产入口与可观察结果:真实 ChromeActions(左上按钮簇)/ SessionHistoryButtons+ * 与真实 hook(useSessionBrowseHistory)。可观察结果是按钮可用/置灰、tooltip+ * 文案,以及点击与 ⌘[ / ⌘] 之后路由落在哪个任务。+ * - Bug / 规则依据:新功能「任务浏览栈」—— 没有上一个/下一个任务时置灰并说明原因+ * (DESIGN §14.6);后退/前进按浏览器语义走栈;栈外页面后退先回最近任务;+ * 打不开的历史目标要摘掉,不能把用户送进死路;快捷键与按钮同一份栈。+ * - 现有覆盖缺口:原文件只覆盖 fullscreen 兜底;这里补历史导航(同模块用例并入,+ * 不另起收集单元)。+ * - 最小失败输入:在 /cc-agent/a 断言后退可用(应为否);或从草稿页后退直接落到+ * A(应回到最近的 B)。+ * - tier:unit(jsdom,MemoryRouter + 真实 registry 组合键)。+ */-import { cleanup, fireEvent, render, screen } from '@testing-library/react';+import { act, cleanup, fireEvent, render, screen, waitFor } from '@testing-library/react';+import userEvent from '@testing-library/user-event';import type { ReactNode } from 'react';-import { MemoryRouter } from 'react-router-dom';+import { MemoryRouter, useLocation, useNavigate } from 'react-router-dom';import { afterEach, describe, expect, it, vi } from 'vitest';const fullscreenState = vi.hoisted(() => ({ isMac: true, isFullscreen: true }));+/** 任务删除广播的来源(sessionsStore.patchLocal 的回调)。 */+const sessionPatches = vi.hoisted(() => {+ type Listener = (id: string, patch: { status?: string }, row: null) => void;+ const listeners = new Set<Listener>();+ return {+ emit(id: string, patch: { status?: string }) {+ for (const listener of listeners) listener(id, patch, null);+ },+ subscribePatches(listener: Listener) {+ listeners.add(listener);+ return () => listeners.delete(listener);+ },+ clear() {+ listeners.clear();+ },+ };+});vi.mock('react-i18next', () => ({useTranslation: () => ({ t: (key: string) => key }),@@ -13,6 +45,12 @@ vi.mock('react-i18next', () => ({vi.mock('@/hooks/useMacFullscreen', () => ({useMacFullscreen: () => fullscreenState,}));+vi.mock('@/contexts/AuthContext', () => ({+ useAuth: () => ({ dataOwnerId: 'owner-a', dataOwnerRecoveryEpoch: 1 }),+}));+vi.mock('@/lib/sessionsStore', () => ({+ sessionsStore: { subscribePatches: sessionPatches.subscribePatches },+}));vi.mock('@/components/ui/dropdown-menu', () => ({DropdownMenu: ({ children }: { children: ReactNode }) => <>{children}</>,DropdownMenuContent: ({ children }: { children: ReactNode }) => <div>{children}</div>,@@ -22,7 +60,17 @@ vi.mock('@/components/ui/dropdown-menu', () => ({DropdownMenuTrigger: ({ children }: { children: ReactNode }) => <>{children}</>,}));-import { ChromeActions } from '../ChromeActions';+import { ChromeActions, SessionHistoryButtons } from '../ChromeActions';+import {+ formatAppShortcutCombo,+ getEffectiveAppShortcuts,+ type AppShortcutId,+} from '../../../../shared/appShortcuts';+import { createSessionBrowseHistory } from '@/features/cc-agent/sessionBrowseHistory';+import type { SessionBrowseHistory } from '@/features/cc-agent/sessionBrowseHistory';+import { useSessionBrowseHistory } from '@/features/cc-agent/useSessionBrowseHistory';+import { getAppShortcutPlatform } from '@/lib/appShortcutStore';+vi.mock('@/features/device-link/useSharedTaskTasks', () => ({ useSharedTaskTasks: vi.fn() }));vi.mock('@/features/device-link/JoinSharedTaskDialog', () => ({ JoinSharedTaskDialog: () => null }));vi.mock('@/features/device-link/SharedTaskEndedNotice', () => ({ SharedTaskEndedNotice: () => null }));@@ -31,6 +79,7 @@ afterEach(() => {cleanup();fullscreenState.isMac = true;fullscreenState.isFullscreen = true;+ sessionPatches.clear();delete (window as Partial<Window>).electronAPI;});@@ -64,3 +113,165 @@ describe('ChromeActions fullscreen fallback', () => {expect(screen.queryByRole('button', { name: 'contentHeader.exitFullscreen' })).toBeNull();});});++function PathLabel(): React.ReactElement {+ const { pathname } = useLocation();+ return <span data-testid="path">{pathname}</span>;+}++function OpenTask({ id }: { id: string }): React.ReactElement {+ const navigate = useNavigate();+ return <button onClick={() => navigate(`/cc-agent/${id}`)}>{`open ${id}`}</button>;+}++function OpenDraft(): React.ReactElement {+ const navigate = useNavigate();+ return <button onClick={() => navigate('/cc-agent/new')}>open draft</button>;+}++function Harness({ history }: { history: SessionBrowseHistory }): React.ReactElement {+ return (+ <>+ <SessionHistoryButtons {...useSessionBrowseHistory({ history })} />+ <PathLabel />+ <OpenTask id="b" />+ <OpenTask id="c" />+ <OpenDraft />+ </>+ );+}++function renderAt(pathname: string): SessionBrowseHistory {+ const history = createSessionBrowseHistory();+ render(+ <MemoryRouter initialEntries={[pathname]}>+ <Harness history={history} />+ </MemoryRouter>,+ );+ return history;+}++function defaultCombo(id: AppShortcutId) {+ const platform = getAppShortcutPlatform();+ const combo = getEffectiveAppShortcuts({}, platform).get(id)?.[0];+ if (!combo) throw new Error(`no default combo for ${id}`);+ return { platform, combo };+}++function press(combo: { code: string; meta: boolean; ctrl: boolean; alt: boolean; shift: boolean }) {+ fireEvent.keyDown(window, {+ code: combo.code,+ metaKey: combo.meta,+ ctrlKey: combo.ctrl,+ altKey: combo.alt,+ shiftKey: combo.shift,+ });+}++describe('session browse history buttons', () => {+ it('greys both directions out on the first task and says why', () => {+ renderAt('/cc-agent/a');++ expect(screen.getByTestId('path').textContent).toBe('/cc-agent/a');+ expect(+ screen+ .getByRole('button', { name: 'titleBar.historyBackUnavailable' })+ .getAttribute('aria-disabled'),+ ).toBe('true');+ expect(+ screen+ .getByRole('button', { name: 'titleBar.historyForwardUnavailable' })+ .getAttribute('aria-disabled'),+ ).toBe('true');+ });++ it('walks back to the previous task and forward again, state following the stack', async () => {+ const user = userEvent.setup();+ renderAt('/cc-agent/a');++ await user.click(screen.getByRole('button', { name: 'open b' }));+ expect(screen.getByTestId('path').textContent).toBe('/cc-agent/b');++ const back = screen.getByRole('button', { name: 'titleBar.historyBack' });+ expect(back.hasAttribute('disabled')).toBe(false);++ await user.click(back);+ expect(screen.getByTestId('path').textContent).toBe('/cc-agent/a');+ expect(screen.getByRole('button', { name: 'titleBar.historyBackUnavailable' })).toBeTruthy();++ await user.click(screen.getByRole('button', { name: 'titleBar.historyForward' }));+ expect(screen.getByTestId('path').textContent).toBe('/cc-agent/b');+ expect(screen.getByRole('button', { name: 'titleBar.historyForwardUnavailable' })).toBeTruthy();+ });++ it('drops the forward side when a different task opens after going back', async () => {+ const user = userEvent.setup();+ renderAt('/cc-agent/a');++ await user.click(screen.getByRole('button', { name: 'open b' }));+ await user.click(screen.getByRole('button', { name: 'open c' }));+ await user.click(screen.getByRole('button', { name: 'titleBar.historyBack' }));+ expect(screen.getByTestId('path').textContent).toBe('/cc-agent/b');++ await user.click(screen.getByRole('button', { name: 'open c' }));+ expect(screen.getByTestId('path').textContent).toBe('/cc-agent/c');+ expect(screen.getByRole('button', { name: 'titleBar.historyForwardUnavailable' })).toBeTruthy();+ });++ it('returns to the most recent task first when going back from a page outside the stack', async () => {+ const user = userEvent.setup();+ renderAt('/cc-agent/a');++ await user.click(screen.getByRole('button', { name: 'open b' }));+ await user.click(screen.getByRole('button', { name: 'open draft' }));+ expect(screen.getByTestId('path').textContent).toBe('/cc-agent/new');++ const back = screen.getByRole('button', { name: 'titleBar.historyBack' });+ expect(back.hasAttribute('disabled')).toBe(false);+ await user.click(back);+ expect(screen.getByTestId('path').textContent).toBe('/cc-agent/b');++ await user.click(screen.getByRole('button', { name: 'titleBar.historyBack' }));+ expect(screen.getByTestId('path').textContent).toBe('/cc-agent/a');+ });++ it('forgets a task as soon as it is deleted instead of offering it again', async () => {+ const user = userEvent.setup();+ renderAt('/cc-agent/a');++ await user.click(screen.getByRole('button', { name: 'open b' }));+ act(() => sessionPatches.emit('a', { status: 'deleted' }));++ await waitFor(() =>+ expect(+ screen.getByRole('button', { name: 'titleBar.historyBackUnavailable' }),+ ).toBeTruthy(),+ );+ expect(screen.getByTestId('path').textContent).toBe('/cc-agent/b');+ });++ it('names the shortcut in the tooltip', async () => {+ const user = userEvent.setup();+ renderAt('/cc-agent/a');+ await user.click(screen.getByRole('button', { name: 'open b' }));++ const { platform, combo } = defaultCombo('session-history-back');+ await user.hover(screen.getByRole('button', { name: 'titleBar.historyBack' }));++ expect((await screen.findByRole('tooltip')).textContent).toBe(+ `titleBar.historyBack (${formatAppShortcutCombo(combo, platform)})`,+ );+ });++ it('walks the same stack from the keyboard shortcut', async () => {+ renderAt('/cc-agent/a');+ fireEvent.click(screen.getByRole('button', { name: 'open b' }));+ expect(screen.getByTestId('path').textContent).toBe('/cc-agent/b');++ press(defaultCombo('session-history-back').combo);+ await waitFor(() => expect(screen.getByTestId('path').textContent).toBe('/cc-agent/a'));++ press(defaultCombo('session-history-forward').combo);+ await waitFor(() => expect(screen.getByTestId('path').textContent).toBe('/cc-agent/b'));+ });+});diff --git a/apps/desktop/src/renderer/components/layout/__tests__/ChromeActions.history.test.tsx b/apps/desktop/src/renderer/components/layout/__tests__/ChromeActions.history.test.tsxdeleted file mode 100644index ffa9c9517f..0000000000--- a/apps/desktop/src/renderer/components/layout/__tests__/ChromeActions.history.test.tsx+++ /dev/null@@ -1,155 +0,0 @@-// @vitest-environment jsdom-/**- * 测试价值- * - 生产入口与可观察结果:真实 hook(useSessionBrowseHistory)+ 真实按钮簇- * (SessionHistoryButtons)。可观察结果是按钮的可用/置灰态、tooltip 文案、- * 点击与 ⌘[ / ⌘] 之后路由落在哪个任务。- * - Bug / 规则依据:新功能「任务浏览栈」—— 没有上一个/下一个任务时置灰并说明- * 原因(DESIGN §14.6),后退/前进按浏览器语义走栈,快捷键与按钮同一份栈。- * - 现有覆盖缺口:新组件。- * - 最小失败输入:在 /cc-agent/a 渲染后断言后退可用(应为否);或点后退后- * URL 没回到上一个任务。- * - tier:unit(jsdom,MemoryRouter + 真实 registry 组合键)。- */--import { cleanup, fireEvent, render, screen, waitFor } from '@testing-library/react';-import userEvent from '@testing-library/user-event';-import { MemoryRouter, useLocation, useNavigate } from 'react-router-dom';-import { afterEach, describe, expect, it, vi } from 'vitest';--vi.mock('react-i18next', () => ({- useTranslation: () => ({ t: (key: string) => key }),-}));-vi.mock('@/components/title-bar/MenuButton', () => ({ MenuButton: () => null }));--import { SessionHistoryButtons } from '@/components/layout/ChromeActions';-import {- formatAppShortcutCombo,- getEffectiveAppShortcuts,- type AppShortcutId,-} from '../../../../shared/appShortcuts';-import { createSessionBrowseHistory } from '@/features/cc-agent/sessionBrowseHistory';-import { useSessionBrowseHistory } from '@/features/cc-agent/useSessionBrowseHistory';-import { getAppShortcutPlatform } from '@/lib/appShortcutStore';--afterEach(cleanup);--function PathLabel(): React.ReactElement {- const { pathname } = useLocation();- return <span data-testid="path">{pathname}</span>;-}--function OpenTask({ id }: { id: string }): React.ReactElement {- const navigate = useNavigate();- return <button onClick={() => navigate(`/cc-agent/${id}`)}>{`open ${id}`}</button>;-}--function Harness({ history }: { history: ReturnType<typeof createSessionBrowseHistory> }): React.ReactElement {- return (- <>- <SessionHistoryButtons {...useSessionBrowseHistory(history)} />- <PathLabel />- <OpenTask id="b" />- <OpenTask id="c" />- </>- );-}--function renderAt(pathname: string) {- const history = createSessionBrowseHistory();- render(- <MemoryRouter initialEntries={[pathname]}>- <Harness history={history} />- </MemoryRouter>,- );- return history;-}--function defaultCombo(id: AppShortcutId) {- const platform = getAppShortcutPlatform();- const combo = getEffectiveAppShortcuts({}, platform).get(id)?.[0];- if (!combo) throw new Error(`no default combo for ${id}`);- return { platform, combo };-}--function press(combo: { code: string; meta: boolean; ctrl: boolean; alt: boolean; shift: boolean }) {- fireEvent.keyDown(window, {- code: combo.code,- metaKey: combo.meta,- ctrlKey: combo.ctrl,- altKey: combo.alt,- shiftKey: combo.shift,- });-}--describe('SessionHistoryButtons', () => {- it('greys both directions out on the first task and says why', () => {- renderAt('/cc-agent/a');-- expect(screen.getByTestId('path').textContent).toBe('/cc-agent/a');- expect(- (screen.getByRole('button', { name: 'titleBar.historyBackUnavailable' }) as HTMLElement).getAttribute('aria-disabled'),- ).toBe('true');- expect(- (screen.getByRole('button', { name: 'titleBar.historyForwardUnavailable' }) as HTMLElement).getAttribute('aria-disabled'),- ).toBe('true');- });-- it('walks back to the previous task and forward again, state following the stack', async () => {- const user = userEvent.setup();- renderAt('/cc-agent/a');-- await user.click(screen.getByRole('button', { name: 'open b' }));- expect(screen.getByTestId('path').textContent).toBe('/cc-agent/b');-- const back = screen.getByRole('button', { name: 'titleBar.historyBack' });- expect(back.hasAttribute('disabled')).toBe(false);-- await user.click(back);- expect(screen.getByTestId('path').textContent).toBe('/cc-agent/a');- expect(screen.getByRole('button', { name: 'titleBar.historyBackUnavailable' })).toBeTruthy();-- await user.click(screen.getByRole('button', { name: 'titleBar.historyForward' }));- expect(screen.getByTestId('path').textContent).toBe('/cc-agent/b');- expect(screen.getByRole('button', { name: 'titleBar.historyForwardUnavailable' })).toBeTruthy();- });-- it('drops the forward side when a different task opens after going back', async () => {- const user = userEvent.setup();- renderAt('/cc-agent/a');-- await user.click(screen.getByRole('button', { name: 'open b' }));- await user.click(screen.getByRole('button', { name: 'open c' }));- await user.click(screen.getByRole('button', { name: 'titleBar.historyBack' }));- expect(screen.getByTestId('path').textContent).toBe('/cc-agent/b');-- await user.click(screen.getByRole('button', { name: 'open c' }));- expect(screen.getByTestId('path').textContent).toBe('/cc-agent/c');- expect(screen.getByRole('button', { name: 'titleBar.historyForwardUnavailable' })).toBeTruthy();- });-- it('names the shortcut in the tooltip', async () => {- const user = userEvent.setup();- renderAt('/cc-agent/a');- await user.click(screen.getByRole('button', { name: 'open b' }));-- const { platform, combo } = defaultCombo('session-history-back');- await user.hover(screen.getByRole('button', { name: 'titleBar.historyBack' }));-- expect((await screen.findByRole('tooltip')).textContent).toBe(- `titleBar.historyBack (${formatAppShortcutCombo(combo, platform)})`,- );- });-- it('walks the same stack from the keyboard shortcut', async () => {- renderAt('/cc-agent/a');- fireEvent.click(screen.getByRole('button', { name: 'open b' }));- expect(screen.getByTestId('path').textContent).toBe('/cc-agent/b');-- press(defaultCombo('session-history-back').combo);- await waitFor(() => expect(screen.getByTestId('path').textContent).toBe('/cc-agent/a'));-- press(defaultCombo('session-history-forward').combo);- await waitFor(() => expect(screen.getByTestId('path').textContent).toBe('/cc-agent/b'));- });-});diff --git a/apps/desktop/src/renderer/features/cc-agent/__tests__/sessionBrowseHistory.test.ts b/apps/desktop/src/renderer/features/cc-agent/__tests__/sessionBrowseHistory.test.tsindex d6b041fe1b..5933d562e5 100644--- a/apps/desktop/src/renderer/features/cc-agent/__tests__/sessionBrowseHistory.test.ts+++ b/apps/desktop/src/renderer/features/cc-agent/__tests__/sessionBrowseHistory.test.ts@@ -3,9 +3,9 @@* - 生产入口与可观察结果:createSessionBrowseHistory(窗口内唯一的浏览栈)与* sessionIdFromPathname(路由 → 任务 id 的判定)。可观察结果是栈内容与后退/* 前进落到哪个任务。- * - Bug / 规则依据:新功能「任务浏览栈」—— 后退永远落在任务视图上,同一任务+ * - 规则依据:新功能「任务浏览栈」—— 后退永远落在任务视图上,同一任务* 重复导航不占格,走到中间再打开新任务要截断前进侧,到边界必须返回 null- * 让按钮置灰。+ * 让按钮置灰;已删除的任务要能从栈里摘掉;换账号必须清空,不能串号。* - 现有覆盖缺口:新模块。* - 最小失败输入:record('a'); record('b'); step(-1) 之后再 record('c')。* - tier:unit(node,纯逻辑)。@@ -100,6 +100,48 @@ describe('createSessionBrowseHistory', () => {expect(listener).toHaveBeenCalledTimes(1);});+ it('forgets a task that was deleted and keeps the cursor on a live entry', () => {+ const history = createSessionBrowseHistory();+ history.record('a');+ history.record('b');+ history.record('c');+ history.step(-1);++ history.forget('a');++ expect(history.snapshot()).toEqual({ ids: ['b', 'c'], index: 0 });+ expect(history.step(-1)).toBeNull();+ expect(history.step(1)).toBe('c');+ });++ it('drops every occurrence of a forgotten task and clamps an emptied stack', () => {+ const history = createSessionBrowseHistory();+ history.record('a');+ history.record('b');+ history.record('a');++ history.forget('a');+ expect(history.snapshot()).toEqual({ ids: ['b'], index: 0 });++ history.forget('b');+ expect(history.snapshot()).toEqual({ ids: [], index: -1 });+ });++ it('clears the stack only when the data owner changes', () => {+ const history = createSessionBrowseHistory();+ history.record('a');++ history.bindOwner('owner-1');+ expect(history.snapshot()).toEqual({ ids: [], index: -1 });++ history.record('b');+ history.bindOwner('owner-1');+ expect(history.snapshot()).toEqual({ ids: ['b'], index: 0 });++ history.bindOwner('owner-2');+ expect(history.snapshot()).toEqual({ ids: [], index: -1 });+ });+it('keeps the snapshot identity stable between changes for useSyncExternalStore', () => {const history = createSessionBrowseHistory();history.record('a');diff --git a/apps/desktop/src/renderer/features/cc-agent/sessionBrowseHistory.ts b/apps/desktop/src/renderer/features/cc-agent/sessionBrowseHistory.tsindex 3712cea8b2..5e9a516666 100644--- a/apps/desktop/src/renderer/features/cc-agent/sessionBrowseHistory.ts+++ b/apps/desktop/src/renderer/features/cc-agent/sessionBrowseHistory.ts@@ -34,12 +34,17 @@ export interface SessionBrowseHistory {record(sessionId: string): void;/** 沿栈走一步;到边界返回 null(调用方据此置灰/不消费快捷键)。 */step(direction: -1 | 1): string | null;+ /** 任务已删 / 打不开:把它从栈里摘掉(可能多处),游标落在原来的位置附近。 */+ forget(sessionId: string): void;+ /** 账号(数据所有者)已切换:整栈清空,不把上一个账号的任务带进新账号。 */+ bindOwner(ownerKey: string): void;snapshot(): SessionBrowseSnapshot;subscribe(listener: () => void): () => void;}export function createSessionBrowseHistory(maxEntries = MAX_ENTRIES): SessionBrowseHistory {let state: SessionBrowseSnapshot = { ids: [], index: -1 };+ let ownerKey = '';const listeners = new Set<() => void>();const commit = (next: SessionBrowseSnapshot) => {state = next;@@ -60,6 +65,19 @@ export function createSessionBrowseHistory(maxEntries = MAX_ENTRIES): SessionBrocommit({ ids: state.ids, index: next });return state.ids[next];},+ forget(sessionId) {+ if (!state.ids.includes(sessionId)) return;+ // 游标前保留的条数就是新游标;越界时钳到末尾,空栈回到 -1。+ const keptBefore = state.ids.slice(0, Math.max(0, state.index)).filter((id) => id !== sessionId).length;+ const ids = state.ids.filter((id) => id !== sessionId);+ commit({ ids, index: ids.length === 0 ? -1 : Math.min(keptBefore, ids.length - 1) });+ },+ bindOwner(nextOwnerKey) {+ if (nextOwnerKey === ownerKey) return;+ ownerKey = nextOwnerKey;+ if (state.ids.length === 0) return;+ commit({ ids: [], index: -1 });+ },snapshot: () => state,subscribe(listener) {listeners.add(listener);diff --git a/apps/desktop/src/renderer/features/cc-agent/useSessionBrowseHistory.ts b/apps/desktop/src/renderer/features/cc-agent/useSessionBrowseHistory.tsindex 8cf86fa6e1..9a21bb0530 100644--- a/apps/desktop/src/renderer/features/cc-agent/useSessionBrowseHistory.ts+++ b/apps/desktop/src/renderer/features/cc-agent/useSessionBrowseHistory.ts@@ -1,14 +1,21 @@/*** useSessionBrowseHistory —— 把当前任务视图记进浏览栈,并接上后退/前进。*- * 快捷键与按钮共用同一份栈(cc-agent/sessionBrowseHistory);`history` 参数只- * 为测试注入独立实例,生产调用不传,直接用窗口内唯一的单例。+ * 两个不变量:+ * 1) 游标只在目标路由真的落下后才移动。被 useBlocker / 离开确认拦下的导航不会+ * 留下错位的游标(否则后退键会莫名置灰或跳一项)。+ * 2) 站在栈外页面(草稿、设置…)时,后退先回到最近看过的那个任务,而不是再往前+ * 跳一格 —— 与浏览器从「非历史页」后退的语义一致。+ *+ * `history` / `ownerKey` 只由调用方注入(测试传独立实例;生产用窗口内单例 ++ * 当前账号),不传则退化为单例和空 owner。*/-import { useCallback, useEffect, useSyncExternalStore } from 'react';+import { useCallback, useEffect, useRef, useSyncExternalStore } from 'react';import { useLocation, useNavigate } from 'react-router-dom';import { useAppShortcut } from '@/hooks/useAppShortcut';+import { sessionsStore } from '@/lib/sessionsStore';import {sessionBrowseHistory,sessionIdFromPathname,@@ -22,32 +29,87 @@ export interface SessionBrowseNavigation {goForward: () => boolean;}+/** 正在等落地的导航:direction=0 表示「回到游标所在任务」,不移动游标。 */+interface PendingHop {+ direction: -1 | 1 | 0;+ target: string;+}++export interface UseSessionBrowseHistoryOptions {+ history?: SessionBrowseHistory;+ /** 数据所有者键(账号 + 恢复代次);变化时清空栈,避免跨账号串历史。 */+ ownerKey?: string;+}+export function useSessionBrowseHistory(- history: SessionBrowseHistory = sessionBrowseHistory,+ options: UseSessionBrowseHistoryOptions = {},): SessionBrowseNavigation {+ const history = options.history ?? sessionBrowseHistory;const location = useLocation();const navigate = useNavigate();const { ids, index } = useSyncExternalStore(history.subscribe, history.snapshot);const sessionId = sessionIdFromPathname(location.pathname);+ const pendingRef = useRef<PendingHop | null>(null);+ const lastPathRef = useRef(location.pathname);++ useEffect(() => {+ if (options.ownerKey !== undefined) history.bindOwner(options.ownerKey);+ }, [history, options.ownerKey]);++ useEffect(() => {+ // 任务被删除时(本窗口或其它窗口的广播都走 sessionsStore.patchLocal)立即摘掉,+ // 后退不会把用户送到一个已经打不开的任务上。+ return sessionsStore.subscribePatches((id, patch) => {+ if (patch.status === 'deleted') history.forget(id);+ });+ }, [history]);useEffect(() => {+ const pending = pendingRef.current;+ if (pending) {+ if (sessionId === pending.target) {+ pendingRef.current = null;+ if (pending.direction !== 0) history.step(pending.direction);+ return;+ }+ // 导航去了别处(被拦下时路由根本不会变,这里不会误清):丢掉这次待提交。+ const pathChanged = location.pathname !== lastPathRef.current;+ lastPathRef.current = location.pathname;+ if (pathChanged) pendingRef.current = null;+ } else {+ lastPathRef.current = location.pathname;+ }if (sessionId) history.record(sessionId);- }, [history, sessionId]);+ }, [history, location.pathname, sessionId]);+ const onStack = sessionId !== null && ids[index] === sessionId;const go = useCallback((direction: -1 | 1) => {- const target = history.step(direction);- if (!target) return false;- navigate(`/cc-agent/${target}`);+ const snap = history.snapshot();+ const current = sessionIdFromPathname(location.pathname);+ const onStackNow = current !== null && snap.ids[snap.index] === current;+ if (!onStackNow) {+ // 栈外页面(草稿 / 设置 / 自动任务…):后退只回到最近那个任务。+ if (direction === 1) return false;+ const target = snap.ids[snap.index];+ if (!target) return false;+ pendingRef.current = { direction: 0, target };+ navigate(`/cc-agent/${target}`);+ return true;+ }+ const next = snap.index + direction;+ if (next < 0 || next >= snap.ids.length) return false;+ pendingRef.current = { direction, target: snap.ids[next] };+ navigate(`/cc-agent/${snap.ids[next]}`);return true;},- [history, navigate],+ [history, location.pathname, navigate],);const goBack = useCallback(() => go(-1), [go]);const goForward = useCallback(() => go(1), [go]);- // Windows / Linux 上 mod+[ 在终端里是 ESC(vim / readline):焦点在终端时让给 PTY,- // 不做窗口级导航。mac 的 ⌘[ 在终端无原生含义,同一道门一并让路无副作用。+ // Windows / Linux 上 mod+[ 在终端里是 ESC(vim / readline):焦点在终端时让给 PTY,+ // 不做窗口级导航。mac 的 ⌘[ 在终端无原生含义,同一道门一并让路无副作用。const outsideTerminal = (event: KeyboardEvent) =>!(event.target instanceof Element && event.target.closest('.xterm'));@@ -55,8 +117,8 @@ export function useSessionBrowseHistory(useAppShortcut('session-history-forward', (event) => outsideTerminal(event) && goForward());return {- canBack: index > 0,- canForward: index >= 0 && index < ids.length - 1,+ canBack: onStack ? index > 0 : index >= 0,+ canForward: onStack && index >= 0 && index < ids.length - 1,goBack,goForward,};diff --git a/docs/design-rules/design-inventory.md b/docs/design-rules/design-inventory.mdindex 96de71c264..85a8714146 100644--- a/docs/design-rules/design-inventory.md+++ b/docs/design-rules/design-inventory.md@@ -39,7 +39,7 @@| `desktop.plugins.app-main` | desktop | 插件主视图 | hash `/apps/:ghostId`(GhostMainViewFeatureLayout) | GhostMainViewFeatureLayout, GhostMainViewHost | apps/desktop/src/renderer/features/plugin/GhostMainViewFeatureLayout.tsx, apps/desktop/src/renderer/features/plugin/GhostMainViewHost.tsx | 0 | 0 | 0 || `desktop.plugins.installed` | desktop | 已装插件 | hash `/plugins`(GhostPluginPage) | AddMarketplaceDialog, GhostPluginActions, GhostPluginDetailView, GhostPluginPage, MarketPluginDetailView, MyPublishesSection, PluginDevicePicker, PluginManagementLayout, PluginProjectMenu, RemotePluginConfiguration, RemotePluginPage, RemotePluginReadOnlyDetail, UpdateAllDialog | apps/desktop/src/renderer/features/plugin/AddMarketplaceDialog.tsx, apps/desktop/src/renderer/features/plugin/GhostPluginActions.tsx, apps/desktop/src/renderer/features/plugin/GhostPluginDetailView.tsx, apps/desktop/src/renderer/features/plugin/GhostPluginPage.tsx, apps/desktop/src/renderer/features/plugin/MarketPluginDetailView.tsx, apps/desktop/src/renderer/features/plugin/MyPublishesSection.tsx, apps/desktop/src/renderer/features/plugin/PluginDevicePicker.tsx, apps/desktop/src/renderer/features/plugin/PluginManagementLayout.tsx, apps/desktop/src/renderer/features/plugin/PluginScopePicker.tsx, apps/desktop/src/renderer/features/plugin/RemotePluginConfiguration.tsx, apps/desktop/src/renderer/features/plugin/RemotePluginPage.tsx, apps/desktop/src/renderer/features/plugin/RemotePluginReadOnlyDetail.tsx, apps/desktop/src/renderer/features/plugin/UpdateAllDialog.tsx, apps/desktop/src/renderer/features/plugin/plugin-motion.css | 28 | 0 | 48 || `desktop.settings` | desktop | 设置 | hash `/settings`(SettingsView;tab 含 general / personalization / providers / billing / usage / voice-input / im-bot / shortcuts / agent-island / import / remote-control / ghosts / builtin-tools / computer-use / help / about) | SettingsView | apps/desktop/src/renderer/components/settings/AboutSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AboutSection.tsx, apps/desktop/src/renderer/components/settings/AccountDeletionSection.tsx, apps/desktop/src/renderer/components/settings/AddProviderWizard.tsx, apps/desktop/src/renderer/components/settings/AgentIslandSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AgentIslandSection.tsx, apps/desktop/src/renderer/components/settings/AgentResourceSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AgentResourceSection.tsx, apps/desktop/src/renderer/components/settings/AppearanceSection.settings-search.ts, apps/desktop/src/renderer/components/settings/AppearanceSection.tsx, apps/desktop/src/renderer/components/settings/AuxiliaryModelSection.tsx, apps/desktop/src/renderer/components/settings/AvatarCropEditor.tsx, apps/desktop/src/renderer/components/settings/BetaChannelCell.tsx, apps/desktop/src/renderer/components/settings/BillingSettings.settings-search.ts, apps/desktop/src/renderer/components/settings/BrowserBackendSubsection.tsx, apps/desktop/src/renderer/components/settings/BrowserRealProfileSubsection.tsx, apps/desktop/src/renderer/components/settings/BuiltinToolsSection.settings-search.ts, apps/desktop/src/renderer/components/settings/BuiltinToolsSection.tsx, apps/desktop/src/renderer/components/settings/ChatEmbeddingCell.tsx, apps/desktop/src/renderer/components/settings/ChipMetricsSection.tsx, apps/desktop/src/renderer/components/settings/CindyMakeSection.settings-search.ts, apps/desktop/src/renderer/components/settings/CindyMakeSection.tsx, apps/desktop/src/renderer/components/settings/CollaborationSection.settings-search.ts, apps/desktop/src/renderer/components/settings/CollaborationSection.tsx, apps/desktop/src/renderer/components/settings/CompactionSection.tsx, apps/desktop/src/renderer/components/settings/ComposerSendShortcutSection.tsx, apps/desktop/src/renderer/components/settings/ComputerPermissionGuideWindow.tsx, apps/desktop/src/renderer/components/settings/ComputerPermissionRow.tsx, apps/desktop/src/renderer/components/settings/ComputerUseSection.settings-search.ts, apps/desktop/src/renderer/components/settings/ComputerUseSection.tsx, apps/desktop/src/renderer/components/settings/CustomProviderRuntimeFillOverlay.tsx, apps/desktop/src/renderer/components/settings/DefaultOverrideControls.tsx, apps/desktop/src/renderer/components/settings/DialogueDirectorySection.tsx, apps/desktop/src/renderer/components/settings/DingTalkBotSection.tsx, apps/desktop/src/renderer/components/settings/DiscordBotSection.tsx, apps/desktop/src/renderer/components/settings/DownloadMeter.tsx, apps/desktop/src/renderer/components/settings/ExperimentalSection.tsx, apps/desktop/src/renderer/components/settings/FeishuBotNotificationSection.tsx, apps/desktop/src/renderer/components/settings/FeishuBotSection.tsx, apps/desktop/src/renderer/components/settings/FontFamilyPicker.tsx, apps/desktop/src/renderer/components/settings/GeneralSettings.settings-search.ts, apps/desktop/src/renderer/components/settings/GenericGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/GitSafetySection.settings-search.ts, apps/desktop/src/renderer/components/settings/GitSafetySection.tsx, apps/desktop/src/renderer/components/settings/HarnessVersionMenuRow.tsx, apps/desktop/src/renderer/components/settings/HelpAssistantPanel.tsx, apps/desktop/src/renderer/components/settings/HelpSection.settings-search.ts, apps/desktop/src/renderer/components/settings/HelpSection.tsx, apps/desktop/src/renderer/components/settings/HelpThreadView.tsx, apps/desktop/src/renderer/components/settings/HookConnectionsSection.tsx, apps/desktop/src/renderer/components/settings/HookWorkspacePrefsEditor.tsx, apps/desktop/src/renderer/components/settings/ImBotSection.settings-search.ts, apps/desktop/src/renderer/components/settings/ImBotSection.tsx, apps/desktop/src/renderer/components/settings/ImChannelSettingsCard.tsx, apps/desktop/src/renderer/components/settings/ImDefaultSettingsSection.tsx, apps/desktop/src/renderer/components/settings/ImLifecycleAnnouncementSection.tsx, apps/desktop/src/renderer/components/settings/InputDeviceConnectionStatus.tsx, apps/desktop/src/renderer/components/settings/JoyConGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/KeyboardShortcutsSection.settings-search.ts, apps/desktop/src/renderer/components/settings/KeyboardShortcutsSection.tsx, apps/desktop/src/renderer/components/settings/LanguageSection.tsx, apps/desktop/src/renderer/components/settings/LayoutResetControl.tsx, apps/desktop/src/renderer/components/settings/LinkOpenSection.tsx, apps/desktop/src/renderer/components/settings/LlamaCppCandidates.tsx, apps/desktop/src/renderer/components/settings/LlamaCppProviderDetail.tsx, apps/desktop/src/renderer/components/settings/LocalModelDownloadUI.tsx, apps/desktop/src/renderer/components/settings/LocalOllamaInstall.tsx, apps/desktop/src/renderer/components/settings/LocalPackagingTag.tsx, apps/desktop/src/renderer/components/settings/LogoutSection.tsx, apps/desktop/src/renderer/components/settings/LspBetaCell.tsx, apps/desktop/src/renderer/components/settings/McpServerDialog.tsx, apps/desktop/src/renderer/components/settings/McpServersSection.tsx, apps/desktop/src/renderer/components/settings/MemorySection.tsx, apps/desktop/src/renderer/components/settings/MessageNavRailCell.tsx, apps/desktop/src/renderer/components/settings/ModelAdvancedDrawer.tsx, apps/desktop/src/renderer/components/settings/ModelPriceOverrideDialog.tsx, apps/desktop/src/renderer/components/settings/MyDevicesPanel.tsx, apps/desktop/src/renderer/components/settings/NotificationSection.settings-search.ts, apps/desktop/src/renderer/components/settings/NotificationSection.tsx, apps/desktop/src/renderer/components/settings/OAuthDeviceCodeCard.tsx, apps/desktop/src/renderer/components/settings/OllamaProviderDetail.tsx, apps/desktop/src/renderer/components/settings/OwnRemoteProviders.tsx, apps/desktop/src/renderer/components/settings/PersonalizationDetails.settings-search.ts, apps/desktop/src/renderer/components/settings/PersonalizationSettings.settings-search.ts, apps/desktop/src/renderer/components/settings/PiKernelVersionRow.tsx, apps/desktop/src/renderer/components/settings/PiPackagesSection.tsx, apps/desktop/src/renderer/components/settings/PlayStationGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/ProfileEditDialog.tsx, apps/desktop/src/renderer/components/settings/ProviderConnectionDialog.tsx, apps/desktop/src/renderer/components/settings/ProviderImportDialog.tsx, apps/desktop/src/renderer/components/settings/ProvidersSection.settings-search.ts, apps/desktop/src/renderer/components/settings/ProvidersSection.tsx, apps/desktop/src/renderer/components/settings/ReadOnlyProviderModels.tsx, apps/desktop/src/renderer/components/settings/RemoteControlSection.settings-search.ts, apps/desktop/src/renderer/components/settings/RemoteControlSection.tsx, apps/desktop/src/renderer/components/settings/RemoteDesktopPermissions.tsx, apps/desktop/src/renderer/components/settings/RemoteDesktopSetting.tsx, apps/desktop/src/renderer/components/settings/RemoteHostDetail.tsx, apps/desktop/src/renderer/components/settings/RemoteSection.tsx, apps/desktop/src/renderer/components/settings/SessionImportSection.settings-search.ts, apps/desktop/src/renderer/components/settings/SessionImportSection.tsx, apps/desktop/src/renderer/components/settings/SessionRuntimeFallbackCell.tsx, apps/desktop/src/renderer/components/settings/SessionShareImportWizard.tsx, apps/desktop/src/renderer/components/settings/SettingsCatalogPanel.settings-search.ts, apps/desktop/src/renderer/components/settings/SettingsCatalogPanel.tsx, apps/desktop/src/renderer/components/settings/SettingsSearchBox.tsx, apps/desktop/src/renderer/components/settings/SettingsSearchNavigation.ts, apps/desktop/src/renderer/components/settings/SettingsSidebarNav.tsx, apps/desktop/src/renderer/components/settings/SettingsTextInput.tsx, apps/desktop/src/renderer/components/settings/SettingsView.tsx, apps/desktop/src/renderer/components/settings/SharedTasks.settings-search.ts, apps/desktop/src/renderer/components/settings/SilentEncryptedRetryCell.tsx, apps/desktop/src/renderer/components/settings/SshKeySetupDialog.tsx, apps/desktop/src/renderer/components/settings/StorageManagementCard.settings-search.ts, apps/desktop/src/renderer/components/settings/StorageManagementCard.tsx, apps/desktop/src/renderer/components/settings/StreamFadeSection.tsx, apps/desktop/src/renderer/components/settings/SubagentModelSection.settings-search.ts, apps/desktop/src/renderer/components/settings/SubagentModelSection.tsx, apps/desktop/src/renderer/components/settings/SwitchProGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/TelegramBehaviorSettings.tsx, apps/desktop/src/renderer/components/settings/TelegramBotSection.tsx, apps/desktop/src/renderer/components/settings/TelegramRemoteDevices.tsx, apps/desktop/src/renderer/components/settings/TerminalShellSection.tsx, apps/desktop/src/renderer/components/settings/TipsSection.settings-search.ts, apps/desktop/src/renderer/components/settings/TipsSection.tsx, apps/desktop/src/renderer/components/settings/UnifiedModelList.tsx, apps/desktop/src/renderer/components/settings/UserProfileCard.tsx, apps/desktop/src/renderer/components/settings/UserPromptSection.tsx, apps/desktop/src/renderer/components/settings/VisionBridgeSection.settings-search.ts, apps/desktop/src/renderer/components/settings/VisionBridgeSection.tsx, apps/desktop/src/renderer/components/settings/VoiceInputSection.settings-search.ts, apps/desktop/src/renderer/components/settings/VoiceInputSection.tsx, apps/desktop/src/renderer/components/settings/VoiceSpeakerEnrollmentDialog.tsx, apps/desktop/src/renderer/components/settings/VoiceSpeakerFilterCard.tsx, apps/desktop/src/renderer/components/settings/WallpaperSection.tsx, apps/desktop/src/renderer/components/settings/WechatBotSection.tsx, apps/desktop/src/renderer/components/settings/WecomBotSection.tsx, apps/desktop/src/renderer/components/settings/WindowBehaviorSection.settings-search.ts, apps/desktop/src/renderer/components/settings/WindowBehaviorSection.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexKeyboardLayout.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexKeycapGlyphs.tsx, apps/desktop/src/renderer/components/settings/WorkLouderCodexSettings.tsx, apps/desktop/src/renderer/components/settings/WorktreeRecycleCard.settings-search.ts, apps/desktop/src/renderer/components/settings/WorktreeRecycleCard.tsx, apps/desktop/src/renderer/components/settings/XUsageGuide.tsx, apps/desktop/src/renderer/components/settings/XboxGamepadLayout.tsx, apps/desktop/src/renderer/components/settings/XboxGamepadSettings.tsx, apps/desktop/src/renderer/components/settings/androidStatusPresentation.ts, apps/desktop/src/renderer/components/settings/avatarCropGeometry.ts, apps/desktop/src/renderer/components/settings/avatarCropImage.ts, apps/desktop/src/renderer/components/settings/billingVisibility.ts, apps/desktop/src/renderer/components/settings/browserOpenForLoginError.ts, apps/desktop/src/renderer/components/settings/cindyMakeVisibility.ts, apps/desktop/src/renderer/components/settings/computerPermissionFlow.ts, apps/desktop/src/renderer/components/settings/contacts/ContactDetailPane.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsImportDialog.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsListPane.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsManagerDialog.tsx, apps/desktop/src/renderer/components/settings/contacts/ContactsSection.tsx, apps/desktop/src/renderer/components/settings/contacts/startContactsAiSession.ts, apps/desktop/src/renderer/components/settings/dialogueDirectoryDisplay.ts, apps/desktop/src/renderer/components/settings/dualSenseSilhouette.ts, apps/desktop/src/renderer/components/settings/feishuBotPresentation.ts, apps/desktop/src/renderer/components/settings/fontFamilyValue.ts, apps/desktop/src/renderer/components/settings/gamepadLayoutPrimitives.tsx, apps/desktop/src/renderer/components/settings/gamepadSilhouetteGeom.ts, apps/desktop/src/renderer/components/settings/hookWorkspacePrefsLogic.ts, apps/desktop/src/renderer/components/settings/imBotVisibility.ts, apps/desktop/src/renderer/components/settings/imDefaultSettingsLogic.ts, apps/desktop/src/renderer/components/settings/joyConSilhouette.ts, apps/desktop/src/renderer/components/settings/modelManagementPresentation.ts, apps/desktop/src/renderer/components/settings/modelManagementState.ts, apps/desktop/src/renderer/components/settings/myDevicesModel.ts, apps/desktop/src/renderer/components/settings/providerAssetModule.ts, apps/desktop/src/renderer/components/settings/realProfilePermissionGuide.ts, apps/desktop/src/renderer/components/settings/settingsRowClasses.ts, apps/desktop/src/renderer/components/settings/settingsSearchCatalog.ts, apps/desktop/src/renderer/components/settings/settingsSearchTypes.ts, apps/desktop/src/renderer/components/settings/switchProSilhouette.ts, apps/desktop/src/renderer/components/settings/ultimateC1Silhouette.ts, apps/desktop/src/renderer/components/settings/usage/UsageBarsTooltip.tsx, apps/desktop/src/renderer/components/settings/usage/UsageBreakdownTables.tsx, apps/desktop/src/renderer/components/settings/usage/UsageDeviceSelect.tsx, apps/desktop/src/renderer/components/settings/usage/UsageFilterSelect.tsx, apps/desktop/src/renderer/components/settings/usage/UsageHistorySection.settings-search.ts, apps/desktop/src/renderer/components/settings/usage/UsageHistorySection.tsx, apps/desktop/src/renderer/components/settings/usage/UsageStatRow.tsx, apps/desktop/src/renderer/components/settings/usage/UsageTaskTable.tsx, apps/desktop/src/renderer/components/settings/usage/UsageTokenBars.tsx, apps/desktop/src/renderer/components/settings/usage/formatUsagePercent.ts, apps/desktop/src/renderer/components/settings/usage/usageCharts.css, apps/desktop/src/renderer/components/settings/usage/usageHistoryColors.ts, apps/desktop/src/renderer/components/settings/usage/usageHistoryStats.ts, apps/desktop/src/renderer/components/settings/usageVisibility.ts, apps/desktop/src/renderer/components/settings/useProviderSubscriptionCard.ts, apps/desktop/src/renderer/components/settings/useSettingsEscape.ts, apps/desktop/src/renderer/components/settings/useSettingsSectionTarget.ts, apps/desktop/src/renderer/components/settings/wizardRecommend.ts, apps/desktop/src/renderer/components/settings/workLouderCodexCommandCopy.ts, apps/desktop/src/renderer/components/settings/xboxSeriesSilhouette.ts, apps/desktop/src/renderer/styles/sortable.css | 137 | 95 | 546 |-| `desktop.shell.main-layout` | desktop | 主窗口壳(标题栏 / 左右栏 / 内容区) | main BrowserWindow → renderer/index.tsx → main-entry.tsx → App → MainLayout (`#/` 受保护壳) | ChromeActions, DeviceSectionHeader, FeishuConflictDialogHost, GhostMediaLightboxHost, MainLayout, ProjectsSection, RightSidebar, RightSidebarShell, SessionShareImportWizard, Sidebar, UpdateNoticeDialog, WindowControls | apps/desktop/src/renderer/cindy-brain/GhostMediaLightboxHost.tsx, apps/desktop/src/renderer/components/UpdateNoticeDialog.tsx, apps/desktop/src/renderer/components/feishuBot/FeishuConflictDialog.tsx, apps/desktop/src/renderer/components/feishuBot/FeishuConflictDialogHost.tsx, apps/desktop/src/renderer/components/layout/AppBadgeAttentionSync.tsx, apps/desktop/src/renderer/components/layout/BrowserWebviewPool.tsx, apps/desktop/src/renderer/components/layout/ChromeActions.tsx, apps/desktop/src/renderer/components/layout/ContentHeader.tsx, apps/desktop/src/renderer/components/layout/CredentialStoreBanner.tsx, apps/desktop/src/renderer/components/layout/FadeSwitcher.tsx, apps/desktop/src/renderer/components/layout/GlobalDropImportListener.tsx, apps/desktop/src/renderer/components/layout/MainEntryRedirect.tsx, apps/desktop/src/renderer/components/layout/MainLayout.tsx, apps/desktop/src/renderer/components/layout/RightSidebar.tsx, apps/desktop/src/renderer/components/layout/RightSidebarDetach.tsx, apps/desktop/src/renderer/components/layout/RightSidebarMaximize.tsx, apps/desktop/src/renderer/components/layout/RightSidebarToggle.tsx, apps/desktop/src/renderer/components/layout/SidebarTabWindowLayout.tsx, apps/desktop/src/renderer/components/layout/SidebarWindowLayout.tsx, apps/desktop/src/renderer/components/layout/WallpaperVideo.tsx, apps/desktop/src/renderer/components/layout/chromeActionsGeometry.ts, apps/desktop/src/renderer/components/layout/chromeActionsLayout.ts, apps/desktop/src/renderer/components/layout/railChromeActions.ts, apps/desktop/src/renderer/components/layout/windowDrag.tsx, apps/desktop/src/renderer/components/settings/SessionShareImportWizard.tsx, apps/desktop/src/renderer/components/sidebar/AccountSwitcherDialog.tsx, apps/desktop/src/renderer/components/sidebar/AttentionDot.tsx, apps/desktop/src/renderer/components/sidebar/DatabaseSizeWarningBanner.tsx, apps/desktop/src/renderer/components/sidebar/GhostMainViewNavEntries.tsx, apps/desktop/src/renderer/components/sidebar/MobileDownloadDialog.tsx, apps/desktop/src/renderer/components/sidebar/NavigationCountBadge.tsx, apps/desktop/src/renderer/components/sidebar/NewTag.tsx, apps/desktop/src/renderer/components/sidebar/Sidebar.tsx, apps/desktop/src/renderer/components/sidebar/SidebarIconButton.tsx, apps/desktop/src/renderer/components/sidebar/SidebarNavigationCustomize.tsx, apps/desktop/src/renderer/components/sidebar/SidebarTopNav.tsx, apps/desktop/src/renderer/components/sidebar/SortableList.tsx, apps/desktop/src/renderer/components/sidebar/UpdateBanner.tsx, apps/desktop/src/renderer/components/sidebar/UserInfoSection.tsx, apps/desktop/src/renderer/components/sidebar/VendorIcon.tsx, apps/desktop/src/renderer/components/sidebar/VendorReadinessBadge.tsx, apps/desktop/src/renderer/components/sidebar/WorktreeBadge.tsx, apps/desktop/src/renderer/components/sidebar/sidebarNavigationPrefs.ts, apps/desktop/src/renderer/components/sidebar/useHoverOpenMenu.ts, apps/desktop/src/renderer/components/title-bar/ChromeIconButton.tsx, apps/desktop/src/renderer/components/title-bar/MenuButton.tsx, apps/desktop/src/renderer/components/title-bar/WindowControls.tsx, apps/desktop/src/renderer/features/cc-agent/sidebar/DeviceSectionHeader.tsx, apps/desktop/src/renderer/features/cc-agent/sidebar/sections/ProjectsSection.tsx, apps/desktop/src/renderer/features/right-sidebar/AddTabDropdown.tsx, apps/desktop/src/renderer/features/right-sidebar/EmptyState.tsx, apps/desktop/src/renderer/features/right-sidebar/RightSidebarShell.tsx, apps/desktop/src/renderer/features/right-sidebar/TabBar.tsx, apps/desktop/src/renderer/features/right-sidebar/TabBodyErrorBoundary.tsx, apps/desktop/src/renderer/features/right-sidebar/TabDragController.tsx, apps/desktop/src/renderer/features/right-sidebar/TabGroupPanel.tsx, apps/desktop/src/renderer/features/right-sidebar/globalTabs.ts, apps/desktop/src/renderer/features/right-sidebar/hooks/useBrowserWebview.ts, apps/desktop/src/renderer/features/right-sidebar/hooks/useNativePopupSurface.ts, apps/desktop/src/renderer/features/right-sidebar/hooks/useRetainedBrowserTabHosts.ts, apps/desktop/src/renderer/features/right-sidebar/lib/browserPartition.ts, apps/desktop/src/renderer/features/right-sidebar/lib/browserWebviewPool.ts, apps/desktop/src/renderer/features/right-sidebar/lib/detachedSidebarRouting.ts, apps/desktop/src/renderer/features/right-sidebar/lib/executeSidebarCommand.ts, apps/desktop/src/renderer/features/right-sidebar/lib/lastTurnChangedFiles.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mailPreview.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mergeSidebarWindowBack.ts, apps/desktop/src/renderer/features/right-sidebar/lib/nativePopupTabs.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openBackgroundTasksTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openBotWorkbenchTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openInSidebarBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openInSidebarFileBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openRoutinesTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openSideChatTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openSubagentsTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openTerminalShortcut.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openTurnReview.ts, apps/desktop/src/renderer/features/right-sidebar/lib/popupRouter.ts, apps/desktop/src/renderer/features/right-sidebar/lib/popupTabs.ts, apps/desktop/src/renderer/features/right-sidebar/lib/rsbBrowserBridge.ts, apps/desktop/src/renderer/features/right-sidebar/lib/sidebarCommands.ts, apps/desktop/src/renderer/features/right-sidebar/lib/sidebarHostSession.tsx, apps/desktop/src/renderer/features/right-sidebar/lib/tabHosting.ts, apps/desktop/src/renderer/features/right-sidebar/lib/useTabCreationMenu.ts, apps/desktop/src/renderer/features/right-sidebar/moveTab.ts, apps/desktop/src/renderer/features/right-sidebar/pluginPlacement.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/BackgroundTasksBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/WorkflowAgentStrip.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/WorkflowProgressTree.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/chatTaskFocusIntent.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/listSessionTasks.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/workflowProgressModel.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/bot-workbench/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/cindy-make/CindyMakeTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/cindy-make/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/FileBrowserBody.css, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/FileBrowserBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/dropExternalFile.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/fileTreeImagePreview.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/useSessionScopedTreeWidth.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/index.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailCardBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailConversationView.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailPreview.test.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/OrcaWorkersAttentionIcon.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/OrcaWorkersTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/actions.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/closeDecision.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/plugin-view/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/ResourceUsageBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/resource-usage.css, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/subscription.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/retired-feature/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/ImageDiffPreview.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/MarkdownDiffPreview.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/PlainUnifiedDiff.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/diffRows.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/highlight.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/inlineDiff.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/useDiffHighlights.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/ReviewTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/diffExpansionPreference.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/fileTree.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/gitApplyCommand.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/markdownPreview.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useLastTurnFilter.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useReviewGitState.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useReviewSource.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/routines/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/SideChatTabBody.test.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/SideChatTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/state.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/ConversationStream.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/DetailView.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/RunList.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentChrome.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentToolCard.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentsBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentChangeFence.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentConversation.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentFormat.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/TerminalTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/lib/xtermPool.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserChrome.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserCommentPopover.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/browserCommentEditorDraft.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/lib/parseOmnibox.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/useBrowserComment.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/useLocalHtmlAutoReload.ts, apps/desktop/src/renderer/features/right-sidebar/registry.ts, apps/desktop/src/renderer/features/right-sidebar/store.ts, apps/desktop/src/renderer/features/right-sidebar/tabAvailability.ts, apps/desktop/src/renderer/features/right-sidebar/tabGroupHost.tsx, apps/desktop/src/renderer/features/right-sidebar/tabGroupPanes.ts, apps/desktop/src/renderer/features/right-sidebar/tabGroups.ts, apps/desktop/src/renderer/features/right-sidebar/types.ts, apps/desktop/src/renderer/layout/LayoutRoot.tsx, apps/desktop/src/renderer/layout/PanelDragController.tsx, apps/desktop/src/renderer/layout/PanelDragPrototype.tsx, apps/desktop/src/renderer/layout/collapsePrefs.ts, apps/desktop/src/renderer/layout/layoutDevTools.ts, apps/desktop/src/renderer/layout/panePlacement.tsx, apps/desktop/src/renderer/layout/paneWidths.tsx, apps/desktop/src/renderer/layout/panelMaximize.tsx, apps/desktop/src/renderer/styles/generated/tokens.css, apps/desktop/src/renderer/styles/globals.css | 147 | 46 | 202 |+| `desktop.shell.main-layout` | desktop | 主窗口壳(标题栏 / 左右栏 / 内容区) | main BrowserWindow → renderer/index.tsx → main-entry.tsx → App → MainLayout (`#/` 受保护壳) | ChromeActions, DeviceSectionHeader, FeishuConflictDialogHost, GhostMediaLightboxHost, MainLayout, ProjectsSection, RightSidebar, RightSidebarShell, SessionShareImportWizard, Sidebar, UpdateNoticeDialog, WindowControls | apps/desktop/src/renderer/cindy-brain/GhostMediaLightboxHost.tsx, apps/desktop/src/renderer/components/UpdateNoticeDialog.tsx, apps/desktop/src/renderer/components/feishuBot/FeishuConflictDialog.tsx, apps/desktop/src/renderer/components/feishuBot/FeishuConflictDialogHost.tsx, apps/desktop/src/renderer/components/layout/AppBadgeAttentionSync.tsx, apps/desktop/src/renderer/components/layout/BrowserWebviewPool.tsx, apps/desktop/src/renderer/components/layout/ChromeActions.tsx, apps/desktop/src/renderer/components/layout/ContentHeader.tsx, apps/desktop/src/renderer/components/layout/CredentialStoreBanner.tsx, apps/desktop/src/renderer/components/layout/FadeSwitcher.tsx, apps/desktop/src/renderer/components/layout/GlobalDropImportListener.tsx, apps/desktop/src/renderer/components/layout/MainEntryRedirect.tsx, apps/desktop/src/renderer/components/layout/MainLayout.tsx, apps/desktop/src/renderer/components/layout/RightSidebar.tsx, apps/desktop/src/renderer/components/layout/RightSidebarDetach.tsx, apps/desktop/src/renderer/components/layout/RightSidebarMaximize.tsx, apps/desktop/src/renderer/components/layout/RightSidebarToggle.tsx, apps/desktop/src/renderer/components/layout/SidebarTabWindowLayout.tsx, apps/desktop/src/renderer/components/layout/SidebarWindowLayout.tsx, apps/desktop/src/renderer/components/layout/WallpaperVideo.tsx, apps/desktop/src/renderer/components/layout/chromeActionsGeometry.ts, apps/desktop/src/renderer/components/layout/chromeActionsLayout.ts, apps/desktop/src/renderer/components/layout/railChromeActions.ts, apps/desktop/src/renderer/components/layout/windowDrag.tsx, apps/desktop/src/renderer/components/settings/SessionShareImportWizard.tsx, apps/desktop/src/renderer/components/sidebar/AccountSwitcherDialog.tsx, apps/desktop/src/renderer/components/sidebar/AttentionDot.tsx, apps/desktop/src/renderer/components/sidebar/DatabaseSizeWarningBanner.tsx, apps/desktop/src/renderer/components/sidebar/GhostMainViewNavEntries.tsx, apps/desktop/src/renderer/components/sidebar/MobileDownloadDialog.tsx, apps/desktop/src/renderer/components/sidebar/NavigationCountBadge.tsx, apps/desktop/src/renderer/components/sidebar/NewTag.tsx, apps/desktop/src/renderer/components/sidebar/Sidebar.tsx, apps/desktop/src/renderer/components/sidebar/SidebarIconButton.tsx, apps/desktop/src/renderer/components/sidebar/SidebarNavigationCustomize.tsx, apps/desktop/src/renderer/components/sidebar/SidebarTopNav.tsx, apps/desktop/src/renderer/components/sidebar/SortableList.tsx, apps/desktop/src/renderer/components/sidebar/UpdateBanner.tsx, apps/desktop/src/renderer/components/sidebar/UserInfoSection.tsx, apps/desktop/src/renderer/components/sidebar/VendorIcon.tsx, apps/desktop/src/renderer/components/sidebar/VendorReadinessBadge.tsx, apps/desktop/src/renderer/components/sidebar/WorktreeBadge.tsx, apps/desktop/src/renderer/components/sidebar/sidebarNavigationPrefs.ts, apps/desktop/src/renderer/components/sidebar/useHoverOpenMenu.ts, apps/desktop/src/renderer/components/title-bar/ChromeIconButton.tsx, apps/desktop/src/renderer/components/title-bar/MenuButton.tsx, apps/desktop/src/renderer/components/title-bar/WindowControls.tsx, apps/desktop/src/renderer/features/cc-agent/sidebar/DeviceSectionHeader.tsx, apps/desktop/src/renderer/features/cc-agent/sidebar/sections/ProjectsSection.tsx, apps/desktop/src/renderer/features/right-sidebar/AddTabDropdown.tsx, apps/desktop/src/renderer/features/right-sidebar/EmptyState.tsx, apps/desktop/src/renderer/features/right-sidebar/RightSidebarShell.tsx, apps/desktop/src/renderer/features/right-sidebar/TabBar.tsx, apps/desktop/src/renderer/features/right-sidebar/TabBodyErrorBoundary.tsx, apps/desktop/src/renderer/features/right-sidebar/TabDragController.tsx, apps/desktop/src/renderer/features/right-sidebar/TabGroupPanel.tsx, apps/desktop/src/renderer/features/right-sidebar/globalTabs.ts, apps/desktop/src/renderer/features/right-sidebar/hooks/useBrowserWebview.ts, apps/desktop/src/renderer/features/right-sidebar/hooks/useNativePopupSurface.ts, apps/desktop/src/renderer/features/right-sidebar/hooks/useRetainedBrowserTabHosts.ts, apps/desktop/src/renderer/features/right-sidebar/lib/browserPartition.ts, apps/desktop/src/renderer/features/right-sidebar/lib/browserWebviewPool.ts, apps/desktop/src/renderer/features/right-sidebar/lib/detachedSidebarRouting.ts, apps/desktop/src/renderer/features/right-sidebar/lib/executeSidebarCommand.ts, apps/desktop/src/renderer/features/right-sidebar/lib/lastTurnChangedFiles.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mailPreview.ts, apps/desktop/src/renderer/features/right-sidebar/lib/mergeSidebarWindowBack.ts, apps/desktop/src/renderer/features/right-sidebar/lib/nativePopupTabs.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openBackgroundTasksTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openBotWorkbenchTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openInSidebarBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openInSidebarFileBrowser.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openRoutinesTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openSideChatTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openSubagentsTab.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openTerminalShortcut.ts, apps/desktop/src/renderer/features/right-sidebar/lib/openTurnReview.ts, apps/desktop/src/renderer/features/right-sidebar/lib/popupRouter.ts, apps/desktop/src/renderer/features/right-sidebar/lib/popupTabs.ts, apps/desktop/src/renderer/features/right-sidebar/lib/rsbBrowserBridge.ts, apps/desktop/src/renderer/features/right-sidebar/lib/sidebarCommands.ts, apps/desktop/src/renderer/features/right-sidebar/lib/sidebarHostSession.tsx, apps/desktop/src/renderer/features/right-sidebar/lib/tabHosting.ts, apps/desktop/src/renderer/features/right-sidebar/lib/useTabCreationMenu.ts, apps/desktop/src/renderer/features/right-sidebar/moveTab.ts, apps/desktop/src/renderer/features/right-sidebar/pluginPlacement.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/BackgroundTasksBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/WorkflowAgentStrip.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/WorkflowProgressTree.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/chatTaskFocusIntent.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/listSessionTasks.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/background-tasks/workflowProgressModel.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/bot-workbench/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/cindy-make/CindyMakeTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/cindy-make/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/FileBrowserBody.css, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/FileBrowserBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/dropExternalFile.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/fileTreeImagePreview.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/file-browser/useSessionScopedTreeWidth.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/index.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailCardBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailConversationView.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/MailPreview.test.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/mail-preview/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/OrcaWorkersAttentionIcon.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/OrcaWorkersTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/actions.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/closeDecision.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/orca-workers/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/plugin-view/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/ResourceUsageBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/resource-usage.css, apps/desktop/src/renderer/features/right-sidebar/plugins/resource-usage/subscription.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/retired-feature/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/ImageDiffPreview.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/MarkdownDiffPreview.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/PlainUnifiedDiff.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/diffRows.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/highlight.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/inlineDiff.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/DiffViewer/useDiffHighlights.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/ReviewTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/diffExpansionPreference.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/fileTree.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/gitApplyCommand.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/review/markdownPreview.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useLastTurnFilter.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useReviewGitState.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/review/useReviewSource.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/routines/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/SideChatTabBody.test.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/SideChatTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/side-chat/state.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/ConversationStream.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/DetailView.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/RunList.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentChrome.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentToolCard.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/SubagentsBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentChangeFence.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentConversation.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/subagents/subagentFormat.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/TerminalTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/terminal/lib/xtermPool.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserChrome.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserCommentPopover.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/BrowserTabBody.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/browserCommentEditorDraft.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/index.tsx, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/lib/parseOmnibox.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/useBrowserComment.ts, apps/desktop/src/renderer/features/right-sidebar/plugins/web-browser/useLocalHtmlAutoReload.ts, apps/desktop/src/renderer/features/right-sidebar/registry.ts, apps/desktop/src/renderer/features/right-sidebar/store.ts, apps/desktop/src/renderer/features/right-sidebar/tabAvailability.ts, apps/desktop/src/renderer/features/right-sidebar/tabGroupHost.tsx, apps/desktop/src/renderer/features/right-sidebar/tabGroupPanes.ts, apps/desktop/src/renderer/features/right-sidebar/tabGroups.ts, apps/desktop/src/renderer/features/right-sidebar/types.ts, apps/desktop/src/renderer/layout/LayoutRoot.tsx, apps/desktop/src/renderer/layout/PanelDragController.tsx, apps/desktop/src/renderer/layout/PanelDragPrototype.tsx, apps/desktop/src/renderer/layout/collapsePrefs.ts, apps/desktop/src/renderer/layout/layoutDevTools.ts, apps/desktop/src/renderer/layout/panePlacement.tsx, apps/desktop/src/renderer/layout/paneWidths.tsx, apps/desktop/src/renderer/layout/panelMaximize.tsx, apps/desktop/src/renderer/styles/generated/tokens.css, apps/desktop/src/renderer/styles/globals.css | 147 | 46 | 200 || `desktop.skillhub.local` | desktop | SkillHub 本地技能 | hash `/skillhub/local` 及统一详情 `/skillhub/detail`(旧详情链接重定向) | InstallTargetPicker, PluginDevicePicker, PluginManagementLayout, RemoteSkillsPage, SkillCategoryFilterBar, SkillDetailLayout, SkillhubDetailRoute, SkillhubDetailView, SkillhubFeatureLayout, SkillhubHomeView, SkillhubLocalLayout, SkillhubMarketDetailView | apps/desktop/src/renderer/features/plugin/PluginDevicePicker.tsx, apps/desktop/src/renderer/features/plugin/PluginManagementLayout.tsx, apps/desktop/src/renderer/features/skillhub/RemoteSkillsPage.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubDetailRoute.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubDetailView.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubFeatureLayout.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubHomeView.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubLocalLayout.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubMarketDetailView.tsx, apps/desktop/src/renderer/features/skillhub/components/InstallTargetPicker.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillCategoryFilterBar.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillDetailLayout.tsx, apps/desktop/src/renderer/features/skillhub/skillhub-home.css | 39 | 0 | 45 || `desktop.skillhub.market` | desktop | SkillHub 市场 | hash `/skillhub/market`(SkillhubMarketListView) | InstallTargetPicker, MarketCard, MarketInfoEditDialog, SkillhubMarketDetailView, SkillhubMarketListView, VisibilityEditorDialog | apps/desktop/src/renderer/features/skillhub/SkillhubMarketDetailView.tsx, apps/desktop/src/renderer/features/skillhub/SkillhubMarketListView.tsx, apps/desktop/src/renderer/features/skillhub/components/HomeMarketCard.tsx, apps/desktop/src/renderer/features/skillhub/components/InstallTargetPicker.tsx, apps/desktop/src/renderer/features/skillhub/components/LocalSkillControls.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketCard.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketInfoEditDialog.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketInstallStatus.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketListError.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketLocalSkills.tsx, apps/desktop/src/renderer/features/skillhub/components/MarketPreviewTree.tsx, apps/desktop/src/renderer/features/skillhub/components/OfficialSkillBadge.tsx, apps/desktop/src/renderer/features/skillhub/components/PlatformTagSelector.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillCategoryFilterBar.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillDetailLayout.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillIcon.tsx, apps/desktop/src/renderer/features/skillhub/components/SkillTagList.tsx, apps/desktop/src/renderer/features/skillhub/components/TeamScopePicker.tsx, apps/desktop/src/renderer/features/skillhub/components/VisibilityEditorDialog.tsx | 42 | 0 | 35 || `desktop.window.computer-permission-guide` | desktop | 电脑使用权限引导 | `?view=computer-permission-guide` → ComputerPermissionGuideWindow;backdrop 同文件 | ComputerPermissionBackdrop, ComputerPermissionGuideWindow | apps/desktop/src/main/computer-permission-guide/MacComputerPermissionGuideNativeHost.ts, apps/desktop/src/main/computer-permission-guide/placement.ts, apps/desktop/src/main/computer-permission-guide/request.ts, apps/desktop/src/main/computer-permission-guide/switch-target.ts, apps/desktop/src/main/computer-permission-guide/window.ts, apps/desktop/src/renderer/components/settings/ComputerPermissionGuideWindow.tsx | 7 | 2 | 9 |