Introduction

The ecosystem positioning of DeepSeek Harness (DSH) is “everything is a plugin.” When developing or debugging workflows, if you need to verify the performance of different Agent Presets within the same session, you usually need to restart the session or reinitialize it. The dsh-preset-switch plugin solves this workflow interruption by providing in-session preset switching, allowing users to dynamically adjust agent configurations within a running session.

Plugin Overview

This plugin is maintained by developer aorucshiea and is intended to provide optional in-session agent preset switching for DSH. It does not change DSH’s core architecture; instead, it extends commands and HTTP interfaces to bypass the official lock on blank session presets, enabling flexible runtime configuration changes.

Core Features

  1. Slash-menu interaction: When you type /preset on the browser client, a searchable secondary menu appears, allowing you to select a preset directly with the mouse without manually entering an ID.
  2. Keyboard shortcuts: In addition to menu selection, you can switch presets directly by number using /preset <number>, providing a keyboard alternative to menu mode.
  3. Toggle control: It provides the /preset-toggle on|off command to globally enable or disable the preset switching feature.
  4. HTTP endpoint: It provides an HTTP interface, making it easier for developers to integrate it into custom UI interfaces.
  5. Bypassing locks: The plugin can bypass the official blank-session lock mechanism, allowing switching in non-blank sessions, but the system displays a warning to indicate potential tool-call incompatibility issues.

Installation and Enabling

Installing this plugin requires the --profile web parameter to ensure environment compatibility. Run the following command to complete the installation:

dsh plugin --profile web add github:aorucshiea/dsh-preset-switch

After installation, the plugin starts with the DSH process and is enabled by default.

Typical Usage

After the plugin is installed and active, you can perform the following operations:

/preset                       # View the current preset list and numbered menu
/preset <id>                  # Switch to the preset with the specified ID in a blank session
/preset <number>              # Switch presets by menu number (equivalent to <id>)
/preset-toggle on|off         # Enable or disable the preset switching command

Use Cases and Cautions

  • Use cases: Suitable for developers who need to quickly test different roles or tool-chain configurations within the same session, or scenarios that require dynamically adjusting Agent behavior while running.
  • Permissions and security: The plugin runs with the permissions of the current DSH process. Please ensure that the source code you install is trustworthy.
  • Compatibility note: Because the plugin bypasses the official blank-session lock, the system displays a warning when switching, indicating that previous tool calls may not match the new preset. Before switching, confirm that the current context allows this change.

Conclusion

dsh-preset-switch provides a lightweight solution that makes DeepSeek Harness session management more flexible. The plugin does not store any API keys or credentials. For more details, refer to the project repository or the DSH plugin directory.