Introduction¶
In the DeepSeek Harness (DSH) development workflow, as project registrations and persisted sessions accumulate, cleaning up inactive resources is a key step to maintaining a clean environment. Manually deleting files or configurations may leave behind registration information, leading to inconsistent environment state. This plugin provides standardized commands and a Web interface for safely removing project registrations and persisted sessions.
Plugin Introduction¶
dsh-command-delete is a DSH plugin maintained by user wang122818. Its core function is to provide slash commands and a Web UI management panel specifically for deleting project registrations and persisted sessions, replacing cumbersome and error-prone manual management of DSH resources.
Core Features¶
Slash Commands¶
The plugin provides three core commands:
* /delete-project <workspaceId>: Deletes a project registration.
* /delete-workspace <workspaceId>: Deletes a workspace registration.
* /delete-session <sessionId>: Deletes a persisted session.
Here, /delete-workspace is an alias for /delete-project, and both behave consistently.
Web UI Management¶
After installing the Web UI bundle, a trash icon appears at the bottom of the sidebar. Clicking this icon opens the management panel, which lists projects and sessions. All destructive operations (such as deletion) display a confirmation dialog to prevent accidental actions.
Deletion Logic¶
- Project/workspace deletion: This operation only removes the DSH workspace registration; the project directory and session log files remain unchanged on disk.
- Session deletion: This operation permanently deletes the persisted JSONL session directory. If the session is currently owned by an active Agent, the deletion operation is rejected.
Installation and Activation¶
Run the following command from the directory containing the plugin package. Replace default with the configuration profile name actually in use:
dsh plugin --profile default add .
After installation, restart the DSH process to activate the plugin.
Typical Usage¶
Enter the following commands directly in the DSH interface:
/delete-project <workspaceId>
/delete-workspace <workspaceId>
/delete-session <sessionId>
If <workspaceId> or <sessionId> is not provided, the command prints the list of currently available IDs.
Notes and Use Cases¶
Use Cases¶
- Cleaning up redundant workspace registrations created by tests.
- Archiving and deleting historical session logs.
- Managing resources visually through the Web interface.
Permissions and Limitations¶
- Runs with current permissions: The plugin runs with the permissions of the current DSH process and performs file system operations.
- Active session protection: The current DSH version does not expose a public session deletion lifecycle interface. Therefore, the plugin is designed to reject deleting sessions currently owned by an active Agent to prevent data loss or process anomalies.
- Project directory retention: Deleting a project registration does not remove the project directory or log files on disk; it only removes the entry from DSH’s internal registry.
Security Recommendations¶
Before installation, check the plugin’s source code and license (MIT) to ensure it meets your security compliance requirements.
Summary¶
dsh-command-delete provides DSH users with standardized tools for managing project registrations and sessions. It supports quick command-line operations and also offers secure confirmation mechanisms in the Web interface. For developers who frequently manage development environment resources, this is a practical helper tool.