dsh-task-notify
English | 中文
> A DeepSeek Harness (DSH) plugin that shows a native OS system notification whenever a task completes — goal completion or agent turn end. Windows / macOS / Linux.
Features
- Native OS notifications on every platform: Windows toast, macOS Notification Center, Linux libnotify — real system banners, not blocking dialogs.
- Two "task done" triggers (configurable):
- goal completes (
phase = complete) - an agent turn ends normally
- Zero runtime dependencies — Node built-ins + OS-native commands (PowerShell, osascript, notify-send).
- CJK-safe — Windows text travels via UTF-8 temp files so Chinese/Japanese/Korean content is never corrupted.
- Anti-spam rate-limit between notifications.
Platform support
| OS | Mechanism | Requires |
|---|---|---|
| Windows | WinRT toast (Notification Center) | nothing (AUMID registered at runtime) |
| macOS | osascript display notification |
macOS 10.8+ |
| Linux | notify-send (libnotify) |
libnotify (notify-send); falls back to zenity, then kdialog |
How it works (Windows)
- On first notify, the plugin registers an AppUserModelID (
dsh.tasknotify) underHKCU\Software\Classes\AppUserModelIdsoCreateToastNotifiercan deliver to the interactive desktop. - When a task completes, it writes the title/body to UTF-8 temp files and runs a small PowerShell script that shows a WinRT
ToastText02notification viaToastNotificationManager. - Temp files are removed afterwards. Failures are logged (never thrown) so they never break an agent turn.
Each notification (and any failure) is recorded in an audit log at /task-notify.log.
Install
As a dsh bundle, installable via the profile plugin manager:
dsh plugin --profile web add dsh-task-notify
Or install the repo directly (npm alias spec):
dsh plugin --profile web add github:YuMo226/dsh-task-notify
Manual install (no pnpm)
Copy this package into the profile's hoisted node_modules and add a loader entry:
- insert:
- id: notify
name: dsh-task-notify
config:
onGoalComplete: true
onTurnEnd: true
title: 'DeepSeek Harness'
minIntervalMs: 4000
> Restart dsh web after installing for the plugin to mount.
Configuration
| Key | Type | Default | Description |
|---|---|---|---|
onGoalComplete |
boolean | true |
Notify when a goal completes. |
onTurnEnd |
boolean | true |
Notify when an agent turn ends normally. |
title |
string | DeepSeek Harness |
Leading line of the notification. |
minIntervalMs |
number | 4000 |
Minimum ms between two notifications (anti-spam). |
Troubleshooting
- Windows: make sure the notification center is on and Focus Assist is not set to "Alarms only" / "Priority only".
- Linux: install libnotify (provides
notify-send); if missing, the plugin falls back to zenity, then kdialog. - If no notification appears, check
/task-notify.logfor an error line and open an issue.
License
MIT
