V-Reason/dsh-task-notify

dsh-task-notify

DeepSeekHarness任务完成时进行消息推送提醒(微信+Windows通知)

Uncategorizeddeepseek-harnessdeepseek-harness-plugindsh

dsh-task-notify

中文 | English

The moment your agent stops, Windows tells you.

A DSH (DeepSeek Harness) Web plugin: when a main turn, subagent or workflow finishes — and whenever the agent pauses for you (approval needed, a question for you, a plan awaiting review, a blocked goal) — it raises a real Windows system notification (with the system sound and the DeepSeek icon), plus optional PushPlus push to your phone, so you hear about it even with the browser closed.

Task-completion system notification: the title reads Agent task finished, with session name, time and status below

The desktop channel in the wild: title + session name / time / status, with the DeepSeek icon and the system sound.

Features

CapabilityWhat it does
🔔 System-level notificationsWindows notifications through BurntToast (a PowerShell module), with the system sound and no web permission prompt
📦 No dependency setupThe plugin installs BurntToast itself when missing (current-user scope, no admin); a machine that already has it sees no change at all
🌐 Chinese + EnglishA slider in the panel header switches the notification and panel copy live; the language follows DSH's own Settings → General → Language and defaults to Chinese
🖼️ Hot-swappable iconThe icon is deepseek.png inside the package (content-fingerprint cached): replace it and the next notification uses the new one, no rebuild or restart
📱 Phone pushOptional PushPlus push, for when you are away from the machine
⏸️ Speaks up when you are the blockerApprovals, agent questions, plan reviews and blocked goals each get their own notification
🎛️ Saved as you clickOne master switch plus seven per-kind switches, written to DSH settings immediately and kept across restarts
📐 Layout awareThe configuration panel tracks dsh-better-sidebar's right/bottom panels frame by frame, so it never covers them

What you get notified about

NotificationRaised when
Agent task finishedA main turn / subagent / workflow ends
Approval neededThe agent lacks permission and asks for elevation (approval policy ask)
Agent is asking youThe agent calls ask_user_question and stops to consult you
Plan waiting for reviewAfter /plan, the agent calls exit_plan_mode and waits for your decision
Goal blockedAn autonomous goal run stops on a persistent blocker

Every notification carries the session name (walked up the parent chain to the root conversation), the timestamp and the status (Completed / Failed / Aborted / Blocked …). The full trigger conditions, payload format and status vocabulary are documented in docs/notifications.md (Chinese).

Quick start

  1. Prerequisites — Windows 10 / 11. BurntToast is installed automatically by the plugin (current-user scope, no admin). To install it by hand:

    Install-Module BurntToast -Scope CurrentUser
    
  2. Install the plugin — DSH ≥ 0.1.6-alpha.1; dsh.profile.bundles is reconciled on install:

    dsh plugin --profile web add git+https://github.com/V-Reason/dsh-task-notify.git
    
  3. Verify — restart DSH, click the bell in the session header → expand Notification types → Test Windows notification: you should hear the system sound and see a toast with the DeepSeek icon.

  4. Switch language (optional) — the slider in the panel header flips between 中文 and English with immediate effect on both notifications and the panel. It writes DSH's own language preference, so it stays in sync with Settings → General → Language.

Phone push (optional): scan the QR code at https://www.pushplus.plus to get your one-to-one token → expand the Phone push group, paste it and save → click Test phone push.

Local file: installs, upgrades and troubleshooting: docs/installation.md. Panel interactions and every setting: docs/configuration.md. If the plugin stops working after a DSH upgrade, run npm run verify first to tell a broken plugin apart from a changed platform contract — see docs/troubleshooting.md (the English docs entry point is this file).

Documentation

The detailed documentation is written in Chinese; this file is the English entry point.

DocumentContents
安装与升级Requirements, git / local file: install, duplicate-row and build-script troubleshooting
配置与使用Bell and panel interactions, full settings table with defaults, PushPlus setup
通知类型与触发时机The seven notifications, payload composition, status vocabulary, channels, icon hot swap
测试与验收Acceptance table, the contract verification script and recorded results
DSH 升级后插件失效的排查手册Failure shapes, evidence sources, case studies, high-risk break points
构建与开发Directory layout, build and sync flow, implementation notes, known limits
版本历史Every change from 1.1.0 to 1.8.2

License

Released under MIT. The notification icon deepseek.png is derived from the DeepSeek brand mark (deepseek.svg) and is used as an application icon only.