Pasumao/dsh-plugin-notify

Name: Pasumao/dsh-plugin-notify
Author: Pasumao

插件Plugin 原生Native ⭐ 3 MIT cat_label.deepseek-harnesscat_label.deepseek-harness cat_label.dshcat_label.dsh cat_label.notificationcat_label.notification cat_label.windowscat_label.windows

唯一带系统托盘的 Windows 原生通知插件：agent 不再运行时（完成 / 停止 / 出错 / 等你选择 / 会话关闭）自动弹原生 Toast，正文标注「工作区 · 会话」，任务栏托盘常驻鲸鱼图标——跑长任务时切走窗口，瞄一眼托盘就知道跑完了没。

catalog 简介 / catalog descriptioncatalog description：dsh插件，agent操作结束后调用系统通知，在windows托盘增加图标来启动页面和关闭后台程序

项目介绍Project Overview

由知微Agent(zhiwei)编辑Edited by Zhiwei Agent (zhiwei)

dsh-notify 是 DSH 的 Windows 原生通知插件：agent 完成、停止、出错、达输出上限、等待选择或会话关闭时弹 Toast，正文标注「工作区·会话」，并常驻任务栏托盘鲸鱼图标，右键可打开 dsh web 或退出。适合跑长任务、挂机批量处理或多开会话时切走窗口。默认 rootsOnly 仅通知根会话、cooldownMs 限流防刷屏；零依赖免构建，装后需重启 dsh web。注意仅限 Windows，收不到通知要检查系统通知与勿扰设置。

dsh-notify is a DSH plugin for Windows native notifications. When an agent finishes, stops, errors, hits output limits, waits for a choice, or its session closes, it shows a Toast labeled with workspace and session, plus a persistent system-tray whale icon with a menu to open dsh web or quit. Use it for long tasks, overnight batches, or multiple sessions while working in other windows. It defaults to root-session-only notifications and cooldown throttling, with no runtime dependencies. Windows only; restart dsh web after install and check notification/focus-assist settings if Toasts don't appear.

在 GitHub 查看View on GitHub

发给你的 DSH 安装Send to your DSH

请帮我了解并安装插件：【dsh-plugin-notify】【https://github.com/Pasumao/dsh-plugin-notify】

把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.

或使用命令行安装（适合开发者）Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add dsh-notify

把 Pasumao/dsh-plugin-notify 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

5.0 KB · 缓存于 2026-08-27 04:57:00 · 5.0 KB

dsh-notify

npm version License

唯一带系统托盘的 Windows 原生通知插件：agent 不再运行时（完成 / 停止 / 出错 / 等你选择 / 会话关闭）自动弹原生 Toast，正文标注「工作区 · 会话」，任务栏托盘常驻鲸鱼图标——跑长任务时切走窗口，瞄一眼托盘就知道跑完了没。

零运行时依赖、零构建，dsh plugin add 一条命令装完即用。

功能

Windows 原生 Toast 通知：agent 不再运行时（完成 / 停止 / 出错 / 达到输出上限 / 等你选择 / 会话关闭）自动弹系统通知，正文标注「工作区 · 会话」，一眼知道哪个会话跑完了；
系统托盘常驻图标：任务栏托盘鲸鱼图标常驻，右键菜单可唤起 dsh web 页面 / 退出后台（竞品均明确不做托盘，本插件是 dsh 生态唯一）；
防刷屏：rootsOnly 默认仅根会话通知，子代理不刷屏；cooldownMs 同会话同类型两次通知最小间隔；
零运行时依赖、零构建，dsh plugin add 一条命令装完即用。

使用场景

跑长任务时切走窗口：LLM 长生成 / 批处理跑着，切到别的应用，任务结束托盘弹通知，瞄一眼就知道结果；
挂机批量任务：一晚上跑多轮任务，全部结束后收到 Toast，不用守着页面；
会话多开：同时跑多个工作区会话，通知正文带「工作区 · 会话」标注，不会搞混；
子代理观察：希望只关注根会话结果时保持 rootsOnly: true 默认值，需要观察子代理时再关掉。

安装

dsh plugin --profile web add dsh-notify

GitHub 安装：dsh plugin --profile web add github:Pasumao/dsh-plugin-notify

源码安装（本地开发 / 调试）：

git clone https://github.com/Pasumao/dsh-plugin-notify.git
cd dsh-plugin-notify
npm install
# 以 link: 方式挂载进 profile（包名 dsh-notify）

装完重启 dsh web，任务栏出现鲸鱼图标即生效。

触发时机

任务完成、被中止、执行出错、达到输出上限、停下来等你选择、运行中的会话被关闭。

配置

在 profile 的 cordis.patch.yml 按 id dsh-plugin-notify 覆盖 config。常用项：

key	默认	说明
`cooldownMs`	`10000`	同会话同类型两次通知的最小间隔（毫秒）
`rootsOnly`	`true`	仅根会话通知，子代理不刷屏
`tray`	`true`	托盘图标开关
`titlePrefix`	`'dsh'`	通知标题前缀

测试

node scripts/test-harness.mjs   # 弹三条真实 Toast 自测

常见问题

收不到通知？ 检查 Windows「设置 → 系统 → 通知」是否允许 PowerShell 显示通知，以及是否处于专注助手 / 勿扰时段；
只想根会话通知？ 保持默认 rootsOnly: true；需要观察子代理时再改为 false；
通知太频繁？ 调大 cooldownMs（默认 10000ms）即可；
托盘图标不见了？ 重启 dsh web；仍无则检查 tray: true 配置项是否被覆盖。

排障

Toast 不出现：检查 Windows「通知与操作」是否允许 PowerShell 显示通知。

AI 生成声明

代码与文档由 AI 辅助生成（DeepSeek Harness），均经人工审查与实机验证（scripts/test-harness.mjs 弹真实 Toast 自测）。

License

MIT

渲染基于仓库 Pasumao/dsh-plugin-notify 的 README.md。在 GitHub 查看原文 →

插件（npm）	GitHub	说明
dsh-plugin-choice-refresh	GitHub 仓库	选择增强：重新生成选项 / 更多选项
dsh-plugin-dev-kb	GitHub 仓库	插件开发知识库（官方文档完整镜像 + 技能）
dsh-plugin-image-tools	GitHub 仓库	图片选择卡 + 回复内嵌图片 + 盲模型收图
dsh-plugin-table-zoom	GitHub 仓库	聊天长表格浮窗查看 + 一键复制 Markdown
dsh-plugin-windows-guard	GitHub 仓库	Windows 环境防坑守则 skill（编码/转义/路径/进程/乱码预防）
dsh-plugin-workbench	GitHub 仓库	VS Code 风格文件浏览器 + 可编辑预览

命令行安装CLI Install 复制安装命令Copy Install