Skip to content
  • Home
  • Plugin manual
  • dsh-win-notify

MuziIsabel/dsh-win-notify

40Last commit Aug 14, 2026

dsh-win-notify DSH plugin

This plugin monitors DeepSeek Harness agent status and pops a native Windows Toast notification when a top-level agent finishes (idle) or encounters an error. It displays the app name "DeepSeek" with the official whale icon and the latest user prompt. Notifications can be clicked to switch to the existing GUI tab without opening a new browser tab.

ui-productivity

How to install the dsh-win-notify DSH plugin

dsh plugin --profile web add github:MuziIsabel/dsh-win-notify

Copying does not run this command. Review the repository and version before installing the dsh-win-notify DSH plugin.

dsh-win-notify DSH plugin data source

dsh-win-notify DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-win-notify DSH plugin can do

  • Shows native Windows Toast notifications with sound on agent completion or error
  • Displays the last user prompt in the notification body
  • Click notification to switch to the existing GUI session tab (no new tab)
  • Suppresses notifications when the session is already visible in the foreground
  • Customizable notification sound, error reporting, and approval/question waiting alerts

Where the dsh-win-notify DSH plugin fits

  • Get notified when a long-running DeepSeek agent task finishes
  • Receive alerts when an agent encounters an error and needs attention
  • Be reminded when the agent is waiting for user approval or answering a question
  • Stay informed without constantly checking the GUI – click notification to jump to the session
  • Avoid distraction: notifications are silenced when you are already viewing the session

Who the dsh-win-notify DSH plugin is for

  • DeepSeek Harness users on Windows 10/11 who want proactive desktop notifications
  • Developers and operators running multiple agent sessions who need to be alerted on completion or errors

dsh-win-notify DSH plugin limitations

  • Only works on Windows 10/11 (requires PowerShell 5.1 and Windows Toast infrastructure)
  • Requires DeepSeek Harness to be installed and running (supports all profiles: web, headless, tui)
  • Notification identity registration creates a shortcut and placeholder executable; deleting the shortcut may break notifications until plugin re-registers
  • Manual stop of a task (aborted) does not trigger a notification

dsh-win-notify DSH plugin: from the repository README

Quoted from the MuziIsabel/dsh-win-notify README, the upstream source of the dsh-win-notify DSH plugin. Copyright remains with the original authors.

简体中文（默认） | [English](README.en.md) 一个 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（dsh）插件：代理任务完成时在 Windows 上弹出**带声音的 Toast 通知**。 - 通知显示应用名 **DeepSeek** 与官方鲸鱼图标 - **顶层**代理回合完成（running → idle）时通知；子代理回合保持静默 - 通知正文显示最近一条用户提示词 - 任务出错时也会通知（可配置） - **点击通知直接切换并前台显示现有 GUI 标签** —— 不产生临时浏览器标签；仅当没有存活 GUI 时才新开标签（`?session=<id>` 深链） - 等待沙箱/权限审批时也会通知（可配置） - 代理通过 `ask_user_question` 提问等待回复时也会通知（可配置） - **聚焦感知：** GUI 页面处于前台且正显示触发事件的会话时，抑制该会话的通知 —— 你正在查看时不会被打扰 - 手动停止的任务**不算**完成 —— 不弹通知 - 仅依赖 Windows 自带的 PowerShell 5.1 —— 无额外依赖 ## 环境要求 - Windows 10/11 - dsh（DeepSeek Harness）—— 任意 profile（web、headless、tui） ## 安装 ```sh dsh plugin --profile web add github:MuziIsabel/dsh-win-notify ``` `dsh plugin` 会在 profile 目录内转发给 pnpm；bundle 会把自身合并进 profile 的 `dsh.profile.bundles` 列表。重启 profile（或让 profile 的 HMR 生效）即可激活。 > 插件适用于任意 profile —— 如需在其他 profile 收到通知，可用同样的方式添加到 `headless` 等 profile。 ## 卸载 ```sh dsh plugin --profile web remove dsh-win-notify ``` ## 配置 bundle 会在 profile 中插入加载行 `win-notify`。在 profile 的 `cordis.patch.yml` 中覆盖其配置： ```yaml - id: win-notify config: enabled: true # 启用插件（默认 true） sound: default # default | reminder | sms | alarm | silent

Read the full READMERepository license: MIT

dsh-win-notify DSH plugin questions

How do I install dsh-win-notify?

Run the command: `dsh plugin --profile web add github:MuziIsabel/dsh-win-notify`. Replace `web` with your profile name (e.g., `headless`, `tui`) if needed. The plugin will be activated after restarting the profile or using HMR.

Why don't I see any notifications?

First, check that Windows notifications are enabled: Settings → System → Notifications → ensure `DSH.WinNotify` is allowed. Also verify that the start menu shortcut `DeepSeek.lnk` exists (the plugin creates it automatically). If missing, the plugin will re-register on next activation. Check the log file at `$DSH_HOME/dsh-win-notify.log` for details.

Can I customize the notification sound?

Yes. In your profile's `cordis.patch.yml`, under the `win-notify` config, set `sound` to one of: `default`, `reminder`, `sms`, `alarm`, or `silent`. The default is `default` (the system notification sound).

Does it work on non-Windows systems?

No. This plugin is specifically designed for Windows 10/11 and relies on the Windows Toast notification API and PowerShell 5.1. It will not work on Linux, macOS, or other platforms.

Will I get notifications for every subtask?

No. Only top-level agent completion (running → idle) triggers notifications. Subtask completions (nested agent turns) are kept silent to avoid spam. Error notifications are also top-level only.