본문으로 건너뛰기
Y

dsh-task-notify

yumo226/dsh-task-notify

작업 완료 시 Windows 네이티브 시스템 알림(Notification Center 토스트)을 표시합니다. 목표 완료 또는 에이전트 턴 종료가 대상입니다.

설치

dsh plugin --profile web add github:yumo226/dsh-task-notify

README

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

OSMechanismRequires
WindowsWinRT toast (Notification Center)nothing (AUMID registered at runtime)
macOSosascript display notificationmacOS 10.8+
Linuxnotify-send (libnotify)libnotify (notify-send); falls back to zenity, then kdialog

How it works (Windows)

  1. On first notify, the plugin registers an AppUserModelID (dsh.tasknotify) under HKCU\Software\Classes\AppUserModelId so CreateToastNotifier can deliver to the interactive desktop.
  2. When a task completes, it writes the title/body to UTF-8 temp files and runs a small PowerShell script that shows a WinRT ToastText02 notification via ToastNotificationManager.
  3. 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 <home>/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

KeyTypeDefaultDescription
onGoalCompletebooleantrueNotify when a goal completes.
onTurnEndbooleantrueNotify when an agent turn ends normally.
titlestringDeepSeek HarnessLeading line of the notification.
minIntervalMsnumber4000Minimum 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 <home>/task-notify.log for an error line and open an issue.

License

MIT

관련 플러그인