为 dsh 添加 Windows 原生 Toast 通知与系统托盘图标:agent 完成、停止或出错时弹通知,托盘菜单可重新打开网页或退出后台进程。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-notify
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:Pasumao/dsh-plugin-notify
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
dsh-notify
Windows 原生通知插件:agent 不再运行时(完成 / 停止 / 出错 / 等你选择 / 会话关闭)自动弹原生 Toast,正文标注「工作区 · 会话」——跑长任务时切走窗口,瞄一眼通知就知道跑完了没。
零运行时依赖、零构建,dsh plugin add 一条命令装完即用。
效果图

真实 Windows Toast 实拍:正文标注「工作区 · 会话」。
功能
- Windows 原生 Toast 通知:agent 不再运行时(完成 / 停止 / 出错 / 达到输出上限 / 等你选择 / 会话关闭)自动弹系统通知,正文标注「工作区 · 会话」,一眼知道哪个会话跑完了;
- 防刷屏:
rootsOnly默认仅根会话通知,子代理不刷屏;cooldownMs同会话同类型两次通知最小间隔; - 安全加固:弹通知的子进程环境变量经清洗(剔除含 KEY / SECRET / TOKEN / PASSWORD 的变量),不残留凭据与多余进程;
- Windows 环境系统提示段落:向 agent 系统提示词注入一段 Windows 环境要点(编码 / 路径 / 进程防坑提示),随总开关
enabled一并启停; - 零运行时依赖、零构建,
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 即生效。
兼容性:Windows 10/11 · Node ≥ 22.5 · 实测于 DSH
0.2.0-rc.2。
配置
在 profile 的 cordis.patch.yml 按 id dsh-plugin-notify 覆盖 config。常用项:
| key | 默认 | 说明 |
|---|---|---|
enabled |
true |
插件总开关:同时控制 Toast 通知与系统提示段落注入 |
cooldownMs |
10000 |
同会话同类型两次通知的最小间隔(毫秒) |
rootsOnly |
true |
仅根会话通知,子代理不刷屏 |
titlePrefix |
'dsh' |
通知标题前缀 |
测试
node scripts/test-harness.mjs # 弹三条真实 Toast 自测
常见问题
- 收不到通知? 检查 Windows「设置 → 系统 → 通知」是否允许 PowerShell 显示通知, 以及是否处于专注助手 / 勿扰时段;
- 只想根会话通知? 保持默认
rootsOnly: true;需要观察子代理时再改为false; - 通知太频繁? 调大
cooldownMs(默认 10000ms)即可。
相关插件
本插件属于 Pasumao 的 dsh 插件生态,同系列已发布插件可搭配使用:
| 插件(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 环境防坑:守则技能 + 乱码检测 / 危险写拦截 / 编码诊断修复 |
| dsh-plugin-context-trim | GitHub 仓库 | 会话注入门控:skill / tool / 提示词段落按会话裁剪 |
| dsh-plugin-future-session | GitHub 仓库 | 现实/未来会话:工具调用由继承全部上下文的未来会话代执行,主上下文只保留「一次调用+一份结论」 |
本系列其余插件见 Pasumao · dsh 插件;觉得好用欢迎到 GitHub 点 ⭐。
AI 生成声明
代码与文档由 AI 辅助生成(DeepSeek Harness),均经人工审查与实机验证
(scripts/test-harness.mjs 弹真实 Toast 自测)。
License
链接
同类插件
xmanrui/dsh-im★ 3702
通过二维码或机器人凭据将 IM 机器人接入 DeepSeek Harness(支持飞书、微信、钉钉、企业微信、QQ、Slack、Telegram、Discord 和 WhatsApp 共 9 种渠道)。
shaobeichen/dsh-pocket★ 3041
手机远程访问 DSH Web 界面:扫码即用局域网或公网(cloudflared 隧道)访问,实时同屏、移动端适配布局,带设置页管理。
c1overzz/dsh-bili-scroll★ 1446
让你的 DSH 自己刷 B站 —— 读字幕原文挑内容、写日报,遇到值得看的会发评论 @ 你。
OpenPetsHQ/openpets#dsh★ 1410
将 DeepSeek Harness 的生命周期状态、错误与审批请求,桥接到本地运行的 OpenPets 桌面伙伴。
inclusionAI/Avernet#deepseek-harness-channel-bcn★ 606
通过 WebSocket V2 将 DeepSeek Harness 接入 Avernet Bot 协作网络,支持自动注册、Agent 会话隔离、工具调用事件和多 Bot 路由工具。
zaofan-make/dsh-qqbot★ 265
QQ 官方机器人通道(tencent-connect/dsh-qqbot 的增强 fork):群/私聊ai陪聊、富媒体收发、表情包打标入库+检索发图、入群审批/禁言/群发、定时唤醒、QQ 远程审批与提问卡、互动按钮卡、多账号多实例、扩展接口、群友记忆注入、按消息价值唤醒省token、上下文自动压缩、悬浮球设置面板。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。