Introduction

The DeepSeek Harness (DSH) plugin ecosystem emphasizes modularity and incremental extension. When developing Live Agent scenarios, “real-time preset switching at turn boundaries” is a specific capability. During runtime, an Agent needs to know how to choose an appropriate preset and the triggering mechanism for switching behavior. dsh-live-preset-switch is a standard DSH Bundle designed for this scenario. It does not directly implement engine logic; instead, it provides guidance content.

Positioning and Role

This is a standard DSH Bundle maintained by HaoyanZhang123, belonging to the workflow category.

It adds an entry to a Profile through a Host adapter and registers a built-in Skill named live-preset-switch. This Skill includes guidance on Agent preset selection, along with a description of the “turn-boundary preset switching” behavior in builds that support the capability.

Core Features

The Bundle is designed to exist as a purely incremental component:

  1. Pure Incremental Installation: It inserts only one entry, dsh-live-preset-switch-skill-provider, via cordis.patch.yml. It does not disable, replace, reorder, or shadow any official @deepseek-ai/* components.
  2. Self-Contained: It has no runtime dependencies, no lifecycle scripts (such as preinstall, install, etc.), and no native artifacts or symbolic links.
  3. Runtime Read-Only: At runtime, the adapter performs no file, network, subprocess, or credential access, and the Skill body is a static string.
  4. Guidance Provided: It clearly explains how to select Agent presets and the specific behavior of the switching process.

Installation and Enabling

Installing this plugin requires specifying a Profile and a fixed Commit version of the repository.

dsh plugin --profile <name> add --ignore-scripts 'git+https://github.com/HaoyanZhang123/dsh-live-preset-switch.git#<commit>'

After installation, you can verify whether the configuration is active using the following command:

dsh --profile <name> --dump-config

The expected output should include the newly added entry dsh-live-preset-switch-skill-provider, and the live-preset-switch skill should be discoverable in the skill catalog.

Compatibility and Notes

Compatibility Statement

The compatibility statement is located in the dsh.compatibility field of package.json:

  • DSH Version: >=0.1.0-rc.8 <0.2.0
  • Node Version: >=22.19.0
  • Release Versions: 0.1.5-alpha.2, 0.1.5-rc.1, 0.1.5-rc.2, as well as 0.1.2-alpha.4, 0.1.2-alpha.5, 0.1.2-rc.1, 0.1.3-alpha.2, and 0.1.5-alpha.1 are all declared as compatible.

Note: The above are source declarations and are not equivalent to actual runtime acceptance. Evidence collection for isolated Profile installation, startup, uninstallation, and rollback across the versions has not been completed yet.

Key Distinction

This Bundle is not the engine itself for Live preset switching.

The actual switching engine would modify the DSH core package (including session history inference, the agentPreset.select turn-boundary guard, Composer chips, and so on), so it cannot be released as a purely incremental plugin. The engine logic remains in a fork branch, awaiting upstream review. This Bundle only provides guidance content.

License

This project is licensed under the MIT License.

Summary

dsh-live-preset-switch is a lightweight plugin focused on providing guidance information. If you need to integrate behavioral documentation about Agent preset switching into a Profile, you can use this Bundle. It extends functionality in a purely incremental way, does not interfere with DSH core components, and has no runtime side effects.