在 agent development with DeepSeek Harness, sessions often include multiple steps and interim states. Developers need to quickly confirm task completion, handle approvals, or inspect errors within the page, while the native system interactions may not be intuitive enough, or the history mechanism may not support real-time review. @idoall/dsh-notify aims to address state tracking and immediate feedback in these scenarios.

Plugin Overview

This is a DeepSeek Harness plugin for displaying task notifications within the page. It provides clear status hints, a collapsible notification stack, sound feedback, and visual attention in background tabs. Notifications are delivered only in real time; records are not stored in history.

Core Features

1. Notification Styles
Supports “Enhanced” or “Soft” modes. Enhanced mode uses clear status colors (e.g., green for completion, blue for issues, amber for approvals) and a four-second attention bar; Soft mode provides a less prominent display. Cards remain until they are manually closed, the corresponding session is opened, or the response is completed within the card.

2. Collapsible Stack
Notifications are stacked as cards in the top-right corner of the page. Collapsing is enabled by default; new cards are fully visible, while older cards remain below. Up to 50 cards are retained in page memory, with pending actions prioritized.

3. Direct Navigation and Response
Clicking a card navigates directly to a specific turn in the corresponding session. Cards include Composer-compatible options, allowing responses to be completed directly in the toast.

4. Sound and Background Attention
Includes built-in WebAudio notification tones and supports custom audio. Even when the page is in a background tab, users can receive visual or audio reminders through the favicon or a title prefix.

5. State Detection
Notifications are triggered when the Agent enters the idle state, rather than merely based on text completion or timers. This means a card is created only when the task has truly stopped.

6. Task Noise Control
Completion notifications for subtasks, background jobs, and process workflows are disabled by default to avoid information overload.

7. Version Detection
The settings page detects differences between the local version and the latest npm version, and provides an upgrade command.

Installation and Activation

The plugin requires DeepSeek Harness Web profile configuration support. The installation command is as follows:

dsh plugin --profile web add @idoall/dsh-notify@latest

It can also be installed directly from GitHub:

dsh plugin --profile web add "github:idoall/dsh-notify"

Typical Usage

After installation, select a notification style (Enhanced or Soft) in Settings. To use custom sounds, upload files to the <dataDir>/sounds/ folder in the configuration directory. Supported formats include mp3, m4a, aac, wav, ogg, and flac, with a 1MB file size limit.

Use Cases and Notes

Use Cases: Developers who need fine-grained management of long session states and are accustomed to quickly responding to approvals or issues within the page.

Notes:
* The plugin only registers settings sections and page overlays; it does not modify DSH source code.
* Notification records are stored only in an in-memory queue and are not retained after a page refresh or reload.
* It does not support Service Worker, Web Push, or OS-level notification matrices.
* The plugin requires DeepSeek Harness version >=0.1.7-rc.1 and less than 0.3.0.
* The plugin name is @idoall/dsh-notify, but the internal Cordis name and route are dsh-notify.

Through lightweight in-page interactions, the plugin addresses unclear status feedback in DSH’s native interactions. For more details, see the plugin directory or the GitHub repository.