Introduction

DeepSeek Harness (DSH) extends Web capabilities via a plugin mechanism, where third-party plugins are maintained by the community or individual developers. For developers using DSH Web, cleaning up old sessions usually requires manual intervention. dsh-session-delete does not provide a new list to replace the official sidebar; instead, it adds a “Delete Session” entry with a secondary confirmation to the existing session menu.

The following sections explain the problems it solves, how to install it, and the boundaries to be aware of during usage.

Plugin Positioning

dsh-session-delete is a personal open-source plugin for DeepSeek Harness Web, maintained by StarsTom, with the current version being 0.1.3 and the license MIT.

Its goal is specific: to add “Delete Session” to the DSH Web session three-dot menu and require user confirmation before deletion to reduce the risk of accidental deletion. It does not replace DSH’s built-in “Archive Session.”

Core Features

The capabilities of dsh-session-delete are concentrated on the session deletion entry and safety checks before deletion.

  • Adds “Delete Session” below the existing “Archive Session,” without replacing the official sidebar.
  • Displays session name, non-recoverable warning, and a mandatory confirmation checkbox before deletion.
  • Only supports the official JSONL session persistence backend; operations on other backends will be rejected, preserving data.
  • Validates that the target is located under the JSONL persistence root directory before recursive deletion.
  • Stops the agent, waits for write completion, and cleans up runtime registration items before deleting an active session.
  • Does not initiate network requests, does not read credentials, and does not collect or upload session content.

Environment Requirements

Before installation, confirm that the current environment meets the following conditions:

  • DeepSeek Harness 0.1.0-rc.6 or a compatible version.
  • Node.js 20 or higher.
  • Using the web profile.
  • Using the default JSONL session persistence backend.

Installation & Enablement

Install the standard DSH bundle from GitHub and execute the following command:

dsh plugin --profile web add github:StarsTom/dsh-session-delete

After installation, perform a full restart of the DSH Web service and refresh the page.

Note that you should not manually insert the same plugin into the profile’s cordis.patch.yml, otherwise it will produce a duplicate loader id, causing DSH startup to fail.

When developing, you can also install from a local directory:

cd /path/to/dsh-session-delete
dsh plugin --profile web add .

Typical Usage

Once enabled, the steps to delete a session are as follows:

  1. Find the target session in the left-side session list.
  2. Click the three-dot button on the right side of the session.
  3. Select “Delete Session”.
  4. Verify the session name, check the confirmation item, and click “Permanently Delete”.

After the above steps, the target session will be permanently deleted. If you need to preserve session records, please use DSH’s built-in “Archive Session.”

Uninstallation

Execute the following command to uninstall the plugin:

dsh plugin --profile web remove dsh-session-delete

Takes effect after restarting the DSH Web service. Uninstalling the plugin will not delete any sessions.

Working Method & Compatibility

Currently, the DSH public slot has not exposed the session menu extension point; therefore, on the browser side, the entry is only appended when the official “Archive Session” menu item is detected. If DSH later adjusts the sidebar DOM or menu text, the plugin will stop injecting and will not replace or damage the original menu.

The server-side RPC only accepts loopback permissions. The plugin declares that it does not initiate network requests, does not read credentials, and does not collect or upload session content.

Applicable Scenarios & Notes

This plugin is suitable for users who need to quickly clean up old sessions in DSH Web and use the default JSONL persistence backend.

Please note before use:

  • Permanent deletion is irreversible.
  • Only supports the official JSONL session persistence backend.
  • The deletion operation is executed by the DSH plugin process; check the source code and license before installation.
  • This project is a personal open-source plugin and does not represent the official DeepSeek.
  • Please verify in a disposable profile first before handling important sessions.

Conclusion

The value of dsh-session-delete lies in making “Permanent Delete” a menu entry with confirmation, backend restrictions, and loopback permission boundaries. It does not change DSH’s main session management flow; it simply adds a more explicit deletion operation to the Web interface.

  • GitHub Repository: https://github.com/StarsTom/dsh-session-delete
  • Community Directory: Subject to the actual display in the DSH community directory.