SeverusZh/dsh-notify-windows
30Last commit Aug 13, 2026
dsh-notify-windows DSH plugin
This plugin listens for DSH session events and displays system toast notifications on Windows 10/11. It covers task completion, approval requests, and agent questions, ensuring you never miss important actions. It uses Windows PowerShell 5.1 WinRT Toast API with zero additional dependencies.
How to install the dsh-notify-windows DSH plugin
dsh plugin --profile web add dsh-notify-windowsCopying does not run this command. Review the repository and version before installing the dsh-notify-windows DSH plugin.
dsh-notify-windows DSH plugin data source
dsh-notify-windows DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-notify-windows DSH plugin can do
- Notifies on task completion, errors, or max-tokens limit reached
- Notifies on approval requests when approval/asked event fires
- Notifies when agent asks a question via ask_user_question tool
Where the dsh-notify-windows DSH plugin fits
- Stay informed about long-running tasks while away from the screen
- Get immediate alerts when an operation requires your approval
- Receive notifications when the agent needs your answer to continue
Who the dsh-notify-windows DSH plugin is for
- DSH users running on Windows who want to monitor agent progress without constantly checking the interface
- Developers using DSH for automated workflows that require occasional human intervention
dsh-notify-windows DSH plugin limitations
- Only works on Windows 10/11 (uses Windows-specific Toast API)
- Requires DSH running with a profile that supports hot-reloading (cordis.patch.yml)
- Does not notify on subagent sessions by default (can be enabled via config)
dsh-notify-windows DSH plugin: from the repository README
Quoted from the SeverusZh/dsh-notify-windows README, the upstream source of the dsh-notify-windows DSH plugin. Copyright remains with the original authors.
> DeepSeek Harness（DSH）插件：当 Agent 需要你关注时，向 Windows 发送系统桌面通知。 <p align="center"> <img src="https://img.shields.io/npm/v/dsh-notify-windows" alt="npm"> <img src="https://img.shields.io/github/license/SeverusZh/dsh-notify-windows" alt="license"> <img src="https://img.shields.io/badge/platform-Windows%2010%2F11-blue" alt="platform"> <img src="https://img.shields.io/github/stars/SeverusZh/dsh-notify-windows?style=social" alt="stars"> </p> **任务完成** ✅ ｜ **等待审批** 🔐 ｜ **等待回答** ❓ —— 离开屏幕也不错过任何需要你处理的事。 ## ✨ 功能 - **任务完成提醒**：监听会话 `turn/end` 事件，任务完成 / 出错 / 输出超限时立即弹窗，标题自动使用会话标题，正文显示原因与轮次； - **权限审批提醒**：监听 `approval/asked` 事件，有操作等待你的审批时立即提醒；会话审批策略为 `never` 时自动跳过（此时没有东西在等你）； - **提问确认提醒**：Agent 调用 `ask_user_question` 向你提问时提醒；本部署下所有工具都经 `run_code` 调用，插件会扫描 `run_code` 程序源码中的 `tools.ask_user_question(` 调用并提取问题文本； - **防打扰**：默认忽略子代理（subagent）会话，只提醒主会话； - **零依赖**：通知通过 Windows PowerShell 5.1 的 WinRT Toast API 发送，自动注册 HKCU 的 AppUserModelId（无需管理员权限）； - **可诊断**：可选日志（`%TEMP%\dsh-notify\notify.log`）与 debug 事件日志。 ## 🚀 安装 ### 方式一：npm（推荐） ```powershell dsh plugin --profile web add dsh-notify-windows ``` 然后在 profile 的 `cordis.patch.yml` 中追加条目（该文件被运行中的 DSH 热监视，改动立即生效，无需重启）： ```yaml - insert: -
Read the full READMERepository license: MIT
dsh-notify-windows DSH plugin questions
Why am I not receiving any notifications?
Check your Windows notification settings: ensure notifications are enabled for the app (DeepSeek Harness) and that Focus Assist is not blocking them. The plugin automatically registers an AppUserModelId on first send, so you may need to allow notifications from that source. Also verify that the plugin is enabled in your cordis.patch.yml and that the DSH session is active.
Does the plugin notify during /goal mode?
By default, no. The plugin suppresses intermediate rounds that are automatically advanced. Only the final round (goal completed or blocked) triggers a notification. If you want notifications for every round, set `notifyOnGoalRounds` to `true` in the configuration.
Why doesn't the approval notification appear sometimes?
If your session's approval policy is set to `never`, the agent will automatically reject approval requests without waiting. In that case, the plugin skips the notification because there is nothing to wait for. Approval notifications only fire when the policy is `ask`.
How can I update the plugin after installing it?
If you installed via npm, run `dsh plugin --profile web update dsh-notify-windows` and then restart the DSH host. If you installed from source, re-run the installation script; the versioned directory name changes, which triggers hot-reloading of the new code without restarting the host.
Can I see debug logs for troubleshooting?
Yes, enable logging by setting `log: true` in the configuration. Logs are written to `%TEMP%\dsh-notify\notify.log`. For more verbose output, set `debug: true` to log all session events, which can help you understand why notifications are or aren't firing.