Zum Hauptinhalt springen
C

dsh-desktop-notify

chengzhi43/dsh-desktop-notify

Sends a desktop notification when a turn finishes or the agent waits for your choice, and a click returns to that conversation.

Installation

dsh plugin --profile web add github:chengzhi43/dsh-desktop-notify

README

简体中文 · English

dsh-desktop-notify: a bell in a rounded tile next to the project name

dsh-desktop-notify

DeepSeek Harness sessions run in the background. The plugin reports the two moments that need you: the turn finished, or the agent is waiting for your choice.

Star this repository Latest release Checks MIT license Open issues Last commit macOS, Windows, Linux DeepSeek Harness plugin

A star helps the next person who needs this plugin find it.

A session commonly runs for several minutes. While the window is in the background, two events matter: the turn finishes, or the agent stops and waits for an answer. The plugin delivers both through the system notification center, and a click returns to that conversation.

It is a client-side bundle: one directory, no dependencies, no build step, no network requests, and nothing written to disk.

Notification content

EventBodyClick
A turn finishes<conversation> · finishedOpens that conversation
A question, approval, plan review, or action card starts waiting<conversation> · waiting for your choiceOpens that conversation

The title is always DeepSeek Harness; the body carries the conversation name and the state. The state text follows the application language, currently eight of them. Subagent conversations are excluded, and a pending request that is published again does not produce a second notification.

Install

Two methods are available. Either one produces the same plugin directory.

  1. In DSH, open Plugins → Discover → Add index source.
  2. Paste the index URL:
https://raw.githubusercontent.com/chengzhi43/dsh-desktop-notify/main/index.json
  1. The list now contains dsh-desktop-notify. Choose Install. Every entry pins a commit, so the installed files match the listed version.
  2. Allow notifications in the system settings, as described below.

The index file can be inspected directly at index.json.

Option 2: install from the bundle directory

  1. Download dsh-desktop-notify.zip from the latest release.
  2. Unzip it into a directory that can remain in place.
  3. In DSH, open Plugins → Add plugin and select that directory. Its root must contain package.json.
  4. Reload the window with Cmd/Ctrl + R.

For both methods, the operating system must permit notifications from the application: macOS System Settings → Notifications → DeepSeek Harness, Windows Settings → System → Notifications.

Platform verification, including the open Windows toast question, is recorded in docs/WINDOWS-VERIFICATION.md.

How it works

DSH client (open page)
  uiSession.sessionStatus          running + highest-precedence pending interaction
    dsh-desktop-notify             diff one snapshot against the previous one
      Notification                 "<title> · finished" / "<title> · waiting for your choice"
        click                      uiWorkspace.openSession(sessionId)
  fallback: sessions.list          running state only, completions still announced

The plugin keeps a small map in memory and compares each snapshot with the previous one. A running value that changes from true to false indicates a finished turn; a new pending-interaction key indicates that the application expects an answer. No state is persisted, and unloading the bundle removes the subscription.

The state it reads is the one the application already publishes, the same source behind the sidebar indicator and the pending panel in the composer. Approval prompts and plan reviews are covered for that reason: they share this status, so no separate handling is required.

Requirements and limits

  • DeepSeek Harness desktop 0.2.2-rc.3 or newer. That is the release this plugin was developed and verified on, and the bundled runtime reports the same version. Earlier builds have not been tested; a build without uiSession.sessionStatus falls back to the conversation list and then reports completions only, without the waiting state.
  • Notifications originate from the open page. When the window is closed or the application quits, no notification is delivered, although the session continues to run on the host.
  • There is no sound setting, no per-conversation mute, and no quiet hours. A pending request notifies once, and repeated publication of the same state stays silent.
  • On Linux, delivery depends on the desktop notification service and on whether it reports clicks back to Electron.
  • In a browser tab, the first notification passes through the browser permission prompt.
  • On Windows, a window minimized to the tray may not come forward on click. Raising it requires a dsh://open call, which this plugin does not make.
  • The plugin adds no model-facing text, sends no telemetry, and reads no credentials.

Local verification

git clone https://github.com/chengzhi43/dsh-desktop-notify.git
cd dsh-desktop-notify
node --check client.js
node test/harness.cjs

The harness replaces the client services with stubs, so it runs without a DOM, Electron, or DSH. It covers completion, pending choice, duplicate suppression, subagent exclusion, click navigation, teardown, and the fallback path. CI runs the same commands on Linux and validates the index file; see .github/workflows/checks.yml.

Contributing

Issues in Chinese or English are both acceptable. For code changes: keep the bundle dependency-free and client-side, keep the status comparison as the only source of state, and add an entry to CHANGELOG.md. A new kind of notification usually means the application gained a new pending interaction rather than that this plugin needs more code.

License

MIT. Use, fork, and redistribute it inside your own setup.

If the plugin is useful: star the repository, watch releases for updates, and open an issue when a notification is missing or repeatedly noisy.

Ähnliche Plugins