Introduction

DeepSeek Harness (DSH) supports extending Web capabilities via plugins. webkong/dsh-plugin-sidebar is a DSH Web plugin designed to fill the left and right sidebars: browsing sessions by workspace on the left, and browsing files within a session, viewing Git status, and handling commits on the right.

If your DSH environment requires managing sessions, viewing files, and checking Git changes via the Web interface, you can install this plugin. Select the compatible plugin version based on your current dsh version.

What is this

webkong/dsh-plugin-sidebar is a sidebar plugin born for DeepSeek Harness.

Maintained by webkong, license MIT. After installation, the DSH Web interface adds:

  • Left Sidebar: Browse sessions by workspace, support status dots, grouping, search, and one-click actions.
  • Right Sidebar: File browser, Git panel, commit history, and branch switching.
  • Main Area File Preview: Based on CodeMirror 6, supports syntax highlighting, editing, and saving back to disk.

Core Features

The left sidebar allows browsing sessions by workspace, suitable for viewing sessions from multiple workspaces in a single sidebar.

Verified capabilities include:

  • Browsing sessions grouped by workspace.
  • Session status dots: Used to display session status.
  • Top search: Matches local titles, cwd, and workspace, and merges remote content search.
  • Session card operations: Rename, copy fork, archive, move to folder.
  • One-click actions: Reduce the cost of switching back and forth between the session list and specific actions.

The right sidebar faces the working directory within a session, providing file browsing and Git operations.

The file browser supports:

  • Lazy loading of the directory tree.
  • Search by filename.
  • Search by file content.
  • Directory Git status aggregated badges.

The Git panel supports:

  • Staged / Changed status.
  • Colored diff.
  • Commit box.
  • Branch switching.
  • Batch operations: Stage all, unstage all, discard all changes.
  • Commit history: Timeline, commit messages, author/date, list of changed files for that commit.

File Preview

The file preview tab uses CodeMirror 6 to render text files, supporting:

  • Syntax highlighting.
  • Editing.
  • Saving back to disk.

For binary files and large files, the plugin will provide a prompt.

Language and Theme

The plugin provides a full Chinese interface + English, and automatically switches following DSH language preferences.

The plugin also follows DSH theme for automatic light/dark adaptation.

Installation and Enablement

It is recommended to confirm the dsh version before installing, then select the plugin version:

dsh ≥ 0.1.2: Recommended plugin 0.3.2
dsh 0.1.1-rc.x: Available plugins 0.3.0–0.3.2

Install a specific version from GitHub:

dsh plugin --profile web add github:webkong/dsh-plugin-sidebar#v0.3.2

If you need to install the latest main branch:

dsh plugin --profile web add github:webkong/dsh-plugin-sidebar#main

If installing from a local path, suitable for development and debugging:

dsh plugin --profile web add /path/to/dsh-plugin-sidebar

Note that pnpm’s GitHub version locking syntax uses #tag, so use #v0.3.2 in the installation command to avoid the old syntax @0.3.2.

After installation, restart dsh web.

The effect after enabling is:

  1. The left sidebar takes over sidebar.workspaces.
  2. The right sidebar takes over the details column.
  3. A right sidebar toggle appears in the session header.

How it takes effect during subsequent modifications:

  • Host changes: Requires restarting dsh web.
  • Client changes (lib/client.js): Refresh the page.

Typical Usage

Below is a common installation and enablement process.

  1. Confirm current dsh version.

  2. Select the plugin version based on version compatibility:

dsh plugin --profile web add github:webkong/dsh-plugin-sidebar#v0.3.2
  1. Restart dsh web:
# Restart dsh web as per your DSH startup method

  1. Open the DSH Web interface; the left sidebar will display workspaces and sessions.

  2. Search for sessions in the top bar; the search scope includes local titles, cwd, workspace, and merges remote content search.

  3. Perform rename, copy fork, archive, and move to folder operations on session cards.

  4. Open the right sidebar toggle in the session header.

  5. View the file tree, Git status, diff, commit history, and branches on the right side.

  6. Click on a text file to enter file preview, use CodeMirror 6 to view, edit, and save back to disk.

Suitable Scenarios and Notes

Suitable for the following scenarios:

  • Need to browse sessions by workspace in DSH Web.
  • Need to view file directories, search files, and preview text files within a session.
  • Need to view Git staged/changed status, diff, commit history, and branches.
  • Want the interface to follow DSH language preferences and themes.

Notes before installation:

  • The plugin runs with the current dsh process permissions and will execute file, Git, and session-related operations. Check the source code and license before installing.
  • API route /dsp-sidebar/api is limited to local loopback and is a POST request.
  • fs.read truncates text reading at 512KB, binary returns kind:'binary'.
  • File preview gives a prompt for binary/large files.
  • On dsh ≥ 0.1.2, old clients cannot load due to the removed dsh-client-runtime, so it is recommended to select the plugin version according to the version compatibility table.

Conclusion

webkong/dsh-plugin-sidebar centralizes session browsing, file preview, and Git operations in the left and right sidebars of DSH Web, suitable for developers who need to use DSH as a Web-based intelligent agent workspace.

GitHub: https://github.com/webkong/dsh-plugin-sidebar