Introduction¶
In daily use of DeepSeek Harness, as the number of sessions grows, cleanup is no longer just removing rows from the interface. Behind each session are persisted event logs, projection caches, and workspace associations. Deleting this data directly is not only cumbersome but also carries the risk of accidental deletion. To address this issue, a two-phase deletion flow is needed: first archive (recoverable), then permanently delete (irreversible).
What Is This¶
dsh-session-delete is a DeepSeek Harness plugin maintained by XXXXXQ-0206. It provides DSH with a session recycle bin and permanent deletion capabilities, splitting the originally irreversible deletion operation into two safe stages: archiving and cleanup.
Core Features¶
- Sidebar and Header Actions: A new “Delete” item appears in the native session action menu (alongside Rename and Fork). At the same time, active sessions can also be moved directly to the recycle bin from the session header.
- Recycle Bin Management: Through Settings → Session Recycle Bin, you can search sessions and group them by workspace. Multi-selection is supported, and “Bulk Restore” and “Bulk Permanent Delete” are provided.
- Permanent Deletion Mechanism: Permanent deletion removes persisted session logs and projection cache records, and even ghost sessions without log records.
- Active Session Protection: By default, the plugin refuses to delete sessions that are running or locked, preventing data inconsistency.
- Recoverable Path: Every archive operation is undoable, and an undo prompt appears in the bottom-right corner after the operation completes.
- Native UI: It uses DSH design tokens, so the interface automatically adapts to the system’s dark or light theme.
Installation and Enablement¶
This plugin version 0.6.4 supports DeepSeek Harness 0.2.x.
dsh plugin --profile web add https://github.com/XXXXXQ-0206/dsh-session-delete/releases/download/v0.6.4/dsh-session-delete.tgz
After installation, restart the dsh web process to apply the plugin.
Typical Usage¶
- Archive a Session: Hover over a session row in the sidebar, open the menu, and click “Delete”.
- Restore or Permanently Delete: Go to Settings → Session Recycle Bin, select one or more archived sessions, and click “Restore” or “Permanently Delete”.
Use Cases and Notes¶
- Two-Phase Deletion: Understand that the deletion flow is first archive (recoverable) and then permanent deletion (irreversible).
- Plugin Structure: The plugin includes a host-side and a browser-side component. The host side handles persistence operations and is idempotent.
- Security Recommendation: It is recommended to review the source code and license before installing.
Summary¶
By introducing a recycle-bin mechanism, dsh-session-delete solves the problem of incomplete session cleanup and accidental deletion in DSH. It provides a complete path from quick sidebar deletion to backend bulk management, and, combined with active session protection and undo functionality, it can safely maintain the local environment.