Preface¶

The philosophy of DSH is “everything is a plugin.” The community directory is an independent site with no official affiliation with DeepSeek / High-Flyer.

When using the DSH web profile, if you need to confirm whether the AI has completed its reply, you can use a notification sound as feedback. dsh-notify-sound plays a built-in notification sound at the end of a turn and supports changing the sound effect, adjusting the volume, and toggling it on/off in the DSH settings page. Below is an introduction to its features, installation, and usage.

What This Is¶

dsh-notify-sound is a DSH web plugin, maintained by xxxxxxxyu.

It listens for the turn/end event and pushes notifications in real-time via WebSocket; the frontend plays the selected sound effect after receiving the notification. The plugin code is licensed under the MIT License.

Core Features¶

Reply Completion Notification¶

• Automatically plays a notification sound after the AI finishes replying
• Listens for turn/end and pushes notifications in real-time via WebSocket, with zero polling
• Default sound effect is staplebops-01.aac
• Sound files are bundled within the plugin, requiring no network access

Settings¶

• 44 built-in sound effects, selectable from a dropdown in the settings page
• The settings page supports on/off toggling, sound effect selection, volume adjustment, and preview playback
• Settings are saved immediately and persist after restart
• Settings are stored in the DSH settings service and apply globally

Installation and Activation¶

First, confirm the runtime requirements:

• DSH web profile (dsh web)
• Node.js >= 20

Install from GitHub¶

The <you> in the following command is kept as a placeholder as in the original text:

dsh plugin --profile web add git+https://github.com/<you>/dsh-notify-sound.git

After installation, confirm the package has been added to the configuration:

dsh.profile.bundles

Then restart the dsh service for the changes to take effect.

Local Development Installation¶

First, install the local package in the web profile directory:

cd C:/Users/<you>/.dsh/profiles/web
pnpm add file:/path/to/dsh-notify-sound

To build for development, execute:

npm install
npm run build

Build output:

lib/index.js
lib/client.js

Typical Usage¶

Open the DSH settings page, and “Notification Sound” will appear in the left navigation.

The available options are as follows:

Configuration and API¶

Preferences are stored in the DSH settings service with the namespace:

dsh-notify-sound

The plugin provides the following preference APIs:

/notify-sound/api/sounds.list
/notify-sound/api/prefs.get
/notify-sound/api/prefs.update

All routes go through the same browser trust boundary (loopback / same-origin validation) as the /api gateway.

Dependencies and License¶

Regarding dependencies, the peerDependencies declared in package.json include:

@deepseek-ai/cordis ^4.0.1
react
react-dom

Among these, react and react-dom are optional.

The configuration entry declared in package.json is:

dsh.bundle.patch

With the value:

./cordis.patch.yml

In terms of licensing, the plugin code is licensed under the MIT License. Built-in sound effects are sourced from Stephanvs/opencode-sfx, which are MIT licensed, with copyright held by their respective authors.

Use Cases and Notes¶

This is suitable for developers or users who use the DSH web profile and want to confirm that the AI has completed its reply via sound.

The plugin runs with the permissions of the current dsh process. Before installation, you should review the source code and license.

Settings apply globally; sound effects are built-in and require no network access, making them suitable for scenarios where you don’t want to rely on external audio resources.

Conclusion¶

dsh-notify-sound provides a complete pipeline for “reply completion notification sounds”: installation, settings page configuration, settings persistence, and restoration after restart. If you only need a lightweight completion notification, you can follow the steps above to install and preview the sounds.

Plugin directory page: https://www.skillhub.cn/plugins/xxxxxxxyu/dsh-notify-sound
GitHub: https://github.com/xxxxxxxyu/dsh-notify-sound