Introduction

DeepSeek Harness (DSH) focuses on agent development and orchestration. During debugging or runtime, developers need clear feedback to confirm task status. Existing command-line tools often lack auditory feedback. The DSH voice alert plugin resolves this gap by automatically playing sounds at the end of a conversation turn or when an error occurs.

What It Is

This is a DSH conversational voice alert plugin. When a conversation turn ends, it plays an automatic reminder; when an error or tool failure occurs, it plays a failure alert. The plugin includes 20 built-in sounds (10 reminders + 10 nature sounds) and works out of the box with zero configuration. It also supports cloning your own voice using Volcano’s “Voice Cloning” feature.

Core Features

  1. Automatic Alerts
    At the end of each conversation turn, it automatically plays a “completion” voice. If an error occurs in a turn (agent/error or tool isError), it plays a “failure” voice.

  2. Built-in Sounds
    Works out of the box with zero configuration and includes 20 built-in sounds (10 reminders + 10 nature sounds), requiring no API key.

  3. Voice Cloning
    Supports cloning your voice using Volcano’s “Voice Cloning” feature.

  4. Playback Compatibility
    Uses the waveOut/WAV playback backend by default. Tests confirm that it does not drop the first sound or interrupt music playing on Bluetooth headphones. It never changes system volume or mute state.

  5. Logging
    Provides millisecond-level phase logs.

Typical Usage

  1. Zero-Configuration Usage
    Use the default built-in sounds directly, with no API key or audio files required.

  2. Custom Voice
    Clone your voice using Volcano’s “Voice Cloning”, then fill in your ID and key.

  3. Bluetooth Headphone Adaptation
    Adjust system volume to wake Bluetooth headphones. Set prewarmMs: 0 to avoid interrupting Bluetooth music.

Installation and Enablement

Install it via the plugin directory. Visit DSH Plugin Directory to find the plugin, or obtain the source code from the GitHub repository loyalchiiina/dsh-voice-alert.

Use Cases and Notes

Suitable for developers and users who need auditory feedback during conversations. If playback fails, it falls back silently without affecting normal DSH operation. Before installing, check the source code and license.

Closing

This plugin provides DSH with intuitive status feedback through automatic voice alerts and sound reminders. For more details, see the Plugin Directory or the GitHub repository.