Consider it done. The open-source AI agent that works out of the box · 想到,就能做到。开源、开箱即用的 AI Agent。
TypeScript agentai-agentai-assistantandroidclaude-codecodexelectroniosllmmacosreact-nativetypescriptwindows
feat(desktop): 左上角新增任务浏览前进/后退
WZBbiao23b4665fccab
diff --git a/apps/desktop/src/renderer/components/layout/ChromeActions.tsx b/apps/desktop/src/renderer/components/layout/ChromeActions.tsxindex 97b901c95e..11b14812fe 100644--- a/apps/desktop/src/renderer/components/layout/ChromeActions.tsx+++ b/apps/desktop/src/renderer/components/layout/ChromeActions.tsx@@ -12,7 +12,8 @@* 触发钮(折叠按钮)因此有稳定的触发区域。唯一的位移是 mac 进出全屏* (78 ↔ 8),保留 250ms 过渡与红绿灯出现/消失同步。*- * 顺序:折叠按钮在左(紧贴红绿灯,对齐 Codex),菜单(三横杠)在其右。+ * 顺序:折叠按钮在左(紧贴红绿灯,对齐 Codex),菜单(三横杠)在其右,+ * 再往右是任务浏览历史的「后退 / 前进」(见 SessionHistoryButtons)。** 尺寸:按钮 h-7 w-7(28px)+ 图标 15 + rounded-md —— 与折叠态标题行的* 「…」按钮(SessionContentHeader,h-7 w-7 / Ellipsis 15 / rounded-md)同一@@ -32,12 +33,16 @@* 用 transform 平移后按钮视觉位置和 no-drag 挖洞错位,点击会变成拖拽窗口。*/-import { PanelLeft } from 'lucide-react';+import { ArrowLeft, ArrowRight, PanelLeft } from 'lucide-react';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 { useMacFullscreen } from '@/hooks/useMacFullscreen';+import { useAppShortcutDisplay } from '@/hooks/useAppShortcut';+import { useSessionBrowseHistory } from '@/features/cc-agent/useSessionBrowseHistory';+import type { SessionBrowseNavigation } from '@/features/cc-agent/useSessionBrowseHistory';import { cn } from '@/lib/utils';import type { SidebarPeekTriggerProps } from '@/hooks/useSidebarPeek';@@ -60,6 +65,7 @@ export function ChromeActions({}: ChromeActionsProps) {const { t } = useTranslation();const { isMac, isFullscreen } = useMacFullscreen();+ const browseHistory = useSessionBrowseHistory();// 钉死左上角:mac 非全屏让位红绿灯(78),其余 8。不随侧栏状态变化。const x =@@ -104,6 +110,55 @@ export function ChromeActions({isMac && isFullscreen ? () => window.electronAPI?.windowExitFullscreen() : undefined}/>+ {/* 任务浏览历史:与浏览器同惯例,左键后退、右键前进;到边界置灰并把+ tooltip 换成「为什么不可用」。形状与相邻的菜单/折叠按钮同为 28px+ rounded-md(ChromeIconButton 默认圆角留给 TabBar)。 */}+ <SessionHistoryButtons {...browseHistory} /></div>);}++/**+ * 任务浏览历史的两个导航钮。拆成单独导出仅为测试可直接渲染真实按钮,生产+ * 只由 ChromeActions 挂一次。+ */+export function SessionHistoryButtons({+ canBack,+ canForward,+ goBack,+ goForward,+}: SessionBrowseNavigation): React.ReactElement {+ const { t } = useTranslation();+ const backShortcut = useAppShortcutDisplay('session-history-back');+ const forwardShortcut = useAppShortcutDisplay('session-history-forward');+ // 与其它快捷键提示同形:动作 + 生效组合(跟随用户改绑)。+ const withShortcut = (label: string, shortcut: string) =>+ shortcut ? `${label} (${shortcut})` : label;++ return (+ <>+ <ChromeIconButton+ className="rounded-md disabled:opacity-40"+ disabled={!canBack}+ onClick={goBack}+ tooltip={withShortcut(t('titleBar.historyBack'), backShortcut)}+ disabledTooltip={t('titleBar.historyBackUnavailable')}+ tooltipSide="bottom"+ aria-label={t('titleBar.historyBack')}+ >+ <ArrowLeft size={15} />+ </ChromeIconButton>+ <ChromeIconButton+ className="rounded-md disabled:opacity-40"+ disabled={!canForward}+ onClick={goForward}+ tooltip={withShortcut(t('titleBar.historyForward'), forwardShortcut)}+ disabledTooltip={t('titleBar.historyForwardUnavailable')}+ tooltipSide="bottom"+ aria-label={t('titleBar.historyForward')}+ >+ <ArrowRight size={15} />+ </ChromeIconButton>+ </>+ );+}diff --git a/apps/desktop/src/renderer/components/layout/ContentHeader.tsx b/apps/desktop/src/renderer/components/layout/ContentHeader.tsxindex 5aba91338e..c04a85e028 100644--- a/apps/desktop/src/renderer/components/layout/ContentHeader.tsx+++ b/apps/desktop/src/renderer/components/layout/ContentHeader.tsx@@ -164,18 +164,21 @@ export function ContentHeader({{/* 折叠态占位 spacer:真实按钮在 MainLayout 的 ChromeActions 浮层里(钉死左上角、不随折叠重建的常驻实例)。本 spacer 以与侧栏宽度动画相同的时长/缓动伸缩,把标题平滑推到浮动按钮右侧(项目规则 8)。- 68px = 折叠按钮 28 + gap 4 + 菜单 28 + 与标题间隙 8。+ 簇宽 + 8 = 折叠 / 菜单 / 后退 / 前进四个 28px 按钮 + 与标题间隙 8,+ 跟 CHROME_ACTIONS_GEOMETRY 一起变。⚠️ spacer 自身必须 no-drag:Electron 的拖拽区域挖洞只在"drag 元素自己的后代"上可靠生效,浮层(非后代)的 no-drag 不被计入 ——否则浮层按钮点击会被窗口拖拽吞掉。 */}<divaria-hidden- className={cn(- 'h-full shrink-0 overflow-hidden',- 'transition-[max-width] duration-[250ms] ease-[cubic-bezier(0.4,0,0.2,1)]',- showCollapsedActions ? 'max-w-[68px] w-[68px]' : 'max-w-0 w-[68px]',- )}- style={{ WebkitAppRegion: 'no-drag' } as React.CSSProperties}+ className="h-full shrink-0 overflow-hidden transition-[max-width] duration-[250ms] ease-[cubic-bezier(0.4,0,0.2,1)]"+ style={+ {+ WebkitAppRegion: 'no-drag',+ width: CHROME_ACTIONS_GEOMETRY.clusterWidth + 8,+ maxWidth: showCollapsedActions ? CHROME_ACTIONS_GEOMETRY.clusterWidth + 8 : 0,+ } as React.CSSProperties+ }/>{/* 中部:feature 注入的 slot 内容。容器保持 drag,注入内容里的交互diff --git a/apps/desktop/src/renderer/components/layout/MainLayout.tsx b/apps/desktop/src/renderer/components/layout/MainLayout.tsxindex b2b5916dec..74dbf8fee6 100644--- a/apps/desktop/src/renderer/components/layout/MainLayout.tsx+++ b/apps/desktop/src/renderer/components/layout/MainLayout.tsx@@ -1692,8 +1692,9 @@ export function MainLayout() {}}>{/* showCollapsedActions: 完全隐藏(isSidebarCollapsed)**和** rail 态(isRailMode)- 都要为浮动 ChromeActions 簇预留 68px 占位 —— rail 下侧栏仅 64px,chrome 簇- 贴在 rail 右缘(见上方 sidebarWidth),不留占位会压住会话标题左侧。 */}+ 都要为浮动 ChromeActions 簇预留占位(CHROME_ACTIONS_GEOMETRY.clusterWidth + 8)+ —— rail 下侧栏仅 64px,chrome 簇贴在 rail 右缘(见上方 sidebarWidth),+ 不留占位会压住会话标题左侧。 */}{/* rail 态在 sidebarVisible 口径里视同"不可见"(codex review): 否则 mac 无headerContent 路由下 ContentHeader 会因 sidebarVisible=true 提前 return null,我们为 rail 浮动 chrome 预留的 spacer 不渲染、按钮悬空。 */}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.tsxnew file mode 100644index 0000000000..ffa9c9517f--- /dev/null+++ b/apps/desktop/src/renderer/components/layout/__tests__/ChromeActions.history.test.tsx@@ -0,0 +1,155 @@+// @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/components/layout/chromeActionsGeometry.ts b/apps/desktop/src/renderer/components/layout/chromeActionsGeometry.tsindex 283549892b..7ce61dfe8a 100644--- a/apps/desktop/src/renderer/components/layout/chromeActionsGeometry.ts+++ b/apps/desktop/src/renderer/components/layout/chromeActionsGeometry.ts@@ -10,6 +10,9 @@ export const CHROME_ACTIONS_GEOMETRY = {defaultLeft: 8,/** macOS 非全屏时,按钮簇为红绿灯预留空间后的左偏移。 */macTrafficLightLeft: 78,- /** 两个 28px 按钮加 4px 间距的总宽度。 */- clusterWidth: 60,+ /**+ * 四个 28px 按钮加 4px 间距的总宽度:折叠、菜单、浏览历史后退与前进。+ * 加删按钮时同步改这里,挖洞与占位都跟着它。+ */+ clusterWidth: 124,} as const;diff --git a/apps/desktop/src/renderer/components/sidebar/Sidebar.tsx b/apps/desktop/src/renderer/components/sidebar/Sidebar.tsxindex a9a4b5ab42..b364f84fd7 100644--- a/apps/desktop/src/renderer/components/sidebar/Sidebar.tsx+++ b/apps/desktop/src/renderer/components/sidebar/Sidebar.tsx@@ -206,7 +206,8 @@ export function Sidebar({><divaria-hidden- // 60px = 折叠按钮 28 + gap 4 + 菜单 28(ChromeActions 簇宽)。+ // 占位宽 = ChromeActions 簇宽(折叠/菜单/后退/前进四个按钮,见+ // CHROME_ACTIONS_GEOMETRY.clusterWidth)。className="h-full shrink-0"style={{diff --git a/apps/desktop/src/renderer/components/title-bar/ChromeIconButton.tsx b/apps/desktop/src/renderer/components/title-bar/ChromeIconButton.tsxindex ea0cb3eb1d..11119de8c3 100644--- a/apps/desktop/src/renderer/components/title-bar/ChromeIconButton.tsx+++ b/apps/desktop/src/renderer/components/title-bar/ChromeIconButton.tsx@@ -1,6 +1,7 @@import type { ButtonHTMLAttributes, ReactNode } from 'react';import { Tip, type TipProps } from '@/components/ui/tooltip';+import { cn } from '@/lib/utils';import '../ui/button.css';/**@@ -21,6 +22,7 @@ export function ChromeIconButton({children,className,tooltip,+ disabledTooltip,tooltipSide,tooltipDelay,title,@@ -28,12 +30,17 @@ export function ChromeIconButton({}: ButtonHTMLAttributes<HTMLButtonElement> & {children?: ReactNode;tooltip?: ReactNode;+ /** 置灰时的 tooltip:说明为什么不可用(DESIGN §14.6),不传则沿用 tooltip。 */+ disabledTooltip?: ReactNode;tooltipSide?: TipProps['side'];tooltipDelay?: number;}) {const accessibleLabel = rest['aria-label'];const tooltipText =- tooltip ?? title ?? (typeof accessibleLabel === 'string' ? accessibleLabel : undefined);+ (rest.disabled ? disabledTooltip : undefined) ??+ tooltip ??+ title ??+ (typeof accessibleLabel === 'string' ? accessibleLabel : undefined);const disabledLabel =typeof tooltipText === 'string'? tooltipText@@ -43,7 +50,7 @@ export function ChromeIconButton({const button = (<buttontype="button"- className={[CHROME_ICON_BUTTON_CLASS, className].filter(Boolean).join(' ')}+ className={cn(CHROME_ICON_BUTTON_CLASS, className)}{...rest}aria-hidden={rest.disabled ? true : undefined}>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.tsnew file mode 100644index 0000000000..d6b041fe1b--- /dev/null+++ b/apps/desktop/src/renderer/features/cc-agent/__tests__/sessionBrowseHistory.test.ts@@ -0,0 +1,109 @@+/**+ * 测试价值+ * - 生产入口与可观察结果:createSessionBrowseHistory(窗口内唯一的浏览栈)与+ * sessionIdFromPathname(路由 → 任务 id 的判定)。可观察结果是栈内容与后退/+ * 前进落到哪个任务。+ * - Bug / 规则依据:新功能「任务浏览栈」—— 后退永远落在任务视图上,同一任务+ * 重复导航不占格,走到中间再打开新任务要截断前进侧,到边界必须返回 null+ * 让按钮置灰。+ * - 现有覆盖缺口:新模块。+ * - 最小失败输入:record('a'); record('b'); step(-1) 之后再 record('c')。+ * - tier:unit(node,纯逻辑)。+ */++import { describe, expect, it, vi } from 'vitest';++import { createSessionBrowseHistory, sessionIdFromPathname } from '../sessionBrowseHistory';++describe('sessionIdFromPathname', () => {+ it.each([+ ['/cc-agent/session-a', 'session-a'],+ ['/cc-agent/remote:host-1', 'remote:host-1'],+ ])('takes %s as a task view', (pathname, expected) => {+ expect(sessionIdFromPathname(pathname)).toBe(expected);+ });++ it.each([+ '/cc-agent/new',+ '/cc-agent/new-dialogue',+ '/cc-agent/scheduled',+ '/cc-agent/boot',+ '/cc-agent/files/session-a',+ '/cc-agent/orca/session-a',+ '/bots/bot-1/session/session-a',+ '/settings',+ ])('keeps %s out of the stack', (pathname) => {+ expect(sessionIdFromPathname(pathname)).toBeNull();+ });+});++describe('createSessionBrowseHistory', () => {+ it('walks back and forward through visited tasks and stops at both ends', () => {+ const history = createSessionBrowseHistory();+ history.record('a');+ history.record('b');+ history.record('c');++ expect(history.step(-1)).toBe('b');+ expect(history.step(-1)).toBe('a');+ expect(history.step(-1)).toBeNull();+ expect(history.step(1)).toBe('b');+ expect(history.step(1)).toBe('c');+ expect(history.step(1)).toBeNull();+ expect(history.snapshot()).toEqual({ ids: ['a', 'b', 'c'], index: 2 });+ });++ it('does not stack the task you are already on', () => {+ const history = createSessionBrowseHistory();+ history.record('a');+ history.record('a');++ expect(history.snapshot()).toEqual({ ids: ['a'], index: 0 });+ expect(history.step(-1)).toBeNull();+ });++ it('drops the forward side once another task is opened from the middle', () => {+ const history = createSessionBrowseHistory();+ history.record('a');+ history.record('b');+ history.step(-1);++ history.record('c');++ expect(history.snapshot()).toEqual({ ids: ['a', 'c'], index: 1 });+ expect(history.step(1)).toBeNull();+ expect(history.step(-1)).toBe('a');+ });++ it('drops the oldest entry past the cap', () => {+ const history = createSessionBrowseHistory(2);+ history.record('a');+ history.record('b');+ history.record('c');++ expect(history.snapshot()).toEqual({ ids: ['b', 'c'], index: 1 });+ });++ it('notifies subscribers only when the stack or position moves', () => {+ const history = createSessionBrowseHistory();+ const listener = vi.fn();+ const unsubscribe = history.subscribe(listener);++ history.record('a');+ history.record('a');+ history.step(1);++ expect(listener).toHaveBeenCalledTimes(1);++ unsubscribe();+ history.record('b');+ expect(listener).toHaveBeenCalledTimes(1);+ });++ it('keeps the snapshot identity stable between changes for useSyncExternalStore', () => {+ const history = createSessionBrowseHistory();+ history.record('a');++ expect(history.snapshot()).toBe(history.snapshot());+ });+});diff --git a/apps/desktop/src/renderer/features/cc-agent/sessionBrowseHistory.ts b/apps/desktop/src/renderer/features/cc-agent/sessionBrowseHistory.tsnew file mode 100644index 0000000000..3712cea8b2--- /dev/null+++ b/apps/desktop/src/renderer/features/cc-agent/sessionBrowseHistory.ts@@ -0,0 +1,74 @@+/**+ * sessionBrowseHistory —— 任务浏览栈(浏览器式后退/前进)的纯逻辑。+ *+ * 为什么需要:会话一多,用户从一个任务切去处理更急的任务后,回不到刚才那个。+ * 这里按访问顺序记下打开过的任务,左上按钮簇(ChromeActions)与 ⌘[ / ⌘] 都能+ * 沿栈走回去,前进侧与浏览器同义:走到中间后打开新任务会截断前进侧。+ *+ * 只记任务视图 `/cc-agent/<sessionId>` 一条路由。草稿(new)、自动任务、文件树、+ * Orca 工作流都不进栈 —— 用户要的是「刚看过的那个任务」,不是走过的每一页;+ * 栈里也就能保证后退永远落在任务上。+ */++/** 超过这个数量的最旧记录被丢弃,避免长期使用后无限增长。 */+const MAX_ENTRIES = 50;++const SESSION_VIEW_PATH = /^\/cc-agent\/([^/]+)$/;+/** `/cc-agent/<静态段>` 不是任务 id(路由另有对应页面,见 router.tsx)。 */+const NON_SESSION_SEGMENTS = new Set(['new', 'new-dialogue', 'scheduled', 'boot']);++/** 当前路径是一个任务视图时返回其 sessionId,否则 null。 */+export function sessionIdFromPathname(pathname: string): string | null {+ const match = SESSION_VIEW_PATH.exec(pathname);+ if (!match || NON_SESSION_SEGMENTS.has(match[1])) return null;+ return match[1];+}++export interface SessionBrowseSnapshot {+ ids: readonly string[];+ index: number;+}++export interface SessionBrowseHistory {+ /** 打开了一个任务:同类去重,截断前进侧后入栈。 */+ record(sessionId: string): void;+ /** 沿栈走一步;到边界返回 null(调用方据此置灰/不消费快捷键)。 */+ step(direction: -1 | 1): string | null;+ snapshot(): SessionBrowseSnapshot;+ subscribe(listener: () => void): () => void;+}++export function createSessionBrowseHistory(maxEntries = MAX_ENTRIES): SessionBrowseHistory {+ let state: SessionBrowseSnapshot = { ids: [], index: -1 };+ const listeners = new Set<() => void>();+ const commit = (next: SessionBrowseSnapshot) => {+ state = next;+ for (const listener of listeners) listener();+ };++ return {+ record(sessionId) {+ // 同一任务的重复导航(标题刷新、同 id 深链)不该占一格,否则后退按一下没反应。+ if (state.ids[state.index] === sessionId) return;+ const ids = [...state.ids.slice(0, state.index + 1), sessionId];+ if (ids.length > maxEntries) ids.splice(0, ids.length - maxEntries);+ commit({ ids, index: ids.length - 1 });+ },+ step(direction) {+ const next = state.index + direction;+ if (next < 0 || next >= state.ids.length) return null;+ commit({ ids: state.ids, index: next });+ return state.ids[next];+ },+ snapshot: () => state,+ subscribe(listener) {+ listeners.add(listener);+ return () => {+ listeners.delete(listener);+ };+ },+ };+}++/** 生产环境唯一的栈:同一窗口内所有消费方(按钮/快捷键)共享。 */+export const sessionBrowseHistory = createSessionBrowseHistory();diff --git a/apps/desktop/src/renderer/features/cc-agent/useSessionBrowseHistory.ts b/apps/desktop/src/renderer/features/cc-agent/useSessionBrowseHistory.tsnew file mode 100644index 0000000000..8cf86fa6e1--- /dev/null+++ b/apps/desktop/src/renderer/features/cc-agent/useSessionBrowseHistory.ts@@ -0,0 +1,63 @@+/**+ * useSessionBrowseHistory —— 把当前任务视图记进浏览栈,并接上后退/前进。+ *+ * 快捷键与按钮共用同一份栈(cc-agent/sessionBrowseHistory);`history` 参数只+ * 为测试注入独立实例,生产调用不传,直接用窗口内唯一的单例。+ */++import { useCallback, useEffect, useSyncExternalStore } from 'react';+import { useLocation, useNavigate } from 'react-router-dom';++import { useAppShortcut } from '@/hooks/useAppShortcut';+import {+ sessionBrowseHistory,+ sessionIdFromPathname,+ type SessionBrowseHistory,+} from './sessionBrowseHistory';++export interface SessionBrowseNavigation {+ canBack: boolean;+ canForward: boolean;+ goBack: () => boolean;+ goForward: () => boolean;+}++export function useSessionBrowseHistory(+ history: SessionBrowseHistory = sessionBrowseHistory,+): SessionBrowseNavigation {+ const location = useLocation();+ const navigate = useNavigate();+ const { ids, index } = useSyncExternalStore(history.subscribe, history.snapshot);+ const sessionId = sessionIdFromPathname(location.pathname);++ useEffect(() => {+ if (sessionId) history.record(sessionId);+ }, [history, sessionId]);++ const go = useCallback(+ (direction: -1 | 1) => {+ const target = history.step(direction);+ if (!target) return false;+ navigate(`/cc-agent/${target}`);+ return true;+ },+ [history, navigate],+ );+ const goBack = useCallback(() => go(-1), [go]);+ const goForward = useCallback(() => go(1), [go]);++ // Windows / Linux 上 mod+[ 在终端里是 ESC(vim / readline):焦点在终端时让给 PTY,+ // 不做窗口级导航。mac 的 ⌘[ 在终端无原生含义,同一道门一并让路无副作用。+ const outsideTerminal = (event: KeyboardEvent) =>+ !(event.target instanceof Element && event.target.closest('.xterm'));++ useAppShortcut('session-history-back', (event) => outsideTerminal(event) && goBack());+ useAppShortcut('session-history-forward', (event) => outsideTerminal(event) && goForward());++ return {+ canBack: index > 0,+ canForward: index >= 0 && index < ids.length - 1,+ goBack,+ goForward,+ };+}diff --git a/apps/desktop/src/renderer/i18n/locales/en/common.json b/apps/desktop/src/renderer/i18n/locales/en/common.jsonindex 30d52b87f2..cb5525d8fd 100644--- a/apps/desktop/src/renderer/i18n/locales/en/common.json+++ b/apps/desktop/src/renderer/i18n/locales/en/common.json@@ -6002,6 +6002,14 @@"label": "Toggle sidebar","description": "Collapse or expand the session list sidebar"},+ "session-history-back": {+ "label": "Previous task",+ "description": "Go back to the task you viewed before"+ },+ "session-history-forward": {+ "label": "Next task",+ "description": "Go forward to the task you viewed next"+ },"open-settings": {"label": "Open settings","description": "Open the settings page"@@ -8095,6 +8103,10 @@},"titleBar": {"menu": "Menu",+ "historyBack": "Back to previous task",+ "historyForward": "Forward to next task",+ "historyBackUnavailable": "No previous task",+ "historyForwardUnavailable": "No next task","minimize": "Minimize","maximizeOrRestore": "Maximize or Restore Window","close": "Close",diff --git a/apps/desktop/src/renderer/i18n/locales/ja/common.json b/apps/desktop/src/renderer/i18n/locales/ja/common.jsonindex 5bbdb28a7f..e94638270d 100644--- a/apps/desktop/src/renderer/i18n/locales/ja/common.json+++ b/apps/desktop/src/renderer/i18n/locales/ja/common.json@@ -5971,6 +5971,14 @@"label": "サイドバーを切り替え","description": "左側のセッションリストを折りたたみ・展開します"},+ "session-history-back": {+ "label": "前のセッション",+ "description": "閲覧順で前に開いていたセッションに戻ります"+ },+ "session-history-forward": {+ "label": "次のセッション",+ "description": "閲覧順で次に開いていたセッションに進みます"+ },"open-settings": {"label": "設定を開く","description": "設定ページを開きます"@@ -8063,6 +8071,10 @@},"titleBar": {"menu": "メニュー",+ "historyBack": "前のセッションに戻る",+ "historyForward": "次のセッションに進む",+ "historyBackUnavailable": "前のセッションがありません",+ "historyForwardUnavailable": "次のセッションがありません","minimize": "最小化","maximizeOrRestore": "ウィンドウを最大化または元のサイズに戻す","close": "閉じる",diff --git a/apps/desktop/src/renderer/i18n/locales/ko/common.json b/apps/desktop/src/renderer/i18n/locales/ko/common.jsonindex ec7dd87354..9d3f9383bb 100644--- a/apps/desktop/src/renderer/i18n/locales/ko/common.json+++ b/apps/desktop/src/renderer/i18n/locales/ko/common.json@@ -5971,6 +5971,14 @@"label": "사이드바 전환","description": "왼쪽 세션 목록을 접거나 펼칩니다"},+ "session-history-back": {+ "label": "이전 세션",+ "description": "탐색 순서대로 이전에 열었던 세션으로 돌아갑니다"+ },+ "session-history-forward": {+ "label": "다음 세션",+ "description": "탐색 순서대로 다음에 열었던 세션으로 이동합니다"+ },"open-settings": {"label": "설정 열기","description": "설정 페이지를 엽니다"@@ -8063,6 +8071,10 @@},"titleBar": {"menu": "메뉴",+ "historyBack": "이전 세션으로 돌아가기",+ "historyForward": "다음 세션으로 이동",+ "historyBackUnavailable": "이전 세션이 없습니다",+ "historyForwardUnavailable": "다음 세션이 없습니다","minimize": "최소화","maximizeOrRestore": "창 최대화 또는 복원","close": "닫기",diff --git a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.jsonindex 3e4bbd17e7..c67b9c6e7b 100644--- a/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json+++ b/apps/desktop/src/renderer/i18n/locales/zh-CN/common.json@@ -5965,6 +5965,14 @@"label": "切换侧边栏","description": "收起或展开左侧任务列表"},+ "session-history-back": {+ "label": "上一个任务",+ "description": "按浏览顺序回到上一个打开的任务"+ },+ "session-history-forward": {+ "label": "下一个任务",+ "description": "按浏览顺序前往下一个任务"+ },"open-settings": {"label": "打开设置","description": "打开设置页面"@@ -8063,6 +8071,10 @@},"titleBar": {"menu": "菜单",+ "historyBack": "浏览上一个任务",+ "historyForward": "浏览下一个任务",+ "historyBackUnavailable": "没有上一个任务",+ "historyForwardUnavailable": "没有下一个任务","minimize": "最小化","maximizeOrRestore": "最大化或还原窗口","close": "关闭",diff --git a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.jsonindex 53ea2469c9..855fd7d190 100644--- a/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json+++ b/apps/desktop/src/renderer/i18n/locales/zh-TW/common.json@@ -5971,6 +5971,14 @@"label": "切換側邊欄","description": "收起或展開左側任務列表"},+ "session-history-back": {+ "label": "上一個任務",+ "description": "依瀏覽順序回到上一個開啟的任務"+ },+ "session-history-forward": {+ "label": "下一個任務",+ "description": "依瀏覽順序前往下一個任務"+ },"open-settings": {"label": "開啟設定","description": "開啟設定頁面"@@ -8063,6 +8071,10 @@},"titleBar": {"menu": "選單",+ "historyBack": "瀏覽上一個任務",+ "historyForward": "瀏覽下一個任務",+ "historyBackUnavailable": "沒有上一個任務",+ "historyForwardUnavailable": "沒有下一個任務","minimize": "最小化","maximizeOrRestore": "最大化或還原視窗","close": "關閉",diff --git a/apps/desktop/src/shared/appShortcuts.ts b/apps/desktop/src/shared/appShortcuts.tsindex a1d04e8b88..5ecc5b276f 100644--- a/apps/desktop/src/shared/appShortcuts.ts+++ b/apps/desktop/src/shared/appShortcuts.ts@@ -34,6 +34,8 @@ export type AppShortcutScope = 'app' | 'workdir-doc' | 'browser' | 'composer';export const APP_SHORTCUT_IDS = ['toggle-sidebar',+ 'session-history-back',+ 'session-history-forward','open-settings','new-maker','close-tab-or-window',@@ -157,6 +159,25 @@ export const APP_SHORTCUT_DEFINITIONS: ReadonlyArray<AppShortcutDefinition> = [rebindable: true,getDefaultCombos: (platform) => [modCombo('KeyB', platform)],},+ // 任务浏览栈的前进/后退: 与浏览器同一惯例 (⌘[ / ⌘]), 在 ChromeActions+ // 的左上按钮簇里消费。raw 按键在 macOS 上不会被系统菜单吃掉+ // (keyboardReserved 不含 Bracket*), webview 内的 ⌘[ 留给浏览器自己的后退。+ {+ id: 'session-history-back',+ scope: 'app',+ labelKey: 'settings.shortcuts.items.session-history-back.label',+ descriptionKey: 'settings.shortcuts.items.session-history-back.description',+ rebindable: true,+ getDefaultCombos: (platform) => [modCombo('BracketLeft', platform)],+ },+ {+ id: 'session-history-forward',+ scope: 'app',+ labelKey: 'settings.shortcuts.items.session-history-forward.label',+ descriptionKey: 'settings.shortcuts.items.session-history-forward.description',+ rebindable: true,+ getDefaultCombos: (platform) => [modCombo('BracketRight', platform)],+ },{id: 'cycle-permission-mode',scope: 'composer',diff --git a/docs/design-rules/design-inventory.md b/docs/design-rules/design-inventory.mdindex 85a8714146..96de71c264 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 | 200 |+| `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.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 |