DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-session-notify

m

dsh-session-notify

Manifest valid

DSH plugin: in-app cards & page-raised system notifications when a session finishes. Client-only, zero dependencies.

UI (client)hasBundlePatch

dsh-session-notify

DeepSeek Harness (DSH) plugin: notifies you when a top-level session finishes its work, fails, gets cancelled, stops waiting for your input, or needs your approval / an answer to a question. Pure client-side — zero dependencies, zero child processes, zero configuration.

当顶层会话完成/出错/取消/等待输入,或需要你授权/回答提问时提醒你。纯页面端实现,零依赖、零子进程、零配置。

Behavior 行为

Scenario 场景Result 结果
Watching the session that triggered the event 正看着触发事件的会话Nothing 不弹
In the GUI, viewing another session/panel 在界面里但开着别的会话In-app card, top-right 右上角应用内卡片
GUI unfocused 界面失焦Page-raised system notification 页面发出的系统通知
GUI closed 界面没开Nothing (by design) 不提醒(设计使然)

The notification title is the session name; the body reflects the last turn's end reason (complete / failed / cancelled / waiting / output limit), or the mid-run interaction (approval needed / answer needed).

标题为会话名;正文反映最后一个回合的结束原因,或运行中的交互请求(等待授权/等待回答)。

In the desktop app, the page-raised notification is delivered by Electron under the DSH app's own identity — whale icon, a single entry in system notification settings. 桌面端里页面通知归属 DSH 本体——鲸鱼图标、系统设置里只有本体一个条目。

Install 安装

In DSH's plugin manager (Plugins → Install bundle), point it at a local clone of this repository:

/path/to/dsh-session-notify

通过 DSH 插件管理器安装本地 clone 的仓库目录即可。The bundle is linked in place — edit client.js (all defaults live in its DEFAULTS block) and changes take effect after a reload. 所有默认行为在 client.js 顶部的 DEFAULTS 里,改完重载即生效。

First unfocused notification asks for notification permission once (Allow it). 首次失焦通知会请求一次通知权限。

How it works 实现

  • client.js — the whole plugin: tracks session running state via api-session/status pushes, reads the session's event stream (sessions.retain), watches the currently viewed session (uiSession.adapter.current), renders plain-DOM cards, and raises notifications through the browser Notification API.
  • Mid-run approvals/questions are detected through redundant channels: the session stream (tool/call of ask_user_question), polling remote.session.state pendingInput while a session runs, and the approval/request / user-questions/request forwarded pushes — shared dedup keys keep it to one notice per request. (In v0.2.2-rc.3 the forwarded pushes are accepted but never dispatched by the client gateway; the stream and polling channels carry the load. If a future release fixes dispatch, the same handlers light up automatically.)
  • index.js — a deliberate no-op; it exists only so the bundle registers as a host plugin, which is what makes the GUI load the client half.
  • docs/DETAIL.md / docs/DETAIL.zh.md — full documentation 完整文档.

Compatibility 兼容

Built against DSH v0.2.2-rc.3 (desktop profile, macOS); verified against v0.2.2-rc.5 by byte-level diff — every client-side file this plugin touches is identical between the two releases. Windows/Linux desktop builds should work identically since everything runs in the page; not verified.

The plugin sits on undocumented client-side surfaces (sessions / remote / uiSession), so a future DSH release can break it silently. It therefore self-checks at startup: if any of those APIs are missing, it logs the exact list with [session-notify] to the console, shows a one-time card, and stays inactive instead of failing quietly.

基于 DSH v0.2.2-rc.3(desktop profile,macOS)构建;插件依赖的客户端侧文件在 v0.2.2-rc.5 中逐字节相同(已 diff 验证),升级无影响。一切逻辑跑在页面里,Windows/Linux 桌面版理论上通用,未实测。

插件依赖若干未公开的页面侧接口(sessions / remote / uiSession),DSH 升级后可能静默失效。因此启动时会自检:缺哪个接口就在控制台以 [session-notify] 前缀列出清单、弹一张一次性卡片,并保持停用,而不是无声地失灵。

License

MIT — see LICENSE.

Comments

Loading…

Similar plugins

dsh-session-bell

Raises one desktop notification when a turn stops, a question waits, or an approval waits. Each event has its own switch; subagent Sessions stay quiet; a click opens the Session. Uses the page's own N

Notifications & IntegrationsManifest valid

★ 0

MIT

JavaScript

dsh plugin --profile web add dsh-session-bell

by Wepoi9

Community DSH plugin for browser and OS notifications on session completion, errors, and pending interactions.

Tools & CapabilitiesManifest valid

★ 0

MIT

JavaScript

Oct 17, 2026

dsh plugin --profile web add dsh-web-notify

by LJY4-bilibili

Raises a Windows desktop notification card when DSH asks you a question, and returns to the asking Session when the card is clicked.

Notifications & IntegrationsManifest valid

★ 0

MIT

JavaScript

Oct 11, 2026

dsh plugin --profile web add dsh-message-reminder

by polunzh

任务通知台 · DSH plugin: task-completion chime + system/browser notifications, plus a Tasks panel to filter running and unread-completed sessions.

Manifest valid

★ 0

MIT

JavaScript

Nov 10, 2026

dsh plugin --profile web add @polunzh/dsh-task-notifier

by Dawn388887

DSH plugin: desktop toast + remote browser notifications when an agent finishes or errors

Tools & CapabilitiesTerminal & ClientsManifest valid

★ 0

↓ 381/wk

MIT

JavaScript

Oct 7, 2026

dsh plugin --profile web add dsh-notify

by AK-blank

Unofficial DSH (DeepSeek Harness) plugin: macOS Notification Center alerts when a session finishes or needs you — the banner carries the last reply, plays your system alert sound, and clicking it jumps back to the DSH page.

Tools & CapabilitiesNotifications & IntegrationsDevelopment & InfrastructureManifest valid

★ 1

MIT

JavaScript

Oct 3, 2026

dsh plugin --profile web add dsh-plugin-mac-notify