@dingyi222666/dsh-session-notification
用于 dsh Web GUI 的会话状态通知插件：提供会话完成/失败、提问和权限请求提醒，支持配置内置或自定义声音及浏览器通知，并包含 Notifications 设置部分
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @dingyi222666/dsh-session-notification@0.1.19
Session Notification 以 @dingyi222666/dsh-session-notification 发布，当前版本为 0.1.19。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
English | 中文
A notification plugin for the dsh web GUI. When a session finishes, hits an error, asks you a question, or needs your permission, you get a heads-up: a sound plays, and when you step away from the tab a system notification keeps you in the loop.
| The settings panel with the Notifications entry in the sidebar and the section content | The sound picker for each kind (the official dropdown) |
|---|---|
| The Notifications settings section | The sound picker menu |
# Install from npm (requires dsh >= 0.1.6-alpha.1)
dsh plugin --profile web add @dingyi222666/dsh-session-notification
# Restart dsh web for it to take effect
dsh web
Everything lives in this plugin — no harness (host) changes:
settings.section), exactly like official sections.WEB_SETTINGS_NAMESPACES or any other host-package change. (The node half still reserves the dsh-session-notification namespace host-side through the settings seam; that reservation is inert without exposure.)| Kind | When it fires | Default sound |
|---|---|---|
| Session completed | A turn ends normally (turn/end completed) | chime |
| Session failed | A turn breaks with an error, or the host reports an agent error | fault |
| Question asked | The agent is waiting for your answer (question/requested) | pop |
| Permission requested | The agent requests an authorized operation (approval/requested) | alert |
Each kind can be enabled or disabled and reassigned to any of the four built-in sound effects (or muted). The four sounds are synthesized with Web Audio — no audio files are shipped — and the master volume is adjustable with the official-style slider (0–100%). A fixed loudness boost (~+6 dB) with a soft limiter on the playback chain makes every sound noticeably louder without distortion; custom audio feeds the same chain.
Beyond the four built-in sounds, each kind accepts your own audio file (mp3/ogg/wav, up to 1 MB): pick Custom audio on a kind's row to upload one, and it replaces the built-in for that kind — with a Replace and remove affordance, plus the Custom audio in use tag. Custom files are stored browser-locally (they are device media, not shared preferences).
Browser (system-level) notifications are off by default; turning the switch on asks for the browser's permission first (a user gesture). Once granted, a notification is shown when the event's session is not the one you are reading, or when the tab is in the background. Notifications carry the page's own icon (the favicon the harness serves). A completed session's notification carries its final reply text (the last assistant message). The Test notification button in the section sends one immediately to verify the channel once permission is granted. The session you are reading stays quiet by default — its own events don't interrupt you; flip the Alert for the current session toggle if you want it to alert too.
Notify for picks the scope (default Main, after subagents): All sessions alerts for every session including subagents; Main only alerts for the main session as soon as it goes idle; Main, after subagents holds that alert until every subagent the main session spawned has finished, so a run that only paused between subagent waves never interrupts you early (failures always alert immediately).
The plugin registers a Notifications section in the settings panel (Settings ⚙ → Notifications):
Preferences are stored browser-locally (localStorage) under the dsh-session-notification key — no host settings-namespace exposure required — so they persist across sessions and sync across tabs, and never depend on a harness change.
The browser half watches the sessions list snapshot and each session's conversation snapshot — no polling, no new wire channels:
running edge true→false ends a run; the run is classified failed when a new turn-error node or a host agent-error appeared during it, otherwise completed (a failure that a retry recovered reads as completed).question / approval) raises the question / permission kinds, with the question text or the tool name+reason in the notification body.yarn run build — builds the browser bundle (lib/client.js) and the Node half (lib/index.js / lib/invariant.js).src/client/notification-service.ts — the engine (classification) and dispatcher (gating); src/client/settings-store.ts — the settings section bridge; src/client/NotificationsSection.tsx — the section UI; src/client/sounds.ts + src/client/custom-audio.ts — the built-in and custom sounds.yarn test — behavior tests; yarn run typecheck — type gate.@deepseek-ai/dsh-* types install from npm as devDependencies (^0.1.6-alpha.1); no checkout path mappings.dsh web restart; browser-bundle changes need a rebuild (yarn run build) — a --dev server hot-reloads them.None. The plugin is a pure client-side observer over the already-logged session state; nothing here reaches a model request.
None; this package neither assembles nor sends provider requests.