Introduction

In the DSH Web UI, a session typically goes through states such as starting, completing, failing, or waiting for user approval or response. Relying solely on text prompts can sometimes make state transitions less intuitive. dsh-soundscape is a DeepSeek Harness Web UI plugin: it plays synthesized WebAudio sound effects when a turn begins, completes successfully, fails or is interrupted, or when waiting for user processing; it can include confetti for successful completion and provides the ctx.soundscape service to other plugins.

What is it

dsh-soundscape is maintained by Blaczz and is licensed under MIT © 2026 Blaczz. It is an independent community plugin and is not affiliated with DeepSeek Harness.

One-sentence positioning: Adds event sound effects to DSH Web UI sessions and exposes sound effect capabilities for invocation by other client plugins.

Core Features

Below are the verified capabilities.

  • Plays send rebound clack when a turn starts; enabled by default.
  • Plays celebration fanfare and displays confetti upon successful turn completion; can be switched to plain ding.
  • Plays low buzz when a turn fails or is interrupted.
  • Plays two-tone alert (1.5s throttle) when waiting for user approval, response, or plan review.
  • Can play soft two-note greeting when a session opens; disabled by default.
  • Optional typing ambience click (throttled + jittered) during streaming output; disabled by default.
  • Uses pure WebAudio oscillator synthesis: zero audio files, zero network requests, zero core modifications.
  • Provides a soundscape settings namespace to save settings such as the main switch, master volume, and individual sound effect toggles.
  • Provides the ctx.soundscape.play(name) and ctx.soundscape.celebrate() services for other client plugins.
  • Registered via ctx.effect, supports automatic cleanup during HMR.

Installation and Usage

First, ensure the environment meets the following:

  • DeepSeek Harness, and dsh web is available
  • Node ≥ 22.19
  • pnpm

Install from GitHub:

dsh plugin --profile web add "github:Blaczz/dsh-soundscape#main"

After installation, dsh web needs to be restarted. Subsequent source code changes can be handled via HMR.

Installing from GitHub may require allowBuilds authorization. If the first add github:... fails, configure the package key to the allowBuilds section in the following file according to the dsh output:

~/.dsh/profiles/web/pnpm-workspace.yaml

or publish a pre-built npm package.

Typical Usage

After completing the steps above, you can use it as follows:

  1. Open any session and send a message. Turn start, successful completion, error or interruption, and waiting for approval or response will trigger the corresponding sound effects respectively.
  2. Use the quick mute switch in the session header for temporary muting. Settings are preserved across restarts.
  3. Adjust the main switch, master volume, individual sound effect toggles, preview, and streaming rhythm parameters in Settings → Soundscape.
  4. Developers can inject soundscape into other plugins’ inject and call:
ctx.soundscape.play('celebrate')
ctx.soundscape.celebrate()
ctx.soundscape.isEnabled()
ctx.soundscape.setEnabled(true)

Each sound effect is gated by user settings and master volume.

Applicable Scenarios and Considerations

This plugin is suitable for the following situations:

  • You want DSH Web UI to have sound prompts during turn start, completion, failure, and waiting for user processing.
  • You want confetti feedback upon successful completion and can switch it to plain ding.
  • You want to reuse ctx.soundscape.play(name) or ctx.soundscape.celebrate() in other plugins.

Notes before use:

  • The plugin runs with the permissions of the current dsh process; source code and license should be reviewed before installing.
  • It is an independent community plugin and is not affiliated with DeepSeek Harness; it should not be regarded as an official component of DeepSeek Harness.
  • The session opening greeting sound and streaming typing ambience are disabled by default.
  • Installing from GitHub may require allowBuilds authorization; dsh web needs to be restarted after installation.

Conclusion

The value of dsh-soundscape lies in using WebAudio synthesized sound effects to complete DSH Web UI’s state feedback, while maintaining a lightweight form with zero audio files, zero network requests, and zero core modifications, and exposing ctx.soundscape for use by other plugins.

GitHub: https://github.com/Blaczz/dsh-soundscape