Introduction¶

When running tasks with DSH, the typical workflow is to offload work to the agent and switch away to handle other matters. The trouble is you don’t know when to come back: the task might be waiting for your approval, or it might have finished long ago. So you have to repeatedly switch back to the page to check progress, attention is fragmented, and even when you come back, there might not be new progress.

dsh-notification-sounds solves this with two sounds: it plays “Task Waiting” when the AI needs you to operate, and “Task Completed” when the main session and all its sub-agents have completed stably. You just need to come back when you hear a sound. Below is an introduction to the plugin’s positioning, features, and complete installation steps.

What is it¶

dsh-notification-sounds is a sound notification plugin for the DeepSeek Harness Web UI, maintained by qq33357486, and licensed under MIT. The official one-sentence description is “Cross-platform waiting for user and completion sound notifications.” The community directory page categorizes it under the “Client” category.

It does one thing: reminders. There are two trigger timings:

There are two points that are easily misunderstood, which are specifically explained in the README:

1. Sub-agents completing individually will not trigger a sound. Only when the main session they belong to and all its sub-agents have completed stably will “Task Completed” play.
2. Multiple main sessions are independent of each other, triggering their own “Task Completed” sounds respectively.

Core Features¶

Settings Page¶

The plugin registers a Settings → General → DSH Notification Sounds page in the DSH Web UI. After entering, you can enable notifications and listen to the “Task Waiting” and “Task Completed” sounds. You need to click or press a key once after the first entry to unlock browser audio, so that sound reminders can play normally.

Web Platform Support¶

The plugin declares itself as targeting the web platform via the dsh.client configuration in package.json:

{
  "dsh": {
    "client": {
      "platform": "web"
    }
  }
}

The corresponding installation and update commands both use the web Profile.

Installation and Enablement¶

First, confirm the environment: the version marked in the plugin’s package.json is 0.1.2, and engines requires node ^22.19.0 || >=24.

1. Execute the installation command:

dsh plugin --profile web add dsh-notification-sounds

2. Restart the existing DSH Web process. Note: do not start a second Web service; the plugin needs to restart the existing process to take effect.

3. After restarting, enter Settings → General → DSH Notification Sounds, enable notifications and listen to the two sounds. Click or press a key once after the first entry to unlock browser audio.

After the above steps, the plugin works. If you want to confirm if DSH has correctly loaded the plugin, execute:

dsh --profile web --dump-config

Check the output for id: notification-sounds and name: dsh-notification-sounds; their presence indicates the plugin has been recognized.

Update¶

Update an installed plugin with the following command:

dsh plugin --profile web up dsh-notification-sounds

Typical Usage: Let AI Install It for You¶

The README provides a prompt; copy it to AI to let it handle the installation and configuration:

Please install and configure dsh-notification-sounds:
1. Check if dsh is available, defaulting to the web Profile.
2. Execute `dsh plugin --profile web add dsh-notification-sounds`; if already installed, execute `dsh plugin --profile web up dsh-notification-sounds`.
3. Verify the existence of `id: notification-sounds` and `name: dsh-notification-sounds` using `dsh --profile web --dump-config`.
4. Do not start a second Web service; remind me to restart the existing `dsh web`.
5. Tell me to enter Settings → General → DSH Notification Sounds, enable notifications, listen to "Task Waiting" and "Task Completed", and click or press a key once to unlock audio.
6. Finally, report the installed version and verification results; do not modify DSH's official source code.

This prompt lists the installation, restart, verification, settings page operations, and precautions, covering the same workflow as manual operation.

Scenarios and Precautions¶

Suitable for people running long tasks in the DSH Web UI who often switch away to do other things; if multiple main sessions are opened, each session independently triggers a completion reminder, saving the action of checking back and forth.

There are a few things to note before installation and use:

1. The plugin runs with the permissions of the current dsh process. It is recommended to check the source code and license (MIT) in the repository before installing to ensure you accept it.
2. DSH’s philosophy is “Everything is a plugin,” but community-maintained plugin directories are independent sites with no official affiliation to DeepSeek / Hyperbolic, so choose plugins with discretion.
3. Do not start a second Web service; the plugin will only take effect after restarting the existing dsh web process.
4. The trigger condition for “Task Completed” is that the main session and all its sub-agents have completed stably; individual completion of sub-agents will not trigger a sound.

Conclusion¶

dsh-notification-sounds solves a very specific problem: letting AI work quietly and calling you back with a sound when it’s time. One command to install, and after restarting the process, go to the settings page to enable notifications and listen to the two sounds to get started.

• GitHub Repository: https://github.com/qq33357486/dsh-notification-sounds
• Community Plugin Directory Page: https://www.skillhub.cn/plugins/qq33357486/dsh-notification-sounds