Introduction

In the DSH plugin ecosystem, plugins can fill in the specific usage experience of the DeepSeek Harness client. A relatively direct scenario is: Harness requires you to approve an operation, or needs you to choose a solution, answer ask_user_question, or review a solution. If the browser is not in the foreground, prompts within the window are easily missed.

Existing practices usually involve staying in the browser waiting for the approval card to appear; dsh-plugin-approval-alert provides another way: when Harness needs you to approve or choose a solution, it pops up a system-level notification and prompts the corresponding workspace.

Below is an introduction to the plugin’s capabilities, installation method, and typical usage.

What is this

dsh-plugin-approval-alert is a DeepSeek Harness approval reminder plugin, maintained by doncelee229-cmyk, licensed under MIT.

It is a pure browser-side plugin, registered in the shell.overlay slot, and does not touch the approval pipeline. When Harness needs you to approve or choose a solution, it displays a system-level notification. The notification content will include the name of the workspace requiring approval or solution selection, and will play a prompt sound upon arrival.

Core Features

System-level Notifications

  • Notifications are displayed in the bottom-right corner of the screen, outside the browser window.
  • Notifications are displayed according to the operating system’s default duration and automatically dismiss.
  • Notification appearance and animations are determined by the operating system.

Approval and Solution Selection Reminders

The following scenarios will trigger notifications:

  • Need approval.
  • Need to choose a solution.
  • ask_user_question.
  • Solution review.

Notifications will directly display the workspace name requiring approval or solution selection, without redundant explanation.

Multilingual Notifications

Notification language follows the system language switching:

  • Simplified Chinese.
  • Traditional Chinese.
  • English.

Other languages fall back to English.

Click to Navigate

Clicking the notification will bring the browser back and jump to the corresponding workspace or session.

If clicking the notification causes a new browser window or tab to open, the target session will automatically open after the new page loads.

Prompt Sound

A double-tone upward prompt sound will be played when the notification arrives.

The plugin unlocks audio upon the first user interaction to adapt to browser autoplay restrictions.

Other Session Reminders

Other sessions requiring approval or solution selection will also trigger notifications and support click navigation. For example, when a sub-agent session triggers an approval, a notification will be displayed as well.

Compatibility and Implementation

  • Based on Web Notifications API and Web Audio API.
  • Compatible with Windows 10, Windows 11, Linux, and macOS.
  • On Linux, it depends on the desktop environment’s notification service.
  • Notification appearance, animations, and duration are determined by the operating system.

Installation and Enablement

First, confirm that the browser supports Web Notifications API and Web Audio API, and allow notification permissions for the browser site.

Execute the following command to install the plugin:

dsh plugin --profile web add dsh-plugin-approval-alert

This command will install the plugin to the web profile.

After installation is complete, please click anywhere on the page once during the first use. The plugin will request browser notification permissions and unlock audio during this interaction.

After the above steps, trigger an operation in DeepSeek Harness that requires approval, solution selection, ask_user_question, or solution review, and the plugin will pop up a system-level notification and play a prompt sound.

If no notification pops up, first check if “Notifications” in browser site permissions is allowed.

In a domestic network environment, you can configure the npmmirror mirror first:

npm config set registry https://registry.npmmirror.com

Then execute the installation command mentioned earlier.

Typical Usage

  1. Install the plugin, and click anywhere on the page once during the first use to complete the notification permission request and audio unlock.

  2. In DeepSeek Harness, trigger an operation that requires approval, solution selection, ask_user_question, or solution review.

  3. A notification pops up in the bottom-right corner of the desktop, displaying the corresponding workspace name, and playing a prompt sound.

  4. Click the notification to bring the browser back and jump to the corresponding workspace or session.

  5. Complete the actual decision on the approval card inside the browser, such as “Allow once” or “Reject”.

Note: The plugin is responsible for reminders and navigation; it does not execute approval decisions.

Use Cases and Notes

This plugin is suitable for users of the Web version of DeepSeek Harness who frequently switch windows but still do not want to miss approvals or solution choices.

Pay attention to the following points before use:

  • The plugin does not execute approval decisions; the actual “Allow once” or “Reject” is still completed on the approval card inside the browser.
  • The browser needs to support Web Notifications and Web Audio API.
  • Browser site notification permissions need to be allowed.
  • The first use requires requesting notification permissions and unlocking audio via a single click.
  • Compatible with Windows 10, Windows 11, Linux, and macOS; on Linux, it depends on the desktop environment’s notification service.
  • Notifications are displayed according to the operating system’s default duration and automatically dismiss; appearance and animations are determined by the operating system.
  • The plugin runs with the permissions of the current dsh process; you should check the source code and license before installing. The license for this plugin is MIT.

Related Links

GitHub:

https://github.com/doncelee229-cmyk/dsh-plugin-approval-alert