refactor(chat): remove manual view switching

docs/references/file/architecture.md

@@ -198,7 +198,7 @@ The **same physical external file** can therefore be reached by either handle va
 
 ### 2.2 `FileHandle`: the Polymorphic Reference
 
-`FileHandle = FileEntryHandle | FilePathHandle` (see [`src/shared/types/file/handle.ts`](../../../src/shared/types/file/handle.ts)) is the first-class reference type crossing the IPC boundary. Every IPC method that makes sense regardless of which subsystem is in the loop accepts a `FileHandle`; handlers dispatch internally on `handle.kind`. See §3.3 for the full dispatch table.
+`FileHandle = FileEntryHandle | FilePathHandle` (see [`src/shared/utils/file/handle.ts`](../../../src/shared/utils/file/handle.ts)) is the first-class reference type crossing the IPC boundary. Every IPC method that makes sense regardless of which subsystem is in the loop accepts a `FileHandle`; handlers dispatch internally on `handle.kind`. See §3.3 for the full dispatch table.
 
 Use `FileHandle` whenever a signature does not *inherently* require an entry row (e.g. anything that isn't a lifecycle op on a FileEntry).
 

docs/references/file/directory-tree.md

@@ -339,7 +339,7 @@ The hook handles four overlapping concerns:
 
 | Concern | Owner | Cross-reference |
 |---|---|---|
-| Filesystem watching | `createDirectoryWatcher` (transport) | [`watcher/`](../../../src/main/services/file/watcher) |
+| Filesystem watching | `createDirectoryWatcher` (transport) | [`watcher.ts`](../../../src/main/services/file/watcher.ts) |
 | `FileEntry` rows + atomic writes | FileManager | [`file-manager-architecture.md`](./file-manager-architecture.md) |
 | `noteTable` sparse-state metadata | Notes domain (renderer + DataApi) | not part of tree concerns |
 | `.gitignore` parsing | `gitignore.ts` (this module) | private to the tree primitive |

src/main/data/migration/v2/migrators/mappings/PreferencesMappings.ts

@@ -1,6 +1,6 @@
 /**
  * Auto-generated preference mappings from classification.json
- * Generated at: 2026-06-24T07:22:09.467Z
+ * Generated at: 2026-07-05T13:08:15.693Z
  *
  * This file contains pure mapping relationships without default values.
  * Default values are managed in src/shared/data/preferences.ts
@@ -150,6 +150,10 @@ export const REDUX_STORE_MAPPINGS = {
       originalKey: 'fontSize',
       targetKey: 'chat.message.font_size'
     },
+    {
+      originalKey: 'topicPosition',
+      targetKey: 'topic.tab.position'
+    },
     {
       originalKey: 'assistantIconType',
       targetKey: 'assistant.icon_type'
@@ -795,11 +799,11 @@ export const LOCALSTORAGE_MAPPINGS: ReadonlyArray<{ originalKey: string; targetK
 /**
  * 映射统计:
  * - ElectronStore项: 1
- * - Redux Store项: 175
+ * - Redux Store项: 176
  * - Redux分类: settings, selectionStore, llm, nutstore, preprocess, translate, websearch, ocr, note
  * - DexieSettings项: 4
  * - localStorage项: 0
- * - 总配置项: 180
+ * - 总配置项: 181
  *
  * 使用说明:
  * 1. ElectronStore读取: configManager.get(mapping.originalKey)

src/renderer/components/chat/panes/ArtifactPane.tsx

@@ -613,7 +613,7 @@ export function ArtifactPaneView({
     <div
       ref={artifactPaneRef}
       className={cn(
-        'flex h-full min-h-0 flex-col overflow-hidden bg-card text-card-foreground',
+        'flex h-full min-h-0 flex-col overflow-hidden text-card-foreground',
         maximized && 'rounded-lg border border-border-subtle shadow-sm'
       )}>
       <div className="flex min-h-0 flex-1 overflow-hidden">

src/renderer/components/chat/panes/Shell/Shell.tsx

@@ -35,9 +35,10 @@ export interface ShellState {
   pdfLayoutRefreshKey: number
 }
 
-interface ShellActions {
+export interface ShellActions {
   close: (afterClose?: () => void) => void
   finishClose: () => void
+  minimize: () => void
   openTab: (tab: string) => void
   toggleMaximized: () => void
   refreshPdfLayout: () => void
@@ -64,6 +65,10 @@ export function useShellActions(): ShellActions {
   return actions
 }
 
+export function useOptionalShellActions(): ShellActions | undefined {
+  return use(ShellActionsContext) ?? undefined
+}
+
 export function useShellState(): ShellState {
   const state = use(ShellStateContext)
   if (!state) throw new Error('useShellState must be used within <Shell>')
@@ -113,6 +118,22 @@ function ShellProvider({
     closeCallbacksRef.current = []
     for (const callback of callbacks) callback()
   }, [])
+
+  useEffect(() => {
+    if (openRef.current === defaultOpen) return
+
+    openRef.current = defaultOpen
+    setOpen(defaultOpen)
+    if (defaultOpen) {
+      setActiveTab(defaultTab)
+      setPdfLayoutPending(true)
+    } else {
+      setMaximized(false)
+      setPdfLayoutPending(false)
+      finishClose()
+    }
+  }, [defaultOpen, defaultTab, finishClose])
+
   const close = useCallback((afterClose?: () => void) => {
     if (!openRef.current) {
       afterClose?.()
@@ -136,6 +157,10 @@ function ShellProvider({
     })
     onOpenChangeRef.current?.(true)
   }, [])
+  const minimize = useCallback(() => {
+    setPdfLayoutPending(false)
+    setMaximized(false)
+  }, [])
   const toggleMaximized = useCallback(() => {
     setPdfLayoutPending(false)
     setMaximized((currentMaximized) => !currentMaximized)
@@ -150,8 +175,8 @@ function ShellProvider({
     [activeTab, maximized, open, pdfLayoutPending, pdfLayoutRefreshKey]
   )
   const actions = useMemo<ShellActions>(
-    () => ({ close, finishClose, openTab, toggleMaximized, refreshPdfLayout }),
-    [close, finishClose, openTab, refreshPdfLayout, toggleMaximized]
+    () => ({ close, finishClose, minimize, openTab, toggleMaximized, refreshPdfLayout }),
+    [close, finishClose, minimize, openTab, refreshPdfLayout, toggleMaximized]
   )
 
   return (
@@ -352,7 +377,7 @@ function ShellTabs({ children }: { children: ReactNode }) {
       value={state.activeTab}
       onValueChange={actions.openTab}
       variant="line"
-      className="h-full gap-0 overflow-hidden bg-card text-card-foreground">
+      className="h-full gap-0 overflow-hidden text-card-foreground">
       {children}
     </Tabs>
   )

src/renderer/components/chat/panes/Shell/__tests__/Shell.test.tsx

@@ -207,6 +207,16 @@ function ShellStateSnapshot() {
   )
 }
 
+function ShellMinimizeButton() {
+  const actions = useShellActions()
+
+  return (
+    <button type="button" onClick={actions.minimize}>
+      minimize shell
+    </button>
+  )
+}
+
 function triggerRightSidebarShortcut() {
   const handler = shortcutHandlers.get('topic.sidebar.toggle')
   if (!handler) throw new Error('Expected right sidebar shortcut to be registered')
@@ -326,6 +336,41 @@ describe('Shell.Toggle', () => {
     expect(screen.getByRole('button', { name: 'common.close_sidebar' })).toHaveAttribute('data-state', 'open')
   })
 
+  it('syncs when the owning component changes the default open state', () => {
+    const { rerender } = render(
+      <Shell defaultTab="files" defaultOpen>
+        <Shell.Toggle tab="files" command="topic.sidebar.toggle" />
+        <OpenTraceButton />
+        <ShellStateSnapshot />
+      </Shell>
+    )
+
+    expect(screen.getByTestId('shell-state')).toHaveTextContent('open:files:false')
+
+    fireEvent.click(screen.getByRole('button', { name: 'open trace' }))
+    expect(screen.getByTestId('shell-state')).toHaveTextContent('open:trace:false')
+
+    rerender(
+      <Shell defaultTab="files" defaultOpen={false}>
+        <Shell.Toggle tab="files" command="topic.sidebar.toggle" />
+        <OpenTraceButton />
+        <ShellStateSnapshot />
+      </Shell>
+    )
+
+    expect(screen.getByTestId('shell-state')).toHaveTextContent('closed:trace:false')
+
+    rerender(
+      <Shell defaultTab="files" defaultOpen>
+        <Shell.Toggle tab="files" command="topic.sidebar.toggle" />
+        <OpenTraceButton />
+        <ShellStateSnapshot />
+      </Shell>
+    )
+
+    expect(screen.getByTestId('shell-state')).toHaveTextContent('open:files:false')
+  })
+
   it('does not rerender actions-only consumers when shell state changes', () => {
     render(
       <Shell defaultTab="files">
@@ -382,6 +427,29 @@ describe('Shell.Toggle', () => {
     expect(screen.getByTestId('shell-state')).toHaveTextContent('closed:files:false')
   })
 
+  it('minimizes from maximized mode without closing the pane', () => {
+    render(
+      <Shell defaultTab="files">
+        <Shell.Toggle tab="files" command="topic.sidebar.toggle" />
+        <Shell.Tabs>
+          <Shell.TabList>
+            <Shell.Tab value="files">Files</Shell.Tab>
+          </Shell.TabList>
+        </Shell.Tabs>
+        <ShellMinimizeButton />
+        <ShellStateSnapshot />
+      </Shell>
+    )
+
+    triggerRightSidebarShortcut()
+    fireEvent.click(screen.getByRole('button', { name: 'common.maximize' }))
+    expect(screen.getByTestId('shell-state')).toHaveTextContent('open:files:true')
+
+    fireEvent.click(screen.getByRole('button', { name: 'minimize shell' }))
+
+    expect(screen.getByTestId('shell-state')).toHaveTextContent('open:files:false')
+  })
+
   it('does not respond to the right sidebar shortcut when disabled', () => {
     render(
       <Shell defaultTab="files">

src/renderer/components/chat/panes/Shell/index.ts

@@ -8,4 +8,4 @@ export {
   useResourcePane
 } from './resourcePane'
 export { ResourcePaneCountButton, type ResourcePaneCountButtonProps } from './ResourcePaneCountButton'
-export { Shell, useOptionalShellState, useShellActions, useShellState } from './Shell'
+export { Shell, useOptionalShellActions, useOptionalShellState, useShellActions, useShellState } from './Shell'

src/renderer/components/chat/panes/Shell/resourcePane.tsx

@@ -5,7 +5,7 @@ import { createContext, type ReactNode, use, useEffect, useRef } from 'react'
 import { Shell, useShellActions } from './Shell'
 
 // ── Resource-list-as-right-pane wiring ──────────────────────────────────────
-// In classic-layout mode (`topic.layout`/`agent.layout === 'classic'`) the topic/session list moves into the
+// In classic-layout mode the topic/session list moves into the
 // chat's right pane as an extra tab. The list node + its label are provided once at
 // the page level via context, so the Chat/AgentChat tree and the pane surfaces don't prop-thread
 // them through every layer. The tab/panel/toggle below derive everything from this context, and