Preface

DSH’s plugin ecosystem supports extending web-side capabilities by profile. dsh-filescope provides the file browsing capability: placing the current workspace’s directory tree and file preview into a right-side drawer on the web page, suitable for viewing the corresponding workspace content when switching between sessions.

It is positioned as read-only browsing: it only displays directories, files, and file contents, without providing any write operations.

What Is This

dsh-filescope is a DeepSeek Harness plugin, named FileScope · 文件视界, with the package name dsh-filescope.

The problem it solves is: within a DSH web session, without leaving the current page, you can directly view the current session’s workspace directory structure, file sizes, text file contents, binary file summaries, and oversized file warnings.

The repository address is:

https://github.com/KunIsMe/dsh-filescope

The license is MIT; the license is marked as © 2025 zhangkun, and the GitHub owner is KunIsMe.

Core Features

Below are verified capabilities listed based on actual usage.

Entry & Layout

  • Full-height right-side drawer-style file browser.
  • Can be opened from the bottom of the sidebar.
  • Can be opened from the top action bar in the session.
  • Clicking the overlay collapses the drawer.
  • The vertical strip on the left edge of the drawer allows width adjustment, ranging from 320px to 85vw.
  • The horizontal strip between the directory tree and preview area allows height adjustment.

Workspace Following

  • When switching sessions, the directory tree automatically follows the workspace of the current session.
  • The matching logic reads the current session’s cwd and matches it against registered workspaces.
  • You can also manually switch workspaces.
  • The top dropdown allows selecting a workspace.
  • You can also enter an absolute path and press Enter.

Directory Browsing

  • Supports expanding and collapsing the full directory hierarchy.
  • Directories are sorted first.
  • Displays file sizes.
  • “Expand All” recursively loads descendant levels, with a limit of 3000 nodes.
  • “Hide Dotfiles” filters out entries starting with ..

File Preview

  • Real-time preview of text files with line numbers.
  • The line-numbered text preview covers the first 2000 lines.
  • Binary files display a hex summary.
  • Oversized files display a warning.

Real-time Refresh

When real-time refresh is enabled:

  • The currently open file is checked for version changes every 2s and automatically re-read.
  • Expanded directories refresh every 5s.

Installation & Enabling

The plugin runs with the permissions of the current dsh process. Before installation, it is recommended to review the source code, read-only API boundaries, and license.

Installation command:

dsh plugin --profile web add dsh-filescope

After installation, stop the current dsh web process, then run:

dsh --profile web

Host combinations are loaded at process startup, so new content requires restarting the dsh web process to be mounted. After restarting, refresh the browser page:

Cmd+Shift+R

The entry will be visible after refreshing.

Environment requirements:

  • The dsh version should match the source tree used to build this package.
  • The web profile must have the dsh-web-app layer mounted, i.e., @deepseek-ai/dsh-web-app.

Typical Usage

  1. Open the drawer via the “FileScope” button at the bottom of the sidebar or in the top action bar of the session.
  2. When switching sessions, the directory tree automatically follows the workspace of that session.
  3. Select a workspace from the top dropdown, or enter any absolute path and press Enter.
  4. Use “Expand All” to recursively load all levels, noting the limit of 3000 nodes.
  5. Use “Hide Dotfiles” to filter out entries starting with ..
  6. Click a file to preview it: text files show line numbers, binary files show a hex summary, and oversized files show a warning.
  7. After enabling “Real-time Refresh,” the current file is checked for changes every 2s, and expanded directories refresh every 5s.
  8. Drag the left edge of the drawer to adjust width, and drag the divider between the directory tree and preview area to adjust height.

Applicable Scenarios & Notes

  • Suitable for read-only viewing of the current workspace’s directories, files, file sizes, and file contents in DSH Web.
  • Suitable for quickly confirming the current workspace structure after switching between sessions.
  • Does not provide any write operations.
  • The API boundary is a GET-only JSON API.
  • Text preview only displays the first 2000 lines.
  • “Expand All” has a recursive loading limit of 3000 nodes.
  • After modifying plugin configuration or Host combinations, you need to restart the dsh web process and refresh the browser page.
  • In verified materials, the README’s manual integration example references version 0.1.2, while the version field in package.json is 0.1.3. Before installation, you can confirm the package version that the target profile actually resolves to.

Links

  • GitHub: https://github.com/KunIsMe/dsh-filescope
  • Community directory: the dsh-filescope entry in the community directory; this article does not provide a specific directory page URL.