dsh-notification：DeepSeek Harness 的桌面通知插件

dsh-notification 是 DeepSeek Harness（DSH）的桌面通知插件（DSH plugin），专为 Web GUI 设计。它解决的核心问题是：当你在浏览器中切换到其他标签页时，无法及时得知 DSH 会话是否已完成。该插件通过浏览器 Notification API 发送系统通知，让你在后台也能第一时间知道任务结束。它提供了按结果类型（完成、错误、中止等）的开关，以及包含/排除关键词规则，让你精确控制哪些完成事件需要通知。该插件由 omdsh-dev 维护，采用 MIT 协议，最近更新于 2026-08，目前有 52 个 Star，代码以 JavaScript 编写。

dsh-notification 这个 DSH plugin 支持哪些核心特性？

该插件支持多种通知控制：主开关（Enable notifications）可一键关闭所有通知；按结果类型（completed、error、aborted、blocked、token limit）分别设置是否通知；关键词规则支持包含/排除，可匹配会话标题、回复文本和工具名称，支持字面量或正则匹配，并可选大小写敏感；还有“需要手动关闭”选项，以及“仅当任务不在视野中时通知”的智能抑制功能。通知偏好持久化在浏览器 localStorage 中，设置界面位于 Settings > Notifications，并提供测试通知功能。

dsh-notification 怎么安装？

安装命令如下，安装后需重启 Web 服务器以加载插件：

dsh plugin --profile web add github:omdsh-dev/dsh-notification

默认的 dsh web 配置已包含所需的客户端组合（会话列表、设置外壳和本地化）。

dsh-notification 如何配置？

主机端可调参数位于 cordis.yml 的插件行中，例如设置投影正文的最大字符数：

- id: dsh-notification
  name: dsh-notification
  config:
    maxBodyChars: 400

该参数控制投影正文的预算，较长的回复会在主机端进行省略。

dsh-notification 对模型体验有何影响？

该插件对模型体验零影响：不增加 token 成本（通知纯 UI 操作，不进入请求）、不新增工具调用、不修改会话日志、不注册系统提示词。它通过会话投影（session projection）读取现有日志，并在客户端监听会话列表的完成提醒，仅在用户授予通知权限时显示通知。

dsh-notification 的权限边界如何设计？

主机端仅对会话日志进行纯投影（包含结果原因、有界回复文本、工具名），不写入日志，也不注册模型相关工具。客户端监听会话列表的完成提醒（运行时已计算的“未选中时完成”边缘），仅在用户授予通知权限时显示通知。规则匹配在客户端针对投影内容进行，回复正文不会超过 maxBodyChars。

dsh-notification 如何开发与测试？

开发环境需要将 dsh 仓库链接到 ../dsh，然后使用 pnpm 命令：

pnpm install
pnpm run check
pnpm run test
pnpm run build

测试覆盖主机投影、客户端决策、运行器、辅助函数和设置部分。

查看更多 DSH 插件，访问 dsh-plugin.org