Preface

Under DSH’s “everything is a plugin” extension approach, many experience details can be broken down into independent plugins. For multi-turn tasks, planning mode, tool execution, approval requests, and error reporting, if you only rely on watching the screen, these status changes can easily be missed in background windows.

dsh-perlica-ding is a DeepSeek Harness plugin that plays different notification sounds at key moments: it chimes when a plan is generated, a task is completed, a response is needed from you, or an error occurs, while remaining silent during ordinary Q&A. It comes with built-in Perlica-style notification sounds and requires no configuration after installation, though you can also replace them with your own WAV sound effects.

Plugin Positioning

dsh-perlica-ding addresses the issue of status notifications during DSH task execution: which moments should produce sound, and which should remain silent.

The repository URL provided in the given materials is:

https://github.com/117BS/dsh-perlica-ding

The license specified in the given materials is MIT, as indicated in both the README and package.json; the version number in package.json is 0.1.0.

Core Capabilities

The capabilities provided by dsh-perlica-ding are focused on task status notifications:

  • Plays distinct notification sounds when a plan is generated, a task is completed, a response is needed from you, or an error occurs, while remaining silent during ordinary Q&A.
  • Features built-in Perlica-style notification sounds, with the sounds/ directory distributed with the package—no configuration needed after installation.
  • Sounds are audible even when the window is in the background.
  • Main conversation only: sub-agent/background task completions do not trigger individual sounds but are consolidated at the end of the main turn.
  • Each sound level has its own 2.5-second debounce interval to prevent repeated ringing.
  • Cross-platform support: Windows (SoundPlayer) / macOS (afplay) / Linux (paplay/aplay).
  • Configurable master switch, debounce interval, sound directory, and execution tool list (execTools).

Installation and Activation

Install from GitHub

Install from GitHub:

dsh plugin --profile web add https://github.com/117BS/dsh-perlica-ding

After installation, you need to restart the dsh web profile for the plugin to take effect:

dsh web restart

Install from npm

The npm installation method provided in the materials is as follows:

dsh plugin --profile web add dsh-perlica-ding

The materials state that it will be available once published to npm; the given materials do not confirm whether the current npm package has been published yet.

Local Development Installation

An example of local development installation is as follows:

dsh plugin --profile web add D:\deepseek\dsh-perlica-ding

Configuration

Configure plugins.dsh-perlica-ding in the profile’s cordis.yml or the user patch layer:

plugins:
  dsh-perlica-ding:
    enabled: true
    debounceMs: 2500
    soundDir: ""
    execTools: []

The configuration options work as follows:

  • enabled: Master switch.
  • debounceMs: Minimum interval for the same sound level, in milliseconds.
  • soundDir: Custom sound directory; leave empty to use the current workspace.
  • execTools: Specifies which tools count as “execution tasks”; an empty array means all tools count.

Custom Sound Effects

Built-in sounds are located in the sounds/ directory and are distributed with the package, ready to use after installation.

If you want to replace them with your own sounds, place actual WAV (PCM) files with the same names in the workspace root directory or the configured soundDir. Files with the same name will override the built-in sounds and take effect immediately without restarting.

The lookup order specified in the given materials is: configuration directory → workspace → bundled with the package → system fallback.

Custom sound effects must be true WAV format (PCM). If a TTS tool exports MP3, you need to first transcode it to PCM WAV using ffmpeg.

To manually test the sound chain, you can use the command from the given materials:

$p = New-Object Media.SoundPlayer 'D:\deepseek\done.wav'; $p.PlaySync()

Applicable Scenarios and Notes

Suitable for the following use cases:

  • Using DSH to run multi-turn tasks and wanting sound notifications at points like planning, completion, approval, and errors.
  • Wanting ordinary Q&A to remain silent without being interrupted by every conversation.
  • Wanting sub-agent/background tasks not to produce individual sounds, but only to be consolidated at the end of the main turn.
  • Wanting to hear key status changes even when the window is in the background.

Notes:

  • The plugin runs with the permissions of the current dsh process; you should review the source code and license before installation.
  • After installation, you need to restart the dsh web profile for the plugin to take effect.
  • Custom sounds must be WAV (PCM); MP3 needs to be transcoded first.
  • package.json declares optional peerDependencies: @deepseek-ai/cordis, @deepseek-ai/schemastery.

Links

The directory page URL provided in the plugin leads is:

https://www.skillhub.cn/plugins/117BS/dsh-perlica-ding

The repository URL is:

https://github.com/117BS/dsh-perlica-ding