Preface

In the DSH web UI, after a workspace is added, developers often need to pass a file to the model for reading. Without a directory browsing entry, manually entering the path can be inconvenient. dsh-workspace-explorer is a DSH workspace file explorer plugin: it provides a “Workspace Files” capsule button in the session header, opens the directory tree of the current workspace, and supports clicking or dragging to append file references to the composer. Below, we introduce its features, installation methods, and notes.

What is this

@jiyr0119/dsh-workspace-explorer is a native DSH plugin maintained by Jiyr0119, licensed under MIT. It is designed for the DSH web UI, addressing the issue of “having files in the workspace but lacking a browsable, insertable file tree in the session panel.”

Core Features

  • Provides a “Workspace Files” capsule button in the session header, which opens a pop-up panel with the current workspace directory tree.
  • The top of the panel allows switching between the Files and Settings tabs.
  • The Settings page allows real-time adjustment of hidden noise directories, display size, reference format, preview line count, and panel width, syncing to DSH Settings → Workspace Explorer.
  • Directories are lazily loaded as needed, and noise directories like node_modules, .git, dist, and __pycache__ are automatically hidden.
  • Displays colored file type icons based on file extensions.
  • Clicking a file row appends a [file: relative-path] reference to the composer.
  • Dragging a file to the composer inserts a reference; dragging a folder inserts a compact directory list with limited depth.
  • Supports Shift / ⌘ multi-selection and batch insertion of file references or directory lists.
  • Adapts to light and dark themes based on DSH’s --dsw-alias-* design tokens.
  • Allows filtering files by name across loaded directories and displays the match count.
  • Supports paginated preview for text files; small files (≤ 32 KB) can paste their full content.
  • Supports split-pane preview, with a 340px preview panel on the left and the file tree remaining visible on the right.
  • Allows editing files within the preview panel, with saves writing directly to disk and detecting external modifications.
  • Registers zh / en dictionaries via DSH locale service and follows the DSH UI language.

Installation and Activation

The native installation command is as follows. This command installs the npm package, and after installation, it is used in the DSH web UI:

dsh plugin --profile web add -w @jiyr0119/dsh-workspace-explorer@latest

The -w flag is used to bypass pnpm 9/10’s default behavior of refusing to add dependencies in the workspace root. If not using -w, you can create ~/.dsh/profiles/web/.npmrc and add:

ignore-workspace-root-check=true

Note: Listing the plugin alone does not automatically install it; the user must click to install or run the installation command.

Alternatively, you can use the dynamic plugin method, suitable for quick verification or environments without a storefront:

  1. Run cordis_define in the DSH web UI.
  2. Paste dynamic/host.js into Host code.
  3. Paste dynamic/client.js into Client code.
  4. Run cordis_run to activate.
  5. On first run, complete authorization in the Run card.

Typical Usage

  1. Run the installation command or activate using the dynamic plugin method.
  2. Click the “Workspace Files” capsule button in the session header to open the panel.
  3. Expand directories to browse files.
  4. Click a file row or drag a file into the composer, then send it.
  5. If you need to adjust hidden directories, display size, reference format, preview line count, or panel width, use the Settings tab at the top of the panel or go to DSH Settings → Workspace Explorer.

Use Cases and Notes

This plugin is suitable for developers working locally in the DSH web UI for workspace development and debugging, who frequently need to reference source code, configurations, documents, and other files to the model. It consolidates directory browsing, file referencing, previewing, and editing into the same session panel, reducing the steps for manual path entry.

Before use, it is recommended to check the repository source code, dependencies, and current version. The captured materials do not show the complete scripts, dependencies, and project structure; before installation, refer to the current version on the GitHub repository.

Be aware of the following behavioral boundaries:

  • File edits and saves write directly to the disk.
  • During save, the plugin checks if the file has been externally modified and provides a prompt.
  • The plugin runs with the permissions of the current dsh process, so you need to confirm you have permission to modify the corresponding workspace files before installation.
  • The DSH community directory is an independent site, with no official affiliation to DeepSeek / High-Flyer; do not interpret the directory page as an official app store.

Links

  • GitHub Repository: https://github.com/Jiyr0119/dsh-workspace-explorer
  • Community Directory Page (from plugin clues, not included in captured materials, please verify before use): https://www.skillhub.cn/plugins/Jiyr0119/dsh-workspace-explorer