Introduction

DeepSeek Harness (DSH) adopts a plugin-based architecture, aiming to achieve functional decoupling through extensions. In local development environments or when developing agents, the application lacks the ability to directly manage files, and users typically need to rely on external terminals or file managers. dsh-file-review addresses this pain point by providing Harness with a dockable, resizable file browsing sidebar and editor.

Plugin Overview

dsh-file-review is a DeepSeek Harness client plugin maintained by developer ylw-a. It primarily solves the problem of not being able to directly browse local file trees, perform file read/write operations, or view Markdown rendering within the DSH environment.

Core Features

This plugin provides a complete set of file management capabilities, including:

  1. File Tree Sidebar
    • Supports docking on the left or right, with a width adjustable between 220px and 900px.
    • Supports lazy loading of directories, expand all/collapse all, and workspace search.
  2. Right-Click Context Menu Operations
    • Provides actions such as cut, copy, paste, copy absolute/relative path, rename, and delete to recycle bin.
    • Supports creating new files/folders, refreshing, and opening files in VS Code.
  3. Unified Editor
    • Integrates Shiki syntax highlighting and direct editing functionality, enabling “preview as editing”.
    • The editor features debounced highlighting, scroll synchronization, and Ctrl/Cmd+S save support.
  4. Markdown Support
    • Edits in syntax-highlighted source code mode by default.
    • Supports switching between rendered and editing modes.
  5. Automatic Refresh Mechanism
    • The visible directory tree polls approximately every 2 seconds and re-renders only when file signatures change.
    • Refreshes immediately when write operations are performed.
  6. Dual-Host Mode
    • Displays as a floating editor window when there is no session.
    • Automatically switches to a fixed file tab when there is an active session (coexisting with conversation/trace tabs).
  7. Safe Deletion
    • When deleting files, they are sent to the Windows Recycle Bin via PowerShell Microsoft.VisualBasic; deletion is not permanent.

Installation and Enablement

Before installation, ensure that DeepSeek Harness is installed and local web mode is configured.

  1. Navigate to the plugin source code directory.
  2. Build the project:
    npm install
    npm run build
  1. Add the plugin to the Harness configuration:
    dsh plugin --profile web add -w <path-to-this-package>
  1. Restart Harness to load the plugin.

Typical Usage

  • File Operations: Right-click a file in the sidebar and select “Copy Absolute Path” to directly obtain the path for agent invocation.
  • Code Editing: Click a file to enter editing mode, modify the code directly, press Ctrl/Cmd+S to save, and the editor will automatically apply syntax highlighting based on Shiki.
  • Markdown Preview: In Markdown files, switch to the “rendered” view to check the typographic effect.

Applicable Scenarios and Notes

  • Applicable Scenarios: Suitable for developers who need to directly view, modify, or create local code files, configuration files, or documentation within the DSH environment.
  • Permissions and Dependencies: The plugin runs with the current DSH process permissions, and deletion operations require system permissions. It is recommended to check the source code and license before installation.
  • Technical Details: The editor client inlines Shiki (using the JS regex engine instead of WASM) and depends on the DSH local web mode configuration. The build output lib/ and design documents docs/ are not committed to the repository.

Conclusion

dsh-file-review fills the gap in local file handling for DeepSeek Harness by combining a sidebar and an editor. If you want to learn more or obtain the source code, visit the plugin directory or the GitHub repository.