Skip to content

armgit / cindy

Public Imported from GitHub
0

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

feat(desktop): 左上角新增任务浏览前进/后退

WZBbiao23b4665fccab
diff --git a/apps/desktop/src/renderer/components/layout/ChromeActions.tsx b/apps/desktop/src/renderer/components/layout/ChromeActions.tsx
index 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.tsx
index 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 不被计入 ——
否则浮层按钮点击会被窗口拖拽吞掉。 */}
<div
aria-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.tsx
index 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.tsx
new file mode 100644
index 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.ts
index 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.tsx
index 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({
>
<div
aria-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.tsx
index 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 = (
<button
type="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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.json
index 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.json
index 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.json
index 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.json
index 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.json
index 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.ts
index 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.md
index 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 |