Introduction

When running Agent tasks in DeepSeek Harness (dsh), some nodes require human intervention or confirmation, or reach states like completion of the current round and returning to idle. If the page is not in view, relying solely on visual states makes it easy to miss key changes.

dsh-bell-notify is a community plugin for dsh that converts Agent lifecycle events into low-disturbance sound prompts.

It is not a desktop system notification bridge, nor a generic browser notification library; the sound plays only when Agent lifecycle events occur during a DSH Web session.

What is this

dsh-bell-notify is maintained by Laplace-bit, is open source under the MIT license, and is a DeepSeek Harness community plugin, not an official DeepSeek release.

Community plugins for DSH can be installed from third-party repositories. This plugin solves the problem of providing configurable sound prompts for key Agent lifecycle events within a DSH Web session, allowing developers to stay informed of progress without constantly staring at the page.

Core Features

The main capabilities it provides are introduced below:

  • Provides 10 configurable Agent lifecycle event prompts.
  • By default, only “Start Execution”, “Wait for Confirmation”, and “Round Complete” are enabled upon first installation.
  • Each event can be previewed, custom audio can be uploaded, and defaults can be restored.
  • Uses Web Audio to synthesize ringtones in real-time without carrying audio resources.
  • Works offline without connecting to the internet or loading external resources.
  • Custom audio is saved locally in the browser using localStorage and IndexedDB and is not uploaded.
  • Provides configuration for a master sound prompt toggle, master volume, and individual event toggles.
  • The npm package includes pre-built artifacts.

Installation and Usage

If dsh is already in your PATH, you can run:

dsh plugin --profile bell add dsh-bell-notify

If using pnpm from the source repository, you can run:

pnpm dsh plugin --profile bell add dsh-bell-notify

Start Harness:

pnpm dsh --profile bell

After opening the page, you need to click anywhere on the page once to unlock the browser’s audio autoplay policy.

Then navigate to:

Settings → Plugins → Plugin Configuration → Bell Notification

Here you can adjust the master sound prompt toggle, master volume, and event switches, as well as preview, upload custom audio, or restore defaults for each event.

To uninstall, run:

pnpm dsh plugin --profile bell remove dsh-bell-notify

Configuration

Common runtime parameters can be configured in the profile’s cordis.patch.yml:

maxQueue: 8
maxConcurrent: 3
defaultCooldown: 1000

Where:

  • maxQueue is the capacity of the wait queue.
  • maxConcurrent is the number of sounds playing simultaneously.
  • defaultCooldown is the default throttling window for the rule, in milliseconds.

Updates

Update via npm:

pnpm update dsh-bell-notify

Then restart Harness.

If installed using link: or file: for local development, the plugin will appear as a development version, and the update button will remain disabled.

Version Compatibility

The DSH kernel support range listed in verified facts is:

  • 0.1.0-rc.5～0.1.0-rc.7
  • 0.1.1-rc.2
  • 0.1.2-alpha.1～0.1.2-alpha.3

When using the 0.1.2 kernel, you need to use a build containing compatibility fixes.

The 0.1.2 kernel removed the settingsNamespace() runtime helper; this plugin is compatible via local inline constants and does not statically import that runtime symbol.

The package.json declares the Node version requirement as:

^22.19.0 || >=24.0.0

Applicable Scenarios and Notes

It is suitable for developers running long or parallel tasks in DSH, or those who wish to use sound prompts to mark nodes such as “Start Execution”, “Wait for Confirmation”, and “Round Complete”.

Notes before use:

  • It runs as a plugin loaded with DSH and executes within the current dsh process environment; you should check the source code, dependencies, and MIT license before installing.
  • Documentation suggests not to statically import runtime symbols from @deepseek-ai/* packages.
  • Custom audio is saved locally in the browser and is not uploaded; file bytes are stored in IndexedDB, and the mapping from events to files is stored in localStorage.
  • The sound plays only when Agent lifecycle events occur during a DSH Web session; it is not a desktop notification bridge, nor a generic browser notification library.
  • After the initial load, you need to click once on the page to unlock the browser’s audio autoplay policy.

Links

  • GitHub: https://github.com/Laplace-bit/dsh-bell-notify
  • Directory page in plugin listings: https://www.skillhub.cn/plugins/Laplace-bit/dsh-bell-notify