Introduction

When debugging agent tasks in DeepSeek Harness (DSH), a common requirement is to view files in the current session’s workspace, confirm what content the agent created or modified, and perform minor edits on text files. Existing approaches usually involve switching to a terminal, text editor, or external IDE. The dsh-explorer-plugin brings this capability into the DSH Web GUI: a file tree appears in the sidebar, and after opening a file, you can view and modify it using the Monaco editor, with syntax highlighting powered by VS Code TextMate.

Below, we introduce its features, installation methods, and important limitations to note.

What is this

The dsh-explorer-plugin is maintained by dgadelha1 and is licensed under MIT. It adds a File Explorer panel to the DSH Web GUI, providing a workspace file tree and a Monaco editor.

Verified runtime environment information comes from the README test environment: DeepSeek Harness 0.1.0-rc.7, pnpm 9.15.9, Node.js ≥ 20. Documentation requires the CLI dsh and pnpm to be in PATH; if pnpm is not in PATH, it mentions using a local shim and prefixing PATH.

Core Features

File Browsing

  • Open, create, rename, copy, move, and delete files and folders.
  • File tree supports lazy loading.
  • Optional display of hidden files.
  • The panel is embedded as a real column in the application grid; it is collapsible, resizable, and movable to the left or right.

Monaco Editor

  • Provides line numbers, multiple tabs, and undo/redo.
  • Supports Ctrl+S to save and detects external conflicts.
  • Optional word wrap.
  • Supports large files and binary file handling.
  • Uses VS Code TextMate syntax to provide code highlighting for 28 languages.

Agent Integration

  • Monitors file changes in real-time via SSE; when the agent creates or edits a file, the file tree updates.
  • Provides Analisar (Analyze) and Corrigir (Fix) quick actions to send agent instructions and request confirmation before modification, preventing unapproved file changes.

Multilingual & Security

  • Supports pt/en/zh and follows the GUI locale.
  • All file operations are limited to the session workspace.
  • Includes protection against path traversal and symlink escape.
  • Path root is validated by the server.

Installation and Enablement

First, ensure dsh and pnpm are available. If your current workspace uses a local pnpm shim, refer to the example in the documentation, add the local shim directory to PATH, and then run the installation command:

PATH="$PWD/.bin:$PATH" dsh plugin --profile web add -w .

Vendor assets in the plugin repository have been committed. Only run this if you need to update or re-vendor:

node scripts/vendor.mjs

This step requires a network connection.

In the plugin checkout directory, use the installation command from the README:

dsh plugin --profile web add -w .

You can also use an absolute path:

dsh plugin --profile web add -w /caminho/absoluto/para/dsh-explorer-plugin

Here, -w is a required parameter. Documentation states that the -w or --workspace-root flag must be used when installing pnpm dependencies, otherwise the ERR_PNPM_ADDING_TO_ROOT error may occur.

After installing or changing the server bundle, you need to restart dsh web. For example, using the repository script:

scripts/restart-web.sh

If only client-side changes were made, such as lib/client.js or vendor/, documentation states you can simply refresh the browser page.

Platform scripts can be used for installing, verifying, and removing:

scripts\install.bat
scripts/install.sh
scripts/install-macos.sh

After completing the steps above, open the DSH GUI, for example:

http://127.0.0.1:3080

View the File Explorer panel in the sidebar.

Typical Usage

  1. Open the DSH Web GUI and locate the File Explorer panel in the sidebar.
  2. View the file tree of the current session workspace; click on text files to view or modify them using the Monaco editor.
  3. Press Ctrl+S to save the file; the editor will detect external conflicts.
  4. Use Analisar or Corrigir on a specific file to send agent instructions; documentation notes that such operations require confirmation before modification.

Use Cases and Notes

Suitable for developers who need to view and manage the current session’s workspace within the DSH Web GUI and perform quick edits on files generated or modified by the agent. It is better suited for inclusion in daily DSH debugging workflows rather than replacing a full local IDE.

Note before installation: The plugin runs with the permissions of the current dsh process, so you should check the source code and license before installing. The project license is MIT. The community directory is merely a plugin discovery site, not an official app store, and does not imply any official affiliation with DeepSeek / Falafel.

Links

  • GitHub: https://github.com/dgadelha1/dsh-explorer-plugin
  • Plugin directory page link: https://www.skillhub.cn/plugins/dgadelha1/dsh-explorer-plugin (This URL comes from the plugin link, not directly appearing in the captured data)