跳到主内容

dsh-notification 使用指南

DSH Web 桌面通知插件,任务完成、出错或等待交互时通过浏览器系统通知提醒,并支持按状态开关和关键词过滤。

本文为派生内容(基于 wiki / faq / compatibility_json 自动组装),非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生(wiki / faq / compatibility_json / readme),非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-notification

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-notification

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

  • id: dsh-notification
  • host 侧对会话日志做纯投影折叠(轮次原因、有界的回复文本、工具名),由投影通道交付给浏览器;插件不写日志,不注册面向模型的工具。
  • client 侧监听会话列表的完成提醒(运行时已计算的"未选中会话已完成"实时去重信号),仅在用户授予 Notification 权限后弹通知。
  • 规则匹配在 client 侧针对投影内容进行;回复正文不超过 maxBodyChars。
  • 通知需要页面处于打开状态(隐藏时可弹,但关闭标签页后不再弹),且需授予 Notification 权限;站点权限被拒后无法从页面内恢复。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

安装后需要修改 harness 才能用吗?

不需要。宿主侧通过 session projection 自动挂载,客户端由 web profile 默认提供,无需改动 harness 配置。

通知权限被拒绝后还能恢复吗?

页面内无法恢复。被拒绝后必须手动到浏览器地址栏的站点设置里重新开启 Notification 权限,然后再点「请求通知权限」。

离线期间完成的轮次会在重连后补发通知吗?

不会。重连时会重新拉取 baseline,离线期间的完成边沿不会触发通知。

通知里点开会跳转到具体那一轮吗?

不会。点击只会聚焦窗口,不会深链到具体轮次。

后台运行的子会话会通知吗?

不会。插件会跳过 origin 为 subagent 的会话。

关键词规则匹配的是哪些内容?

匹配会话标题、本轮回复文本以及本轮调用过的工具名(按出现顺序去重),不匹配更早的轮次。

是否会影响模型调用?

不影响。不新增任何工具,不修改提示词,回复正文只在宿主侧按 maxBodyChars 截断。

— 源: plugin_wiki.faq_json

兼容性

  • DSH: 未声明
  • Node: >=22

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库;本指南基于已收录字段自动派生,可能滞后于最新版本。如发现与官方文档冲突,请以上游为准。

— 来源:通用规则