dsh-desktop-notify
Windows 原生通知插件：任务完成 / 需要提问 / 出错时弹 toast，并播放内置 ciallo 提示音。
安装
dsh plugin --profile desktop add github:Dax233/dsh-desktop-notify
安装后重启 DSH Desktop；通知样式与声音受 Windows 通知设置影响。
@local/dsh-desktop-notify
Native Windows system notifications for the DSH agent, with the system sound.
How it works
- Host half (
index.js + toast.js): registers the notify tool and sends the
toast directly through Windows PowerShell + WinRT (ToastNotificationManager),
using the DSH AppUserModelID electron.app.DeepSeek Harness read from the installed
Start-Menu shortcut, so toasts are branded DeepSeek Harness. Sound is played
explicitly with System.Media.SoundPlayer (system WAV), so a muted
notification-sound setting does not silence the alert.
- Why not the renderer Web Notification API: on the target machine it delivered
nothing at all (not even to the Action Center), while WinRT toasts do reach the
Action Center. No
node-notifier/SnoreToast (LGPL) dependency either.
Research note (2026-10-22): DSH exposes no plugin-level notification API (only the
desktop main process uses Electron Notification for mandatory updates), and the
main-process module is not reachable from a plugin. Existing open-source agent
notification tools are CLI hook scripts (macOS osascript, PowerShell WinRT, or
node-notifier + SnoreToast); none is a DSH plugin. The renderer Web Notification
path is the zero-dependency fit here.
Tool surface
notify({ title, body?, sound?, urgency?, tag?, action? })
| field | meaning |
|---|
title | short headline (required) |
body | one or two lines of context |
sound | default true; false sends a silent toast |
urgency | info (default) / attention / blocked (blocked uses requireInteraction, stays until dismissed) |
tag | a newer toast with the same tag replaces the older one |
action | send (default) or status |
Usage guidance given to the model: one notification per meaningful state change —
task finished, blocked on the user, or the user asked to be pinged.
Tests
cd <repo>
node --test tests/notify-client.test.mjs tests/notify-host.test.mjs
Client tests execute the real client.js in a Node VM with a mocked
Notification class (grant / request-permission / denial paths, silent flag,
round-trip result). Host tests cover the tool schema (wire-ready JSON Schema),
status, empty-title rejection and a fake-client round-trip.
Requirements / limitations
- Windows toast permission comes from the DSH desktop app; if Windows notification
settings disable the app, the tool reports
permission is denied.
- Desktop-only (needs the DSH desktop renderer and its Web Notification support).
- Sound volume/focus-assist is controlled by Windows; the plugin can only choose
silent vs default sound.
详细设计与排障：见 docs/desktop-notify.md。
