
MuziIsabel/dsh-win-notify
40最近提交 2026年8月14日
dsh-win-notify DSH 插件
该插件监听 DeepSeek Harness 代理状态,当顶层代理完成(idle)或出错时弹出 Windows 原生 Toast 通知,显示应用名“DeepSeek”和官方鲸鱼图标,以及最近一条用户提示词。点击通知可直接切换到已有 GUI 标签页,无需打开新浏览器标签。
如何安装 dsh-win-notify DSH 插件
dsh plugin --profile web add github:MuziIsabel/dsh-win-notify复制不会执行命令。安装 dsh-win-notify DSH 插件前请核对仓库和版本。
dsh-win-notify DSH 插件数据来源
dsh-win-notify DSH 插件快照日期:2026年8月16日
discovered
dsh-win-notify DSH 插件能做什么
- 在代理任务完成或出错时弹出带声音的 Windows 原生 Toast 通知
- 通知正文显示最近一条用户提示词
- 点击通知直接切换到当前会话的 GUI 标签(不产生新标签页)
- 当会话已在前台显示时自动抑制该会话的通知
- 可自定义通知声音、错误通知开关、审批/提问等待提醒等
dsh-win-notify DSH 插件适合哪些场景
- 长时间运行的 DeepSeek 代理任务完成时收到桌面通知
- 代理任务出错时及时获得提醒并快速处理
- 代理等待用户审批或提问时收到通知,避免错过
- 无需频繁查看 GUI,点击通知即可跳转到对应会话
- 正在查看某个会话时,该会话的通知不会打扰你
dsh-win-notify DSH 插件适合谁
- Windows 10/11 上使用 DeepSeek Harness 的用户,希望获得主动桌面通知
- 同时运行多个代理会话的开发者或运维人员,需要任务完成或出错时及时提醒
dsh-win-notify DSH 插件的限制
- 仅支持 Windows 10/11(依赖 PowerShell 5.1 和 Windows Toast 通知基础设施)
- 需要安装并运行 DeepSeek Harness(支持 web、headless、tui 等 profile)
- 通知身份注册会创建开始菜单快捷方式和占位程序;删除快捷方式可能导致通知失效,直到插件重新注册
- 手动停止的任务(aborted)不会触发通知
dsh-win-notify DSH 插件的仓库 README 摘录
以下文字摘自 dsh-win-notify DSH 插件的上游仓库 MuziIsabel/dsh-win-notify 的 README,版权归原作者,仅作引用。
简体中文(默认) | [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
阅读完整 README仓库许可: MIT
dsh-win-notify DSH 插件常见问题
如何安装 dsh-win-notify?
运行命令:`dsh plugin --profile web add github:MuziIsabel/dsh-win-notify`。如果需要其他 profile(如 headless),将 `web` 替换为对应名称。安装后重启 profile 或等待 HMR 生效即可激活插件。
为什么没有收到通知?
首先检查 Windows 通知设置:设置 → 系统 → 通知 → 确保 `DSH.WinNotify` 已启用。同时确认开始菜单中是否有 `DeepSeek.lnk` 快捷方式(插件会自动创建)。如果缺失,插件会在下次激活时重新注册。也可以查看日志文件 `$DSH_HOME/dsh-win-notify.log` 了解详情。
可以自定义通知声音吗?
可以。在 profile 的 `cordis.patch.yml` 中,找到 `win-notify` 配置,将 `sound` 设置为 `default`、`reminder`、`sms`、`alarm` 或 `silent` 之一。默认值为 `default`(系统通知声音)。
是否支持非 Windows 系统?
不支持。该插件专为 Windows 10/11 设计,依赖 Windows Toast 通知 API 和 PowerShell 5.1,无法在 Linux、macOS 或其他平台上运行。
每次子任务完成都会通知吗?
不会。只有顶层代理完成(running → idle)时才会触发通知,子代理回合的完成保持静默,避免频繁打扰。错误通知同样只针对顶层任务。