dsh-notify-windows DSH 插件

该插件监听 DSH 会话事件，在 Windows 10/11 上显示系统 Toast 通知。覆盖任务完成、审批请求和 Agent 提问场景，确保你不错过重要操作。使用 Windows PowerShell 5.1 WinRT Toast API，零额外依赖。

remote-execution developer-tools

如何安装 dsh-notify-windows DSH 插件

dsh plugin --profile web add dsh-notify-windows

复制不会执行命令。安装 dsh-notify-windows DSH 插件前请核对仓库和版本。

dsh-notify-windows DSH 插件数据来源

dsh-notify-windows DSH 插件快照日期：2026年8月16日

discovered

dsh-notify-windows DSH 插件能做什么

任务完成、出错或 token 超限时发送通知
审批请求（approval/asked 事件）触发通知
Agent 通过 ask_user_question 提问时发送通知

dsh-notify-windows DSH 插件适合哪些场景

离开屏幕时监控长时间运行的任务状态
需要立即审批操作时收到即时提醒
Agent 等待回答时及时获取通知以继续流程

dsh-notify-windows DSH 插件适合谁

在 Windows 上使用 DSH 的用户，希望无需频繁查看界面即可掌握 Agent 动态
使用 DSH 进行自动化工作流且需要偶尔人工干预的开发者

dsh-notify-windows DSH 插件的限制

仅支持 Windows 10/11（依赖 Windows 专用 Toast API）
需要 DSH 运行在支持热加载的 profile 上（cordis.patch.yml）
默认不通知子代理会话（可通过配置启用）

dsh-notify-windows DSH 插件的仓库 README 摘录

以下文字摘自 dsh-notify-windows DSH 插件的上游仓库 SeverusZh/dsh-notify-windows 的 README，版权归原作者，仅作引用。

> 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: -

阅读完整 README仓库许可: MIT

dsh-notify-windows DSH 插件常见问题

收不到通知怎么办？

检查 Windows 的“通知与操作”设置，确保允许该应用（DeepSeek Harness）显示通知，并关闭“专注助手”。插件首次发送时会自动注册 AppUserModelId，你可能需要允许该来源的通知。另外确认 cordis.patch.yml 中插件已启用且 DSH 会话正在运行。

在 /goal 模式下会提醒吗？

默认不会。插件会静默过滤自动推进的中间回合，只在目标完成或阻塞的最终回合触发通知。如果你希望每个回合都提醒，可以在配置中将 `notifyOnGoalRounds` 设为 `true`。

为什么审批提醒有时不弹？

如果会话的审批策略设置为 `never`，Agent 会自动拒绝审批请求而不等待，此时插件会跳过提醒。只有当策略为 `ask` 时，审批提醒才会触发。

如何更新已安装的插件？

如果通过 npm 安装，执行 `dsh plugin --profile web update dsh-notify-windows` 后重启 DSH 宿主。如果通过源码安装，重新运行安装脚本即可；版本目录名变化会触发热加载新代码，无需重启宿主。

如何启用调试日志？

在配置中将 `log` 设为 `true`，日志会写入 `%TEMP%\dsh-notify\notify.log`。如需更详细的信息，将 `debug` 设为 `true`，会记录所有会话事件，帮助你排查通知为何触发或不触发。