Introduction

When working with agents using DSH/DeepSeek Harness, agent rounds and background tasks can take a long time. After switching tabs or leaving the page, the lack of a clear end prompt makes it easy to miss tasks that have completed, failed, or been terminated. dsh-task-notify is a lightweight plugin for DSH Web that provides sound and tab title notifications when an agent round ends or a background task ends.

What is this

  • Package name: @yangzhe1991/dsh-task-notify
  • Maintainer: yangzhe1991
  • License: MIT
  • Purpose: DSH Web plugin that provides notifications when an agent round or background task ends

It does not replace DSH’s task execution logic; it merely supplements completion notifications on the Web side.

Core Features

Agent Round End Notification

When an agent round in the current session ends, the plugin plays a synthesized two-tone sound. Success is do -> mi, and failure or termination is mi -> do. The sound is synthesized and does not rely on audio files.

Background Task End Notification

The notification sound is also triggered when background tasks enter the completed, failed, or killed state.

Tab Title Notification

When the page is not the active tab, the completion notification is reflected in the tab title. When switching back to that tab, the title will revert to the original title.

Avoid False Positives from Old Rounds

When switching sessions, loading history, or refreshing the page, no notification is triggered due to old rounds. Only rounds that have actually been completed in your current session will trigger notifications.

Installation Format

The plugin is installed as a DSH profile bundle, containing the cordis.patch.yml configuration layer and the lib/client.js browser-side file. Pre-built artifacts are provided when installing via the npm registry; no compilation is required during installation, nor is an allowlist needed.

Compatible Versions

The README states compatibility with dsh ≥ 0.1.2-alpha.4 and still supports dsh 0.1.0-rc.x via the legacy path.

Installation and Activation

First, ensure you have the dsh CLI for DSH or DeepSeek Harness.

Install via npm registry:

dsh plugin --profile web add @yangzhe1991/dsh-task-notify

After installation, restart the Web GUI and refresh the browser tab.

If you previously installed an older version, you can update:

dsh plugin --profile web update @yangzhe1991/dsh-task-notify

If you need to remove it:

dsh plugin --profile web remove @yangzhe1991/dsh-task-notify

First Time Usage

Browser autoplay policies block audio until the user interacts with the page. On first use, click once or press a key on the page to unlock subsequent notifications. Tab title notifications are not affected by this policy.

Trigger Boundaries

Notifications are only triggered in the following cases:

  • An agent completes a round in the current session
  • A background task ends with a status of completed, failed, or killed

Regular foreground tool calls do not trigger notifications.

Customization

The plugin supports adjusting the following constants:

  • SOUND_ENABLED
  • TITLE_ENABLED
  • ALERT_PREFIX

To customize switches, sounds, or title prefixes, you need to edit src/client/index.tsx and rebuild.

Use Cases and Notes

Suitable for developers using agent rounds and background tasks in DSH Web who want to know the task completion status even after leaving the page.

Notes:

  • The plugin runs with the permissions of the current dsh process; please check the source code and MIT license before installing
  • Before browser interaction, notification sounds may be blocked by autoplay policies
  • If installed via git, it will trigger a build, and requires a one-time allowBuilds in pnpm-workspace.yaml; npm registry installation does not require this

Links

  • Community Directory: https://www.skillhub.cn/plugins/yangzhe1991/dsh-task-notify
  • GitHub: https://github.com/yangzhe1991/dsh-task-notify