dsh-plugin-notify

dsh-notify

中文 | English

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

MIT