dsh-notify-win
DeepSeek Harness (DSH) Windows notification plugin — native toast + taskbar flash when a task finishes or your input is needed.
English | 中文
✨ Features
- 🔔 Native Windows toast (bottom-right, Win10/11 system style)
- 💡 Taskbar flash (
FlashWindowEx) when DSH is in the background
- ✅ Triggers when a task finishes (root agent goes
idle)
- ❓ Triggers when your input is needed (approval /
ask_user_question)
- 🖼️ Hero banner with the DeepSeek Harness logo (light/dark theme aware)
- 🚀 Fire-and-forget: no service, no model approval, no settings namespace
🚀 One-line install
dsh plugin --profile web add github:Andyqwe44/dsh-notify-win
Requires pnpm on PATH (corepack enable if missing). See Install for details.
Install
-
Prerequisite: pnpm
corepack enable
Or without admin, put a user-level shim in a PATH directory:
Set-Content -Path "$env:LOCALAPPDATA\Microsoft\WindowsApps\pnpm.cmd" -Value "@echo off`r`ncorepack pnpm %*`r`n"
corepack pnpm --version
-
Install the plugin
# From GitHub (no npm publish needed)
dsh plugin --profile web add github:Andyqwe44/dsh-notify-win
# If github: is blocked, use SSH:
dsh plugin --profile web add git+ssh://git@github.com/Andyqwe44/dsh-notify-win.git
-
Verify
dsh --profile web --dump-config # look for: # == dsh-notify-win / - id: dsh-notify-win
-
Restart and test
dsh web
Complete any task. The first notification self-registers the branded toast identity (Start Menu shortcut + AppUserModelID, one-time). If the toast header still shows DeepSeekHarness without an icon, restart Explorer once:
Stop-Process -Name explorer -Force; Start-Process explorer
Requirements
- Windows 10/11
- DeepSeek Harness, any profile (
web recommended)
- PowerShell 7 or Windows PowerShell 5.1 (5.1 is used automatically as fallback)
Configuration
Edit $env:USERPROFILE\.dsh\profiles\web\cordis.patch.yml:
- id: dsh-notify-win
config:
doneTitle: 'DeepSeek Harness · Task complete'
doneBody: 'Your task has finished.'
questionTitle: 'DeepSeek Harness · Action needed'
questionBody: 'An approval or decision is waiting.'
askTitle: 'DeepSeek Harness · Question for you'
askBody: 'The assistant asked you something.'
dedupMs: 1500 # suppress duplicate notifications within this window
showProject: true # prefix body with project label
To disable:
- id: dsh-notify-win
disabled: true
Restart after install/disable changes (web profile HMR is disabled by default).
How it works
| Concern | Implementation |
|---|
| Trigger "done" | agent/status event with status: 'idle' (root agents only) |
| Trigger "question" | approval/request waterfall + tools/execute for ask_user_question |
| Toast | WinRT Windows.UI.Notifications with hero banner, falls back to NotifyIcon balloon |
| Taskbar flash | EnumWindows + FlashWindowEx (FLASHW_ALL | FLASHW_TIMERNOFG) |
| Execution | Fire-and-forget powershell -File notify.ps1 subprocess |
The plugin registers no service, tool, or settings namespace — a plain consumer row, safe in any profile.
Known limitations
FlashWindowEx uses the system's warm-pulse highlight; custom colors are not possible.- Windows never flashes the foreground window — the taskbar button only flashes when DSH is in the background.
- Cancelling a running turn also goes
idle, so a cancelled task still triggers the "done" toast.
- Notifications are deduplicated per session within
dedupMs (default 1500 ms).
Development
npm run check # syntax check
npm test # logic smoke test (mocked ctx)
# Show a real toast + taskbar flash:
powershell -NoProfile -File lib/notify.ps1 -Kind done -Title "test" -Body "test"
Project layout
dsh-notify-win/
├── lib/
│ ├── index.js # Host half: event listeners -> subprocess spawn
│ └── notify.ps1 # Toast + taskbar flash implementation
├── test/
│ ├── smoke.mjs # Plugin logic smoke test
│ └── headless-overlay.yml
├── cordis.patch.yml # DSH bundle patch
├── package.json # dsh.bundle declaration
├── README.md
└── README.zh.md
License
MIT
