Pular para o conteúdo principal
O

dsh-windows-notifications

orabla/dsh-windows-notifications

Adds six switches to the DSH settings page that send Windows notifications for approval waiting, questions, task completion, subtasks, errors and turn end. Each kind has an editable toast template and an optional detail line, such as the last reply of a finished turn or the tool an approval is about, and clicking a toast opens its session. DSH must stay running to deliver notifications.

Instalar

dsh plugin --profile web add github:orabla/dsh-windows-notifications

README

Windows notifications for DeepSeek Harness

Six notification switches in the DeepSeek Harness settings window. The section uses the Host Switch and Button primitives and ships English and Simplified Chinese copy. It is a Windows port of dsh-macos-notifications; the delivery still goes through the Web Notification API, which Windows renders as a toast in the notification area and in Action Center.

English | 中文

Install

Install the bundle from this repository:

dsh plugin --profile desktop add github:Orabla/dsh-windows-notifications

--profile takes the profile that runs your DSH instance, usually desktop. The command installs the package and registers the bundle in that profile.

You can also clone the repository and install the directory, or install a packed tarball:

dsh plugin --profile desktop add ./dsh-windows-notifications

Then enable Windows notifications in the settings window and allow notifications.

If toasts stay hidden, allow DeepSeek Harness under Windows Settings > System > Notifications, and turn off Focus assist or Do not disturb.

Events

EventDefault
Approval waitingOn
Question for youOn
Task completedOn
Subtask completedOff
Task errorOn
Turn completedOff

The Host stores these six booleans in DSH_HOME/windows-notifications/settings.json, or ~/.dsh/windows-notifications/settings.json when DSH_HOME is unset. Changes apply immediately and survive a restart.

Notification text

Turn on Custom notification text in the settings section to edit the toast yourself. Every kind gets its own template, and one title template covers the whole toast. The variables are:

VariableValue
{dot}The status glyph of the event
{kind}The event name in the current language
{session}The session title
{detail}The event detail, when the kind includes one
{time}The local time of the event

An empty template keeps the built-in text. The Include the event detail switch decides whether the kind adds its detail line:

KindDetail
Approval waitingThe tool name and the reason the agent gave
QuestionThe question text
Task errorThe failure message
Task completedThe last assistant reply of the finished turn, on one line

A kind that carries a detail uses {dot} {kind} · {detail} as its built-in text, so a completed turn shows what the agent last said instead of a bare "task completed". The other kinds keep the click hint.

The Host never sends a detail the user did not enable.

Behavior

Open the settings window and select the Windows notifications section. Press the permission button first, then the test button.

After permission is granted, the window reconnects the event stream with ready=1. Exactly one permitted window receives events at a time; when the receiving window disconnects, another window takes over. Notifications need an open DSH window that keeps its Host connection.

Clicking an event notification opens the matching session through ctx.uiWorkspace.openSession. The test notification only focuses the DSH window. Bodies carry the configured text; without a custom template they carry fixed copy and never the transcript or tool arguments.

Build

Node.js 22 or newer.

node scripts/build-client.mjs

scripts/build-client.mjs assembles lib/client.js into a window.__ModuleLoader__.load factory named after the package. The factory requests React and DSH primitives from the existing client module table. The Host modules in lib/ are plain ESM and need no build step.

Limits

Focus assist, notification permissions, and app identity can suppress a toast after the system accepts the notification. A granted browser permission does not prove that Windows displays a toast. The test status distinguishes the submitted notification from the Notification API show event.

Plugins relacionados