Introduction

In the usage of DSH, agents sometimes ask users questions, initiate approval requests, or complete a round of tasks. If the interface lacks sound alerts, these state changes can be easily overlooked. DSH emphasizes “everything is a plugin,” and the community directory is an independent site with no official affiliation to DeepSeek / Huafang.

Below is an introduction to dsh-sound-notify: a DSH web plugin that plays sound alerts when the agent asks questions, initiates approval requests, or completes a round of tasks, and allows the panel to use a custom main background.

What is this

dsh-sound-notify is a DSH web plugin. The README title is dsh-sound-notify, the package name in package.json is @dsharness/dsh-sound-notify, the version is 0.1.0, and the license is MIT. The GitHub repository is:

https://github.com/flayteas/dsh-sound-notify

It primarily addresses two issues:

  1. Play sound alerts when the agent asks questions, initiates approval requests, or completes a round of tasks.
  2. Customize the main background of DSH web, including background color, background image, global overlay, sidebar overlay, and restoring defaults.

Core Features

Sound Alerts

  • Trigger conditions: Agent asks questions, initiates approval requests, completes a round of tasks.
  • Each trigger condition allows separate settings for sound effect, volume, repeat count, and interval.
  • Sound effect options: Rising tone, Falling tone, Ding-dong, Single beep, Custom audio, Mute.
  • Supports custom audio and local audio file uploads.

Background

  • Supports background color.
  • Supports background image URL or local file upload.
  • Supports global overlay, sidebar overlay, and restoring defaults.

Settings and Routing

  • Settings are automatically saved to $DSH_HOME/settings.yaml and take effect in real-time.
  • Provides /plugins/sound-notify/upload for uploads and /plugins/sound-notify/files/* for static file routing.
  • After local files are saved via the upload route, the returned URL is saved in the settings.

Installation and Activation

The recommended installation method requires pnpm and requires downloading dsharness-dsh-sound-notify-0.1.0.tgz first. Current materials do not provide a download link or instructions on how to obtain pnpm.

First obtain dsharness-dsh-sound-notify-0.1.0.tgz, then navigate to the directory containing the file and execute:

dsh plugin --profile web add .\dsharness-dsh-sound-notify-0.1.0.tgz

Manual Installation

When pnpm is unavailable, you can install manually as follows:

  1. Copy the entire @dsharness/dsh-sound-notify directory to:
$DSH_HOME/profiles/node_modules/@dsharness/dsh-sound-notify
  1. Append the following to $DSH_HOME/profiles/web/cordis.patch.yml:
- insert:
    - id: sound-notify
      name: '@dsharness/dsh-sound-notify'

Activation

After installation, restart dsh web and refresh the page.

The peerDependencies in this plugin’s package.json include:

@deepseek-ai/schemastery >=3

dsh.bundle.patch points to:

./cordis.patch.yml

Typical Usage

After completing the installation steps above and refreshing the page, open the following in DSH web:

Settings → Personalization

Then configure the background and sound alerts.

The following introduces a few common operations:

  1. Select built-in sound effects: Rising tone, Falling tone, Ding-dong, Single beep, or Mute.
  2. Select “Custom Audio” and upload a local audio file.
  3. Configure background color, background image URL, or upload a local background file.
  4. Configure global overlay, sidebar overlay, or restore defaults.

Changes are automatically saved to $DSH_HOME/settings.yaml and take effect in real-time.

Local files are uploaded via /plugins/sound-notify/upload and stored in:

$DSH_HOME/sound-notify/

The settings only save the returned URL. Static files can be accessed via the following route:

/plugins/sound-notify/files/*

Applicable Scenarios and Notes

Suitable for developers working in DSH web who wish to receive sound alerts when key interactions occur. If you wish the panel appearance to better match your personal usage habits, you can also use its background settings to adjust the main background.

Notes:

  1. The plugin runs with the current dsh process permissions. You should check the source code and license before installing.
  2. The recommended installation method requires pnpm, and current materials do not provide a download link for dsharness-dsh-sound-notify-0.1.0.tgz.
  3. Manual installation requires copying the directory and modifying $DSH_HOME/profiles/web/cordis.patch.yml.
  4. Local files are saved to $DSH_HOME/sound-notify/, and the settings save the URL.
  5. The license is MIT.

Links

GitHub: https://github.com/flayteas/dsh-sound-notify

Current verified materials do not provide the directory page URL. If used via the DSH Community Directory, the community directory is an independent site with no official affiliation to DeepSeek / Huafang.