Preface

When using the DeepSeek Harness (DSH) Web GUI for development, directly deleting a session or workspace often means immediate data loss. Although the native DSH “Delete Workspace” behavior preserves the project directory and session logs, it lacks a flexible “soft delete” option in interaction. For scenarios requiring recovery from accidental deletion or bulk cleanup, the absence of a unified trash mechanism can be inconvenient.

What It Is

dsh-session-trash is a plugin that adds a session-level trash feature to the DSH Web GUI. It is maintained by Huo-yang and addresses the lack of an undo mechanism in native operations, providing temporary holding, restoration, and automatic cleanup for sessions.

Core Features

The plugin provides the following capabilities in the DSH Web GUI:

  1. Session Row Menu: Adds two options, “Move to Trash” and “Delete Permanently,” to the “…” menu in the session list.
  2. Trash Panel: Provides a centralized panel to view deleted sessions, supporting individual restoration, permanent deletion, or clearing all.
  3. Sidebar Status: When the trash contains items, the sidebar entry displays a green status dot.
  4. Native Configuration: Integrates trash settings (temporary holding, retention days, confirmation prompts, automatic cleanup) into the native DSH plugin page.
  5. List Synchronization: Hides deleted entries by exact session ID to keep the main list clean.

Installation and Activation

The plugin is released via GitHub Releases and is not provided as an npm package. Before installing, ensure that DSH is already installed.

  1. Download the corresponding version of dsh-session-trash-<version>.tgz from GitHub Releases.
  2. Run the installation command:
dsh plugin --profile trash add "C:\Downloads\dsh-session-trash-0.2.1.tgz"

After installation, trash-related configuration options are available on the DSH “Plugins” page.

Typical Usage

  • Restore a session: Select “Move to Trash” in the session menu, then click Restore in the Trash panel.
  • Uninstall the plugin: If no longer needed, you can remove the plugin, but the trash data will remain on the local disk:
dsh plugin --profile trash remove dsh-session-trash
  • Development debugging: Install directly from the source directory:
dsh plugin --profile trash add "$pluginPath"

Notes and Use Cases

  • Data retention: Uninstalling the plugin does not automatically delete data in the trash. It is recommended to confirm whether any sessions still need to be restored before cleaning up.
  • Delete workspace: The plugin does not change the native DSH “Delete Workspace” behavior (it only removes the registration and preserves the logs); it mainly handles session-level soft deletion.
  • Language support: Although the README provides an English version, the plugin interface is currently optimized primarily for Simplified Chinese.
  • Ecosystem affiliation: This is a community-maintained third-party plugin and has no official affiliation with DeepSeek.

Summary

dsh-session-trash introduces a soft-delete mechanism, providing DSH users with a more controllable session management experience. It is suitable for developers who frequently debug, need recovery from accidental deletion, or regularly clean up test data.