dsh-workspace-explorer 1.1.0 → 1.1.2

package/src/host/shell-files.js

@@ -1,82 +1,82 @@
-import { execFile } from 'node:child_process';
-import { win32 as path } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { promisify } from 'node:util';
-
-const execute = promisify(execFile);
-const helper = fileURLToPath(new URL('./ExplorerShell.cs', import.meta.url));
-const script = String.raw`
-$ErrorActionPreference = 'Stop'
-[Console]::OutputEncoding = New-Object System.Text.UTF8Encoding($false)
-[Console]::InputEncoding = [System.Text.Encoding]::UTF8
-Add-Type -Path $env:DSH_EXPLORER_SHELL
-$request = ConvertFrom-Json ([Console]::In.ReadToEnd())
-if ($request.action -in 'stage', 'clipboard') {
-    Add-Type -AssemblyName System.Windows.Forms
-}
-switch ($request.action) {
-    'stage' {
-        $paths = New-Object System.Collections.Specialized.StringCollection
-        foreach ($source in $request.sources) { [void]$paths.Add($source) }
-        $data = New-Object System.Windows.Forms.DataObject
-        $data.SetFileDropList($paths)
-        $effect = if ($request.cut) { 2 } else { 1 }
-        $stream = New-Object System.IO.MemoryStream -ArgumentList (,[BitConverter]::GetBytes([int]$effect))
-        $data.SetData('Preferred DropEffect', $false, $stream)
-        [System.Windows.Forms.Clipboard]::SetDataObject($data, $true, 8, 30)
-        @{ ok = $true } | ConvertTo-Json -Compress
-    }
-    'clipboard' {
-        for ($attempt = 0; $attempt -lt 3; $attempt++) {
-            try {
-                $sequence = [ExplorerShell]::GetClipboardSequenceNumber()
-                $paths = @([System.Windows.Forms.Clipboard]::GetFileDropList())
-                $cut = if ($paths.Count -gt 0) { [ExplorerShell]::ClipboardIsCut() } else { $false }
-                if ($sequence -eq [ExplorerShell]::GetClipboardSequenceNumber()) {
-                    @{ paths = $paths; cut = $cut; sequence = $sequence } | ConvertTo-Json -Compress
-                    return
-                }
-            } catch {
-                if ($attempt -eq 2) { throw }
-            }
-            Start-Sleep -Milliseconds 40
-        }
-        throw 'Clipboard changed'
-    }
-    'clearCut' {
-        [ExplorerShell]::ClearClipboardIfUnchanged($request.sequence)
-        @{ ok = $true } | ConvertTo-Json -Compress
-    }
-    'transfer' {
-        $results = @(foreach ($source in $request.sources) {
-            try { [ExplorerShell]::Transfer($source, $request.destination, $request.cut) }
-            catch { $false }
-        })
-        @{ results = $results } | ConvertTo-Json -Compress
-    }
-    'rename' {
-        @{ code = [ExplorerShell]::Rename($request.source, $request.destination) } | ConvertTo-Json -Compress
-    }
-    'recycle' {
-        $results = @(foreach ($source in $request.sources) {
-            try { [ExplorerShell]::Recycle($source) }
-            catch { $false }
-        })
-        @{ results = $results } | ConvertTo-Json -Compress
-    }
-}
-`;
-const encoded = Buffer.from(script, 'utf16le').toString('base64');
-
-export async function windowsFileOperation(request) {
-  const powershell = path.join(process.env.SystemRoot || 'C:\Windows', 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe');
-  const result = execute(powershell, ['-NoProfile', '-NonInteractive', '-STA', '-EncodedCommand', encoded], {
-    windowsHide: true, maxBuffer: 256 * 1024,
-    ...(['transfer', 'recycle'].includes(request.action) ? {} : { timeout: 15000 }),
-    env: { ...process.env, DSH_EXPLORER_SHELL: helper },
-  });
-  result.child.stdin.on('error', () => {}); // The process result reports early exit or spawn failure.
-  result.child.stdin.end(JSON.stringify(request), 'utf8');
-  const { stdout } = await result;
-  return JSON.parse(stdout.trim());
+import { execFile } from 'node:child_process';
+import { win32 as path } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { promisify } from 'node:util';
+
+const execute = promisify(execFile);
+const helper = fileURLToPath(new URL('./ExplorerShell.cs', import.meta.url));
+const script = String.raw`
+$ErrorActionPreference = 'Stop'
+[Console]::OutputEncoding = New-Object System.Text.UTF8Encoding($false)
+[Console]::InputEncoding = [System.Text.Encoding]::UTF8
+Add-Type -Path $env:DSH_EXPLORER_SHELL
+$request = ConvertFrom-Json ([Console]::In.ReadToEnd())
+if ($request.action -in 'stage', 'clipboard') {
+    Add-Type -AssemblyName System.Windows.Forms
+}
+switch ($request.action) {
+    'stage' {
+        $paths = New-Object System.Collections.Specialized.StringCollection
+        foreach ($source in $request.sources) { [void]$paths.Add($source) }
+        $data = New-Object System.Windows.Forms.DataObject
+        $data.SetFileDropList($paths)
+        $effect = if ($request.cut) { 2 } else { 1 }
+        $stream = New-Object System.IO.MemoryStream -ArgumentList (,[BitConverter]::GetBytes([int]$effect))
+        $data.SetData('Preferred DropEffect', $false, $stream)
+        [System.Windows.Forms.Clipboard]::SetDataObject($data, $true, 8, 30)
+        @{ ok = $true } | ConvertTo-Json -Compress
+    }
+    'clipboard' {
+        for ($attempt = 0; $attempt -lt 3; $attempt++) {
+            try {
+                $sequence = [ExplorerShell]::GetClipboardSequenceNumber()
+                $paths = @([System.Windows.Forms.Clipboard]::GetFileDropList())
+                $cut = if ($paths.Count -gt 0) { [ExplorerShell]::ClipboardIsCut() } else { $false }
+                if ($sequence -eq [ExplorerShell]::GetClipboardSequenceNumber()) {
+                    @{ paths = $paths; cut = $cut; sequence = $sequence } | ConvertTo-Json -Compress
+                    return
+                }
+            } catch {
+                if ($attempt -eq 2) { throw }
+            }
+            Start-Sleep -Milliseconds 40
+        }
+        throw 'Clipboard changed'
+    }
+    'clearCut' {
+        [ExplorerShell]::ClearClipboardIfUnchanged($request.sequence)
+        @{ ok = $true } | ConvertTo-Json -Compress
+    }
+    'transfer' {
+        $results = @(foreach ($source in $request.sources) {
+            try { [ExplorerShell]::Transfer($source, $request.destination, $request.cut) }
+            catch { $false }
+        })
+        @{ results = $results } | ConvertTo-Json -Compress
+    }
+    'rename' {
+        @{ code = [ExplorerShell]::Rename($request.source, $request.destination) } | ConvertTo-Json -Compress
+    }
+    'recycle' {
+        $results = @(foreach ($source in $request.sources) {
+            try { [ExplorerShell]::Recycle($source) }
+            catch { $false }
+        })
+        @{ results = $results } | ConvertTo-Json -Compress
+    }
+}
+`;
+const encoded = Buffer.from(script, 'utf16le').toString('base64');
+
+export async function windowsFileOperation(request) {
+  const powershell = path.join(process.env.SystemRoot || 'C:\Windows', 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe');
+  const result = execute(powershell, ['-NoProfile', '-NonInteractive', '-STA', '-EncodedCommand', encoded], {
+    windowsHide: true, maxBuffer: 256 * 1024,
+    ...(['transfer', 'recycle'].includes(request.action) ? {} : { timeout: 15000 }),
+    env: { ...process.env, DSH_EXPLORER_SHELL: helper },
+  });
+  result.child.stdin.on('error', () => {}); // The process result reports early exit or spawn failure.
+  result.child.stdin.end(JSON.stringify(request), 'utf8');
+  const { stdout } = await result;
+  return JSON.parse(stdout.trim());
 }

package/src/thumbnail-types.js

@@ -1,19 +1,19 @@
-const imageExtensions = new Map([
-  ['png', 'image/png'], ['jpg', 'image/jpeg'], ['jpeg', 'image/jpeg'],
-  ['webp', 'image/webp'], ['gif', 'image/gif'], ['bmp', 'image/bmp'],
-  ['ico', 'image/x-icon'], ['avif', 'image/avif'], ['apng', 'image/apng'],
-  ['jfif', 'image/jpeg'], ['heic', 'image/heic'], ['heif', 'image/heif'],
-  ['tif', 'image/tiff'], ['tiff', 'image/tiff'],
-]);
-
-const videoExtensions = new Map([
-  ['mp4', 'video/mp4'], ['m4v', 'video/mp4'], ['webm', 'video/webm'],
-  ['mov', 'video/quicktime'], ['mkv', 'video/x-matroska'], ['ogv', 'video/ogg'],
-  ['avi', 'video/x-msvideo'], ['wmv', 'video/x-ms-wmv'], ['mpeg', 'video/mpeg'],
-  ['mpg', 'video/mpeg'], ['3gp', 'video/3gpp'],
-]);
-
-export function thumbnailType(path) {
-  const extension = /\.([a-z0-9]+)$/i.exec(path)?.[1].toLowerCase();
-  return imageExtensions.get(extension) ?? videoExtensions.get(extension);
+const imageExtensions = new Map([
+  ['png', 'image/png'], ['jpg', 'image/jpeg'], ['jpeg', 'image/jpeg'],
+  ['webp', 'image/webp'], ['gif', 'image/gif'], ['bmp', 'image/bmp'],
+  ['ico', 'image/x-icon'], ['avif', 'image/avif'], ['apng', 'image/apng'],
+  ['jfif', 'image/jpeg'], ['heic', 'image/heic'], ['heif', 'image/heif'],
+  ['tif', 'image/tiff'], ['tiff', 'image/tiff'],
+]);
+
+const videoExtensions = new Map([
+  ['mp4', 'video/mp4'], ['m4v', 'video/mp4'], ['webm', 'video/webm'],
+  ['mov', 'video/quicktime'], ['mkv', 'video/x-matroska'], ['ogv', 'video/ogg'],
+  ['avi', 'video/x-msvideo'], ['wmv', 'video/x-ms-wmv'], ['mpeg', 'video/mpeg'],
+  ['mpg', 'video/mpeg'], ['3gp', 'video/3gpp'],
+]);
+
+export function thumbnailType(path) {
+  const extension = /\.([a-z0-9]+)$/i.exec(path)?.[1].toLowerCase();
+  return imageExtensions.get(extension) ?? videoExtensions.get(extension);
 }

package/src/ui/composer-drop.js

@@ -1,119 +1,119 @@
-import { disks } from './workspace.js';
-
-const { useEffect, useRef } = react;
-const dragType = 'application/x-dsh-workspace-explorer-file';
-const imageTypes = new Map([
-  ['png', 'image/png'], ['jpg', 'image/jpeg'], ['jpeg', 'image/jpeg'],
-  ['gif', 'image/gif'], ['webp', 'image/webp'],
-]);
-
-export function useComposerDrop(sessionId, openFolderTab, reportError, root) {
-  const active = useRef(null);
-
-  useEffect(() => {
-    if (!sessionId) return;
-    const lifetime = new AbortController();
-    const signal = lifetime.signal;
-    let highlighted;
-    let highlightClass;
-
-    function highlight(element, className) {
-      if (element === highlighted && className === highlightClass) return;
-      if (highlighted) highlighted.classList.remove(highlightClass);
-      highlighted = element;
-      highlightClass = className;
-      if (highlighted) highlighted.classList.add(highlightClass);
-    }
-
-    function targetCard(target) {
-      if (!(target instanceof Element)) return null;
-      const conversation = target.closest('[data-conversation-content]');
-      if (conversation?.dataset.conversationSession !== sessionId) return null;
-      const card = conversation.querySelector('[data-composer-card]');
-      return card?.querySelector('[data-composer-input][contenteditable="true"]') ? card : null;
-    }
-
-    function over(event) {
-      const drag = active.current;
-      if (!drag || !event.dataTransfer?.types.includes(dragType)) return;
-      const strip = drag.folder && tabStrip(event.target);
-      if (strip) {
-        highlight(strip, 'dwe-tab-drop-target');
-        event.preventDefault();
-        event.dataTransfer.dropEffect = 'copy';
-        return;
-      }
-      const card = targetCard(event.target);
-      highlight(card, 'dwe-drop-target');
-      if (!card) return;
-      event.preventDefault();
-      event.dataTransfer.dropEffect = 'copy';
-    }
-
-    function reset() {
-      active.current = null;
-      highlight(null);
-    }
-
-    async function drop(event) {
-      const file = active.current;
-      if (!file || event.dataTransfer?.getData(dragType) !== file.token) return;
-      const strip = file.folder && tabStrip(event.target);
-      const card = targetCard(event.target);
-      reset();
-      if (!strip && !card) return;
-      event.preventDefault();
-      event.stopPropagation();
-      reportError('');
-      try {
-        if (strip) {
-          openFolderTab(file.path, strip.dataset.dockkitStrip);
-          return;
-        }
-        if (file.folder) {
-          const editor = card.querySelector('[data-composer-input][contenteditable="true"]');
-          const data = new DataTransfer();
-          data.setData('text/plain', file.path);
-          editor.focus({ preventScroll: true });
-          editor.dispatchEvent(new ClipboardEvent('paste', { bubbles: true, cancelable: true, clipboardData: data }));
-          return;
-        }
-        const bytes = await disks.readBytes(file.path, signal, root);
-        // The composer may have switched sessions or become locked during the read.
-        if (signal.aborted || !card.isConnected || targetCard(card) !== card) return;
-        const extension = file.name.split('.').at(-1)?.toLowerCase();
-        const dataTransfer = new DataTransfer();
-        dataTransfer.items.add(new File([bytes], file.name, {
-          type: imageTypes.get(extension) ?? 'application/octet-stream',
-        }));
-        // Use the composer's existing attachment intake, including its file checks.
-        card.dispatchEvent(new DragEvent('drop', { bubbles: true, cancelable: true, dataTransfer }));
-      } catch (error) {
-        if (!signal.aborted) reportError('无法拖入会话 · ' + (error?.message || String(error)));
-      }
-    }
-
-    document.addEventListener('dragover', over, { signal, capture: true });
-    document.addEventListener('drop', drop, { signal, capture: true });
-    window.addEventListener('dragend', reset, { signal });
-    return () => {
-      lifetime.abort();
-      reset();
-    };
-  }, [sessionId, openFolderTab, reportError, root]);
-
-  return (event, path, name, folder = false) => {
-    if (!sessionId) {
-      event.preventDefault();
-      return;
-    }
-    const token = crypto.randomUUID();
-    active.current = { token, path, name, folder };
-    event.dataTransfer.effectAllowed = 'copy';
-    event.dataTransfer.setData(dragType, token);
-  };
-}
-
-function tabStrip(target) {
-  return target instanceof Element ? target.closest('[data-dockkit-strip]') : null;
-}
+import { disks } from './workspace.js';
+
+const { useEffect, useRef } = react;
+const dragType = 'application/x-dsh-workspace-explorer-file';
+const imageTypes = new Map([
+  ['png', 'image/png'], ['jpg', 'image/jpeg'], ['jpeg', 'image/jpeg'],
+  ['gif', 'image/gif'], ['webp', 'image/webp'],
+]);
+
+export function useComposerDrop(sessionId, openFolderTab, reportError, root) {
+  const active = useRef(null);
+
+  useEffect(() => {
+    if (!sessionId) return;
+    const lifetime = new AbortController();
+    const signal = lifetime.signal;
+    let highlighted;
+    let highlightClass;
+
+    function highlight(element, className) {
+      if (element === highlighted && className === highlightClass) return;
+      if (highlighted) highlighted.classList.remove(highlightClass);
+      highlighted = element;
+      highlightClass = className;
+      if (highlighted) highlighted.classList.add(highlightClass);
+    }
+
+    function targetCard(target) {
+      if (!(target instanceof Element)) return null;
+      const conversation = target.closest('[data-conversation-content]');
+      if (conversation?.dataset.conversationSession !== sessionId) return null;
+      const card = conversation.querySelector('[data-composer-card]');
+      return card?.querySelector('[data-composer-input][contenteditable="true"]') ? card : null;
+    }
+
+    function over(event) {
+      const drag = active.current;
+      if (!drag || !event.dataTransfer?.types.includes(dragType)) return;
+      const strip = drag.folder && tabStrip(event.target);
+      if (strip) {
+        highlight(strip, 'dwe-tab-drop-target');
+        event.preventDefault();
+        event.dataTransfer.dropEffect = 'copy';
+        return;
+      }
+      const card = targetCard(event.target);
+      highlight(card, 'dwe-drop-target');
+      if (!card) return;
+      event.preventDefault();
+      event.dataTransfer.dropEffect = 'copy';
+    }
+
+    function reset() {
+      active.current = null;
+      highlight(null);
+    }
+
+    async function drop(event) {
+      const file = active.current;
+      if (!file || event.dataTransfer?.getData(dragType) !== file.token) return;
+      const strip = file.folder && tabStrip(event.target);
+      const card = targetCard(event.target);
+      reset();
+      if (!strip && !card) return;
+      event.preventDefault();
+      event.stopPropagation();
+      reportError('');
+      try {
+        if (strip) {
+          openFolderTab(file.path, strip.dataset.dockkitStrip);
+          return;
+        }
+        if (file.folder) {
+          const editor = card.querySelector('[data-composer-input][contenteditable="true"]');
+          const data = new DataTransfer();
+          data.setData('text/plain', file.path);
+          editor.focus({ preventScroll: true });
+          editor.dispatchEvent(new ClipboardEvent('paste', { bubbles: true, cancelable: true, clipboardData: data }));
+          return;
+        }
+        const bytes = await disks.readBytes(file.path, signal, root);
+        // The composer may have switched sessions or become locked during the read.
+        if (signal.aborted || !card.isConnected || targetCard(card) !== card) return;
+        const extension = file.name.split('.').at(-1)?.toLowerCase();
+        const dataTransfer = new DataTransfer();
+        dataTransfer.items.add(new File([bytes], file.name, {
+          type: imageTypes.get(extension) ?? 'application/octet-stream',
+        }));
+        // Use the composer's existing attachment intake, including its file checks.
+        card.dispatchEvent(new DragEvent('drop', { bubbles: true, cancelable: true, dataTransfer }));
+      } catch (error) {
+        if (!signal.aborted) reportError('无法拖入会话 · ' + (error?.message || String(error)));
+      }
+    }
+
+    document.addEventListener('dragover', over, { signal, capture: true });
+    document.addEventListener('drop', drop, { signal, capture: true });
+    window.addEventListener('dragend', reset, { signal });
+    return () => {
+      lifetime.abort();
+      reset();
+    };
+  }, [sessionId, openFolderTab, reportError, root]);
+
+  return (event, path, name, folder = false) => {
+    if (!sessionId) {
+      event.preventDefault();
+      return;
+    }
+    const token = crypto.randomUUID();
+    active.current = { token, path, name, folder };
+    event.dataTransfer.effectAllowed = 'copy';
+    event.dataTransfer.setData(dragType, token);
+  };
+}
+
+function tabStrip(target) {
+  return target instanceof Element ? target.closest('[data-dockkit-strip]') : null;
+}

package/src/ui/explorer.js

@@ -1,5 +1,5 @@
 import { joinPath, move, parentOf, renamePath, resourceAddress, underPath, visit, windowsPath } from './navigation.js';
-import { Preview, PreviewBoundary } from './preview.js';
+import { formatSize, Preview, PreviewBoundary } from './preview.js';
 import { disks } from './workspace.js';
 import { useComposerDrop } from './composer-drop.js';
 import { Thumbnail } from './thumbnail.js';
@@ -80,14 +80,6 @@ function selectNames(current, name, entries, shift, ctrl) {
   return { names, anchor: name };
 }
 
-function formatSize(bytes) {
-  if (typeof bytes !== 'number') return '—';
-  if (bytes < 1024) return bytes + ' B';
-  if (bytes < 1024 ** 2) return (bytes / 1024).toFixed(1) + ' KB';
-  if (bytes < 1024 ** 3) return (bytes / 1024 ** 2).toFixed(1) + ' MB';
-  return (bytes / 1024 ** 3).toFixed(1) + ' GB';
-}
-
 function entryType(entry) {
   if (entry.type === 'drive') return '磁盘';
   if (entry.type === 'directory') return '文件夹';
@@ -175,21 +167,19 @@ function PreviewDivider({ root, ratio, setRatio }) {
 }
 
 export function Explorer({
-  cwd, sessionId, initialPath, bindFileActions, getTarget, onPath, openLocal, openFolderTab,
+  cwd, sessionId, initialPath, bindFileActions, getTarget, onPath, openLocal, openDocument, openFolderTab,
   refreshDirectories, updateRenamedPath,
 }) {
   const workspace = windowsPath(cwd);
   const [localHistory, setLocalHistory] = useState(() => firstPath(initialPath ?? workspace));
   const [scoped, setScoped] = useState(null);
   const workspaceMode = scoped !== null;
-  const root = workspaceMode ? (sessionId ? workspace : scoped.root) : null;
-  const history = workspaceMode ? (root === scoped.root ? scoped.history : firstPath(root)) : localHistory;
+  const root = scoped?.root ?? null;
+  const history = scoped?.history ?? localHistory;
   const changeHistory = useCallback(change => {
-    if (workspaceMode) setScoped(current => current && {
-      root, history: change(current.root === root ? current.history : firstPath(root)),
-    });
+    if (workspaceMode) setScoped(current => current && { ...current, history: change(current.history) });
     else setLocalHistory(change);
-  }, [workspaceMode, root]);
+  }, [workspaceMode]);
   const [revision, setRevision] = useState(0);
   const [listing, setListing] = useState(null);
   const [selection, setSelection] = useState(emptySelection);
@@ -244,7 +234,7 @@ export function Explorer({
       if (!current) return current;
       const absolute = renamePath(current.absolute, from, to);
       return absolute === current.absolute ? current
-        : { absolute, name: absolute.split('\\').at(-1), address: resourceAddress(absolute) };
+        : { ...current, absolute, name: absolute.split('\\').at(-1), address: resourceAddress(absolute) };
     });
   }, []);
   const closeMenu = useCallback((restore = false) => {
@@ -295,12 +285,6 @@ export function Explorer({
     setScoped(workspaceMode ? null : { root: workspace, history: firstPath(workspace) });
   }
 
-  useLayoutEffect(() => {
-    if (!workspaceMode || !root || root === scoped.root) return;
-    resetNavigation();
-    setScoped({ root, history: firstPath(root) });
-  }, [workspaceMode, root, scoped?.root, resetNavigation]);
-
   useLayoutEffect(() => { onPath(path); }, [onPath, path]);
 
   useEffect(() => {
@@ -331,7 +315,6 @@ export function Explorer({
   }, [root, term, revision, sessionId]);
 
   useEffect(() => () => pathRequest.current?.abort(), []);
-  useLayoutEffect(() => bindFileActions({ refresh, rename }), [bindFileActions, refresh, rename]);
   useLayoutEffect(() => { scroll.current.scrollTop = 0; }, [path, term]);
   useLayoutEffect(() => {
     const result = resultToReveal.current;
@@ -356,20 +339,33 @@ export function Explorer({
     changeHistory(value => move(value, delta));
   }
 
-  function openPreview(absolute, name) {
-    setPreview(current => current?.absolute === absolute ? current : {
-      name, absolute, address: resourceAddress(absolute),
+  const openPreview = useCallback((absolute, name, size, line) => {
+    const targetLine = Number.isSafeInteger(line) && line > 0 ? line : undefined;
+    setPreview(current => current?.absolute === absolute && !targetLine ? current : {
+      name, absolute, size, line: targetLine, address: resourceAddress(absolute),
     });
-  }
+  }, []);
 
-  function openSearchHit(match) {
-    if (!underPath(match.path, root)) return;
-    const folder = parentOf(match.path);
-    navigate(folder);
-    resultToReveal.current = { folder, name: match.name };
-    setSelection(singleSelection(match.name));
-    openPreview(match.path, match.name);
+  const revealFile = useCallback((absolute, name, size, line) => {
+    const folder = parentOf(absolute);
+    if (workspaceMode && !underPath(folder, root)) {
+      resetNavigation();
+      setScoped(null);
+      setLocalHistory(history => visit(history, folder));
+    } else {
+      navigate(folder);
+      if (folder === path && ready && !ready.entries.some(entry => entry.name === name)) refresh();
+    }
+    resultToReveal.current = { folder, name };
+    setSelection(singleSelection(name));
+    openPreview(absolute, name, size, line);
     setPreviewOpen(true);
+  }, [workspaceMode, root, path, ready, resetNavigation, navigate, refresh, openPreview]);
+
+  useLayoutEffect(() => bindFileActions({ refresh, rename, reveal: revealFile }), [bindFileActions, refresh, rename, revealFile]);
+
+  function openSearchHit(match) {
+    if (underPath(match.path, root)) revealFile(match.path, match.name);
   }
 
   function select(event, entry) {
@@ -378,7 +374,7 @@ export function Explorer({
     setSelection(current => selectNames(current, entry.name, entries, shiftKey, ctrlKey));
     setActionError('');
     setActionNotice('');
-    if (!shiftKey && !ctrlKey && entry.type === 'file') openPreview(joinPath(path, entry.name), entry.name);
+    if (!shiftKey && !ctrlKey && entry.type === 'file') openPreview(joinPath(path, entry.name), entry.name, entry.size);
   }
 
   async function openWithWindows(path) {
@@ -511,7 +507,7 @@ export function Explorer({
       if (target.type === 'directory') navigate(windowsPath(target.path));
       else {
         closeEditor();
-        openPreview(target.path, target.name);
+        openPreview(target.path, target.name, target.size);
       }
       scroll.current.focus();
     } catch (error) {
@@ -529,7 +525,9 @@ export function Explorer({
     if (!target || !shownPreview) return;
     try {
       if (root) await disks.locate(shownPreview.absolute, undefined, root);
-      if (getTarget() === target) target.actions.openResource(resourceAddress(shownPreview.absolute, target.sessionId));
+      if (getTarget() === target) openDocument(resourceAddress(shownPreview.absolute, target.sessionId), {
+        paneId: target.paneId, params: shownPreview.line ? { line: shownPreview.line } : undefined,
+      });
     } catch (error) {
       setActionError(error?.message || String(error));
     }
@@ -586,6 +584,7 @@ export function Explorer({
           tool('home', workspaceMode ? '返回工作区根目录' : '返回此电脑', () => navigate(root), path === root),
           tool('workspace', '跳转至工作区', () => navigate(workspace), !workspace || path === workspace || workspaceMode)),
         h('div', { className: 'dwe-nav' },
+          h('span', { className: 'dwe-v-divider', 'aria-hidden': true }),
           tool('copy', '复制', () => runAction('copy', selectedEntries), !modifySelected),
           tool('cut', '剪切', () => runAction('cut', selectedEntries), !modifySelected),
           tool('paste', '粘贴', () => runAction('paste'), !path || working),
@@ -651,14 +650,15 @@ export function Explorer({
                 !grid && h('span', { className: 'dwe-meta' }, entryType(entry)),
                 !grid && h('span', { className: 'dwe-meta' }, formatSize(entry.size))))))),
       h('footer', { className: 'dwe-status-bar' },
+        h('div', { className: 'dwe-nav', role: 'group', 'aria-label': '文件视图' },
+          tool('list', '列表', () => changeView('list'), false, !grid),
+          tool('grid', '大图标', () => changeView('grid'), false, grid)),
+        h('span', { className: 'dwe-v-divider', 'aria-hidden': true }),
         h('span', { className: 'dwe-status', role: 'status', title: actionNotice },
           term ? found?.matches ? found.matches.length + ' 个结果' + (found.truncated ? ' · 请缩小关键词' : '') : ' '
             : actionNotice || (selectedEntries.length > 1 ? '已选择 ' + selectedEntries.length + ' 项'
               : ready?.entries ? ready.entries.length + ' 个项目' + (ready.truncated ? ' · 列表已截断' : '') : ' ')),
-        h('div', { className: 'dwe-nav', role: 'group', 'aria-label': '视图与预览' },
-          tool('list', '列表', () => changeView('list'), false, !grid),
-          tool('grid', '大图标', () => changeView('grid'), false, grid),
-          tool('preview', '预览窗格', () => setPreviewOpen(open => !open), false, previewOpen)))),
+        tool('preview', '预览窗格', () => setPreviewOpen(open => !open), false, previewOpen))),
     previewOpen && h(PreviewDivider, { root: layout, ratio: splitRatio, setRatio: setSplitRatio }),
     previewOpen && h('section', { className: 'dwe-preview', 'aria-label': '文件预览' },
       h('header', { className: 'dwe-preview-bar' },