Introduction

When handling files in a DSH session, a common problem is that files are not only located in the current working directory: some are on the local disk, some are in the WSL file system, and some are materials within the current project. Existing approaches usually revolve around the working directory, requiring manual search and switching to other windows for preview when crossing directories or file systems.

PeekFile is a plugin for DeepSeek Harness (DSH) that provides full-disk file search, directory browsing, and multi-format preview. It integrates operations such as search, browse, preview, reference, screenshot, OCR, and format conversion directly into the DSH session, reducing the back-and-forth switching caused by scattered files.

Basic Information

  • Plugin: fastengiel-kurai/dsh-peekfile-everything
  • Maintainer: fastengiel-kurai
  • License: AGPL-3.0-only
  • GitHub: https://github.com/fastengiel-kurai/dsh-peekfile-everything
  • Verified Environment: DSH 0.1.0-rc.8, Node.js >= 22, Windows 11 + WSL2 Ubuntu 24.04

Better Sidebar, Everything, document conversion, and OCR tools are all optional components. Without these components installed, you can still use working directory/WSL search, directory browsing, and basic format preview.

Core Features

PeekFile supports three types of file search sources:

  • Working Directory
  • WSL
  • Windows Everything

These three sources can be used in combination. Search results support pagination and sorting across multiple sources and retain a deduplicated history of the last 10 entries. Search results are only cached in the current page’s memory and not written to disk; the old cache is released when starting a new search.

If existing results need to be narrowed down further, you can append +keyword to the original query for secondary filtering, for example:

动画片 +合集

Directory Browsing

PeekFile supports continuing to browse directories. For files that do not support embedded preview, such as compressed archives, PeekFile does not unpack them automatically but hands them over to the system-associated program to open.

Dialogue Path Interception

If the model outputs valid local paths in the conversation, PeekFile automatically identifies these paths and converts them into clickable preview links. Supported path types include:

  • Windows paths
  • WSL/POSIX paths
  • Workspace local paths

PeekFile also supports DSH native file reference capsules, and line number range references similar to the following:

@路径:起始行-结束行

Non-image files can be dragged into the input box and saved to the workspace .dsh-drops/; the default single-file limit is 10 MB.

Floating Preview Window

PeekFile defaults to using a floating preview window instead of a fixed sidebar. The window supports:

  • Multiple Tabs
  • Middle-click to close
  • Refresh
  • Save As
  • Open in System

Local preview does not limit file size by default, and the preview limit can be configured separately.

File Preview and Conversion

PeekFile supports previewing the following types:

  • Text
  • Code
  • Markdown
  • CSV
  • Images
  • Video
  • PDF
  • Office
  • EPUB
  • Calibre convertible e-books

It also provides the following capabilities:

  • Screenshot
  • Box Screenshot
  • OCR
  • FFmpeg to MP4 conversion
  • OfficeCLI to HTML preview
  • AnyDoc full-text sending

When a video cannot be played, “Convert to MP4” can be displayed; after FFmpeg converts it to H.264/AAC MP4, it will play automatically.

Integration with Better Sidebar

PeekFile can work with Better Sidebar. You can specify whether PeekFile or Better Sidebar handles files based on file type.

Please note that Better Sidebar can only preview files within the working directory; files outside the working directory are always handled by PeekFile.

Installation and Activation

Install using the DSH plugin command:

dsh plugin --profile web add @fastengiel/dsh-peekfile-everything

After installation, restart DSH Web and perform a hard refresh in the browser.

If enabling external tools, PeekFile will not automatically modify the operating system environment. You need to enable the corresponding tools in settings and fill in the command path.

Typical Usage

  1. Start DSH Web, enter any session, and click PeekFiles in the top right corner of the session.
  2. Enter a filename in the search box, for example:
   report.pdf

Keep “Working Directory / WSL / Everything” all selected and click search.
3. Click a directory to continue browsing; clicking a file switches to the preview area.
4. If Everything is not installed, you can uncheck Everything in the scope menu after the search button and can still use Working Directory and WSL search.
5. If you need to further filter the current cached results, append +keyword to the original query, for example:

   动画片 +合集
  1. Have the model output valid local paths in the conversation, then directly click the path to preview.
  2. If a video cannot be played, click “Convert to MP4”; after FFmpeg converts it to H.264/AAC MP4, it will play automatically.

Applicable Scenarios and Notes

Suitable for use in DSH Web when frequently needing to find files outside the current working directory, such as documents, PDFs, Office files, images, videos, or e-books on the Windows local disk or in the WSL file system.

Before use, please note the following points:

  • Better Sidebar, Everything, document conversion, and OCR tools are all optional components.
  • Other Linux environments may run, but equivalent live environment verification has not been completed.
  • On macOS, the Box Screenshot entry is currently hidden.
  • Everything 1.5 is required to load CLI; versions lower than 1.5 cannot load CLI.
  • Search results are only cached in the current page’s memory and not written to disk.
  • Non-image files dragged into the input box will be saved to the workspace .dsh-drops/, with a default single-file limit of 10 MB.
  • The plugin runs with the permissions of the current dsh process. You should check the source code and license before installation; this plugin’s license is AGPL-3.0-only, and the source code can be viewed in the GitHub repository.

Links

  • GitHub: https://github.com/fastengiel-kurai/dsh-peekfile-everything