omdsh-dev/dsh-notification 预览 preview

omdsh-dev/dsh-notification

DeepSeek Harness完成时的桌面通知,支持按结果分别控制,以及包含/排除关键词规则。

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness (DSH) that adds system desktop notifications to the DSH web GUI. You install it directly via the DSH CLI by running the documented install command, then restart the DSH web server to fully activate the plugin. It works with both DSH 0.1.1 and 0.1.2 client layouts and projection contracts, and adds a dedicated settings section under DSH’s main Settings menu. It sends a notification whenever a DSH session finishes a turn, so you can work in other browser tabs while waiting.

After installation, the DSH host provides a bounded projection of each finished session turn that includes the turn outcome, reply text, and tool names. The plugin’s client component watches the DSH session list for completion events, checks against your saved notification rules, and triggers a system notification only if all criteria are met. You can toggle notifications for different outcome types like errors or completed tasks, add include/exclude keyword rules that use literal or regex matching, and all preferences are saved locally in your browser’s localStorage. This plugin is ideal for users who regularly leave DSH running in the background while switching to other tasks.

This plugin is released under the open-source MIT license, and adds no extra token cost to your DSH usage, does not register any new tools for the model, and does not modify your existing session logs or prompts. It has several documented limitations: notifications require the DSH tab to still be open (though they work when the tab is hidden), you can only get one notification per finished turn, and notifications do not link directly to the completed turn. You must grant the browser notification permission for this plugin to work correctly, and if you deny permission it cannot be overridden from within the DSH page.

这是专为DeepSeek Harness开发的原生插件,为DSH网页版提供系统桌面通知功能。当DSH完成一轮对话处理后,插件会通过浏览器自带的Notification API发送系统通知,让用户切换到其他标签页也能及时知晓任务处理完毕。它支持按任务结果类型开关通知,还能通过关键词规则灵活过滤需要触发通知的场景。

该插件无需修改DSH核心代码,安装后即可独立运行。DSH主机会提供每轮对话的结果投影,插件客户端监听会话列表的完成提醒,结合用户持久化存储的设置决定是否发送通知。用户可以在设置面板调整通知规则,偏好设置保存在浏览器本地存储,适合经常切换标签、后台运行DSH任务的用户使用。

该插件采用MIT许可证开源,当前v0.1.4版本支持DSH 0.1.1和0.1.2版本的客户端布局与投影协议。它不会增加额外token消耗,也不会修改会话日志或提示词。已知限制包括页面必须打开才能收通知,仅触发一次,不支持跳转对应轮次,需要浏览器授予通知权限。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Desktop client: installation downloads an executable - verify the publisher and checksums桌面客户端:安装会下载可执行文件,请核对发布者与校验和
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

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

CLI Install命令行安装

dsh plugin --profile web add https://github.com/omdsh-dev/dsh-notification/archive/refs/tags/v0.1.4.tar.gz

把 omdsh-dev/dsh-notification 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-notification

Desktop notifications for the DeepSeek Harness web GUI. When a session finishes a turn, the browser shows a system notification (via the Notification API), so you can switch tabs and still know when DSH is done. Per-outcome toggles and include/exclude keyword rules control exactly which completions notify.

No harness change is needed: the host contributes a session projection (a bounded summary of each session's last completed turn), and the client watches the session list's completion reminder and applies its own persisted preferences.

host:  notification projection (last turn's reason/text/tools) --session/projection--> browser
client: session list completion reminder (live, dedup) + persisted settings
        -> permission + current-session visibility gate
        -> new Notification("DSH finished", { body: "deploy done" })

Install

dsh plugin --profile web add https://github.com/omdsh-dev/dsh-notification/archive/refs/tags/v0.1.4.tar.gz

Restart the web server so the host half and the served client bundle pick up the plugin. The default dsh web profile has the required client composition (the session list, the settings shell, and locale).

Version 0.1.4 supports both the 0.1.1 and 0.1.2 Harness client package layouts and projection contracts.

The settings section lives under Settings > Notifications.

Settings

Setting Default Effect
Enable notifications on Master switch; off stops every notification while keeping rules.
Notify on completed / error / aborted / blocked / token limit completed + error on, rest off Which turn-end reasons notify (the host projection reports the reason).
Keyword rules none Include/exclude filters matched against the session title, the turn's reply text, and its tool names. Include rules: at least one must match. Exclude rules: a match suppresses. Rules support literal or regex matching with an optional case-sensitive flag.
Require manual dismiss off The notification stays until dismissed.
Only notify when the task is out of view on Suppress a notification only when its session is currently in view. A completion still notifies while the page is hidden or while another session/workspace is open. Turn it off to notify even for the session being watched. Notifications for the same session replace each other.

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev beautiCode 下一个 Next Tokdash →