Skip to content

armgit / cindy

Public Imported from GitHub
0

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

fix(desktop): 采纳 review:栈外后退、删除清理、账号隔离与测试合并

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