How to use dsh-notification
DSH Web desktop notification plugin that sends browser system notifications when tasks complete, encounter errors, or wait for user interaction. Supports status-based toggling and keyword filtering.
This article is auto-derived from indexed fields (wiki / faq / compatibility_json), not freshly AI-generated.
This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.
Quick start
dsh-notification
— source: plugin_wiki.wiki_content
Install & verify
dsh plugin --profile web add dsh-notification
Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.
— source: plugins.install
Key points
- id: dsh-notification
- Rule matching runs client-side against the projected content; the reply body never exceeds
maxBodyChars. - Notifications fire once per finished turn (a running→idle edge on any session); a completion that happened while the page was disconnected is not re-notified on reconnect.
- The rule subject is the session title plus the last turn's reply text and tool names — earlier turns are not matched.
- Notification body is a flat text snippet; the click action only focuses the window (no deep link to the turn).
— source: plugin_wiki.readme_en (fallback readme_raw)
FAQ
Do I need to modify the harness after installation to use it?
No. The host side is automatically mounted via session projection, the client is provided by the web profile by default, and no changes to the harness configuration are needed.
Can notification permission be restored after being denied?
Cannot be restored within the page. After being denied, you must manually go to the site settings in the browser address bar to re-enable Notification permission, then click 'Request Notification Permission'.
Will rounds completed during offline be re-sent after reconnection?
No. On reconnection, the baseline will be re-fetched, and completion edges during offline will not trigger notifications.
Will clicking on a notification jump to that specific round?
No. Clicking will only focus the window, it won't deep-link to the specific round.
Will background-running sub-sessions send notifications?
No. The plugin will skip sessions with origin set to subagent.
What content does the keyword rule match against?
Matches session title, current round's reply text, and tool names called in the current round (deduplicated in order of appearance), does not match earlier rounds.
Will it affect model calls?
No impact. Does not add any new tools, does not modify prompts, reply body is only truncated on the host side according to maxBodyChars.
— source: plugin_wiki.faq_json
Compatibility
- DSH: 未声明
- Node: >=22
— source: plugin_wiki.compatibility_json
Pitfalls
Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.
— source: general rule