Introduction

The core design philosophy of DeepSeek Harness (DSH) is “everything is a plugin.” Dynamic plugins in DSH are usually defined during a session with cordis_define and executed in cordis_run. The lifecycle of these plugins is limited to the current process; once the process is restarted, the plugin definitions become invalid. Therefore, an external repository is needed to persistently store the source code of these plugins so that they can be reloaded when needed.

The koji-xiaoer/dsh-plugins repository is designed for exactly this purpose. As a collection of DSH plugins, it is used not only to store dynamic plugin source code, but also provides a range of enhanced features and simplifies deployment through a one-click installation script.

Positioning

This repository is a DSH plugin repository maintained by koji-xiaoer. It mainly addresses the following issues:
* Persistent storage: Stores the source code of dynamic Cordis plugins created by AI assistants in DSH sessions.
* Feature enhancement: Provides practical features such as cost estimation, bill details, Token statistics, balance inquiry, and image-to-text conversion.
* Rapid deployment: Provides a one-click installation script and supports automatic loading of static resident packages.

Core Features

The repository includes the following verified features:
* Cost and billing: Cost estimation and bill details (cost-6), with support for custom model pricing and multiple currency switching.
* Session management: Session completion notification (sntf-5), with support for voice tone, volume, and custom audio.
* Data statistics: Token usage statistics (tokm-1), displaying turns, duration, and consumption.
* Account inquiry: Account balance inquiry (baln-4).
* Multimodal support: Paste image to convert to text (imgr-3).
* Interface enhancement: Enhanced home page/interface, including a static resident package (dsh-mods-enhanced), loaded automatically when dsh web starts.

Installation and Enablement

The repository supports one-click installation through the DSH Profile Bundle mechanism. Before installation, ensure the environment has pnpm installed (Node.js >= 20).

  1. Run the following command to add the plugin:
    dsh plugin --profile web add github:koji-xiaoer/dsh-plugins

This command inserts the `dsh-mods-enhanced` plugin into the web profile and takes effect after restarting `dsh web`.
  1. If you also need to apply text patches to installed files (such as UI interface enhancements), use the traditional script:
    git clone git@github.com:koji-xiaoer/dsh-plugins.git
    cd dsh-plugins
    bash scripts/install.sh

This script automatically completes dependency installation, patch application (locking the DSH version to 0.1.1-rc.1), and configuration.

Typical Usage

The repository supports two ways of using plugin forms:

  1. Dynamic plugins: In a DSH session, create or update plugins via cordis_define. Use cordis_inspect_self(pluginId, packageId) to retrieve the latest package source code, and save it to the corresponding directory structure in this repository for reuse later.
  2. Static resident packages: Through the one-click installation command above, the dsh-mods-enhanced static package is loaded automatically when dsh web starts, without needing to be run manually.

Applicable Scenarios and Precautions

  • Key security: This is a public repository. Any key committed should be considered leaked and must immediately be revoked from the corresponding token on the GitHub settings page. Plugin source code must not hardcode any keys/tokens; use placeholders only.
  • Version locking: When using the patch mechanism, the DSH version will be locked to 0.1.1-rc.1.
  • Runtime mechanism: Dynamic plugins are not retained after process restarts and must be recreated via cordis_run; static resident packages are loaded automatically when dsh web starts.
  • Target users: Suitable for DSH users who need to persistently manage plugin code generated in DSH sessions and want to quickly integrate enhanced features such as cost monitoring and multimodal recognition.

Short Ending

koji-xiaoer/dsh-plugins provides DSH users with a standardized plugin storage and distribution solution. By centrally managing dynamic plugin source code and using static resident packages to implement feature enhancements, it reduces the maintenance cost of DSH plugins and improves the efficiency of session management.

Repository address: github.com/koji-xiaoer/dsh-plugins