Introduction

DSH’s philosophy is “Everything is a plugin”. Features commonly used in local sessions, such as identity, prompts, recovery, restart, log buttons, and cross-session messages, were often split into multiple local plugins maintained separately. For developers using DeepSeek Harness, the cost of installing, configuring, and troubleshooting these capabilities individually is not negligible.

dsh-session-toolkit is an integrated plugin toolkit for DeepSeek Harness that consolidates six local plugin capabilities into a single installable package. Its current version is 0.1.4, compatible with DeepSeek Harness dsh-v0.1.2-alpha.1, and is licensed under MIT. The Community Directory is an independent site with no official affiliation with DeepSeek / High-Flyer; this article introduces it as a community plugin.

What is this

dsh-session-toolkit is DeepSeek Harness’s integrated plugin toolkit, merging local plugin capabilities such as session identity, global prompts, session auto-recovery, Web restart, session log button relocation, and cross-session messages. The repository is located under the GitHub account Han-Yao94; verified sources list the author field as dsh-session-toolkit maintainers, therefore this article only confirms the repository source and does not infer additional personal maintenance relationships.

It solves a specific problem: merging multiple session-side local plugins into a single installation package to reduce redundant maintenance, and placing session identity, prompts, reference files, auto-recovery, Web restart, log button position, and cross-session messages into a unified set of plugin capabilities.

Core Features

Session Identity

Session identity provides an identity dialog and a status button. The dialog features an enable toggle and supports Save/Reset, Edit Default, and Inherit Default.

Global Prompts

Global prompts provide a Global / Per workspace tab in the settings page and inject the corresponding system prompt segment.

Workspace Prompts

Workspace prompts match based on the active session’s cwd prefix. When multiple matches occur simultaneously, the longest path is selected.

Reference Files

Reference files are re-read on every assembly. If reading fails, the file content is skipped, and the reason is reported in the UI.

Session Auto-Recovery

Once the auto-recovery toggle for a session is enabled, the session is automatically recovered after the GUI restarts. The concurrency limit for session auto-recovery is 3, and individual failures are isolated.

Web Restart

Clicking Restart service in General settings triggers POST /api/restart and displays progress. Web Restart does not trigger UAC prompts, and the privilege escalation branch of the restart script will not be executed.

Session Log Button Relocation

The plugin includes the ability to relocate the session log button to adjust its display position.

Cross-Session Messages

Cross-session messages provide the send_to_session / list_sessions tools and a copy session ID button.

Installation and Activation

The plugin is released as an official dsh.bundle.patch bundle. The installation command entry provided in verified sources is:

dsh plugin add

This command comes from verified sources. The sources do not provide full installation parameters, so this article does not concatenate parameters based on the repository name. For actual installation, please refer to the complete instructions in the repository README or the DSH Community Directory.

Typical Usage

The following is split by capability, and all steps come from verified capability descriptions.

Configure Session Identity

  1. Open the identity dialog via the session identity entry point.
  2. Use the enable toggle to turn session identity on or off.
  3. Adjust identity content via Save/Reset, Edit Default, and Inherit Default.
  4. View the current status via the status button.

Configure Global and Workspace Prompts

  1. Enter the global prompts entry point in the settings page.
  2. Configure global prompts and workspace prompts separately in the Global / Per workspace tab.
  3. During session assembly, inject the corresponding system prompt segments as verified.

Use Workspace Prompt Matching

  1. Configure workspace prompts.
  2. The active session matches the workspace directory based on the cwd prefix.
  3. When multiple workspaces match simultaneously, select the longest path as the match.

Use Reference Files

  1. Reference files within the prompt capability.
  2. Re-read the file on every assembly.
  3. If reading fails, skip the file content and view the failure reason in the UI.

Enable Session Auto-Recovery

  1. Select the session to be recovered.
  2. Turn on the auto-recovery toggle for that session.
  3. After the GUI restarts, the session is automatically recovered as verified.
  4. The auto-recovery process is limited by the concurrency cap of 3 and isolates individual failures.

Execute Web Restart

  1. Enter General settings.
  2. Click Restart service.
  3. The plugin triggers POST /api/restart and displays progress.
  4. This process does not trigger UAC prompts, and the privilege escalation branch of the restart script will not be executed.

Use Cross-Session Messages

  1. Obtain the target session ID via the copy session ID button.
  2. Use the send_to_session tool to send a message to the target session.
  3. Use the list_sessions tool to view addressable sessions.

Applicable Scenarios and Notes

This toolkit is suitable for developers currently using DeepSeek Harness who wish to uniformly manage identity, prompts, reference files, recovery, restart, and cross-session messages in local sessions.

Please note before use:

  • The current version is 0.1.4, compatible with DeepSeek Harness dsh-v0.1.2-alpha.1.
  • The license is MIT.
  • The plugin is released in the official dsh.bundle.patch bundle format.
  • The plugin runs with the permissions of the current dsh process; please check the source code and license before installing.
  • Web Restart does not trigger UAC prompts, and the privilege escalation branch of the restart script will not be executed.
  • Failed reference file reads will be skipped, and the file content will not be injected.
  • The concurrency limit for session auto-recovery is 3, and individual failures are isolated.
  • If the client cannot access schemastery, it will gracefully degrade, but the host will still perform schema validation.
  • The Community Directory is an independent site with no official affiliation with DeepSeek / High-Flyer; do not describe the plugin package as content from an official app store.

Directory and Repository

  • Community Directory: Verified sources did not provide a directory page URL, so this article does not include unverified addresses.
  • GitHub Repository: https://github.com/Han-Yao94/dsh-session-toolkit.git

Following the steps above, you can first evaluate dsh-session-toolkit as a local integration package: it does not change DSH’s plugin direction but rather puts multiple session-side capabilities into one toolkit, making it convenient to install, view, and troubleshoot uniformly.