@local/dsh-notifier
用于 DSH 审批和用户问题的浏览器系统通知
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:AlleyRain/dsh-notifier#12a2d816951edcba8cc3985d5927f3cfe85e503bNotifier 以 @local/dsh-notifier 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DSH Browser Notifications icon
A small DSH plugin that turns pending approvals and questions into browser system notifications.
When DSH is waiting for you—an approval for a tool call or an ask_user_question prompt—it is easy to miss while another tab or window has your attention. This plugin uses the browser's Web Notifications API to surface that request without notify-send, AppleScript, PowerShell, or any native helper binary.
approval/request).user-questions/request), including plan reviews.next().flowchart LR
A["approval/request<br/>user-questions/request"] --> B["Host observer<br/>(prepend, observe only)"]
B --> C["Authenticated SSE<br/>/dsh-notifier/events"]
C --> D["Client EventSource"]
D --> E{"DSH page focused?"}
E -- yes --> F["In-app approval/question UI"]
E -- no --> G["Web Notification"]
G --> H["Click: focus DSH<br/>open Session"]
The Host listener uses prepend: true. The shipped browser answerer owns the request waterfall and waits for the user, so observing before it runs is what makes the notification timely. The listener always delegates with next() and does not change the outcome.
The Client half connects to one same-origin SSE endpoint. The endpoint sits behind DSH's existing connection fence (ctx.connection.requestRejection), so it uses the browser session cookie and adds no new authentication mechanism.
dsh web).localhost / 127.0.0.1.This directory is a DSH bundle. Install it through DSH's Plugin Manager:
git clone https://github.com/AlleyRain/dsh-notifier.git
plugin_manager with action: install_bundle and the absolute path to the cloned directory.The install writes the bundle selection and package dependency into the active profile. Do not hand-edit the profile's package.json.
The package name is
@local/dsh-notifierbecause this is a local bundle. It is not published to npm.
The permission request is deliberately tied to that button. DSH does not prompt for notification permission on page load.
| DSH page state | Result |
|---|---|
| Foreground and focused | In-app approval/question UI only; no system notification |
| Background tab, other tab active, minimized | Browser system notification |
| Tab closed | No notification; the SSE connection is gone |
| Browser fully closed | No notification |
| OS Do Not Disturb / Focus | The system may suppress the notification |
Additional details:
tag lets browsers that support it replace the duplicate instead of stacking it.never never asks, so it never notifies.DSH's Plugin Manager runs a bounded git ls-remote GitHub check before it starts pnpm. Its default githubConnectionTimeoutMs is 5000 ms; on a slow GitHub connection the check times out before the package is fetched. Raise it in the profile's user patch:
- id: plugin-manager
name: "@deepseek-ai/dsh-plugin-manager"
config:
githubConnectionTimeoutMs: 60000
Then retry the install. This is a DSH Plugin Manager setting, not a setting of this plugin.
localhost, 127.0.0.1, or HTTPS. Plain http:// on a non-loopback host is not a secure context.That is intentional: the in-app UI is already visible and a system notification would duplicate it. This version has no switch for that behavior.
Browser notifications require a live page and SSE connection. Delivery with the browser fully closed would need a separate OS-level backend.
Mobile Chrome generally requires a Service Worker registration to display notifications. This version targets desktop browsers.
connection.requestRejection fence.next().No build step and no runtime dependencies.
node --check index.js
node --check client.js
node --test test/*.test.js
Layout:
| Path | Purpose |
|---|---|
index.js | Host bundle: SSE endpoint and the two prepended request observers |
client.js | Browser bundle: SSE subscription, Web Notifications, General settings row |
locale/en.json, locale/zh.json | Plugin Manager title and description |
test/ | Host payload, framing, route, and lifecycle tests |
cordis.patch.yml | Bundle row inserted into the DSH profile |
0.2.1-rc.3, Web profile.ask_user_question 时，通过浏览器系统通知提醒你。MIT © 2026 AlleyRain. See LICENSE.