DSH Plugins Marketplace

DSH Plugins

Plugins

/

Notifications & Integrations

/

dsh-session-notify

d

dsh-session-notify

Manifest valid

Pops a bottom-right desktop card the moment a watched session finishes its turn: watch or unwatch any session from its sidebar right-click menu, preview the card with a test pop, and click it to jump

UI (client)hasBundlePatch

Session finish notifications

A card in the bottom-right corner of your screen the moment a conversation you are keeping an eye on finishes a turn. Watch several sessions, work elsewhere, and let the desktop tell you when one is done.

Use it

  1. In the sidebar, right-click the session you want to follow.

  2. The menu carries one row, 会话提醒设置 › (Session notifications). Point at it to open its submenu, which holds both actions:

    • 结束时提醒 — start following this session; a small bell appears on its row;
    • 试弹一次提醒 — show one sample card with this session's title, so you can check the look, the placement, and the click-to-open jump right away.
  3. While the watch is on, the parent row reads 会话提醒设置 · 开 and the child reads 已开启结束时提醒, so the state is visible at a glance.

  4. Leave the session alone. When a turn closes — the assistant's output for that turn is complete and committed — a card appears in the bottom-right corner of the primary screen:

    会话标题 此对话已结束 已完成 · 19:54 · 点击打开对话

    Click the card and it closes while DSH jumps to that conversation — the same session switch the sidebar does.

  5. Turn it off through the same submenu, or by clicking the bell on the row while it is visible.

Watching more than one session is fine: each finished turn gets its own card, and cards stack upwards instead of covering each other.

What triggers it

The Host listens for the durable turn/end event of a watched session's log and nothing else, so the card never appears mid-stream: it waits until that turn's output is complete and committed. This fires for every turn while the watch is on, including a turn that ends with an error or a stop — the accent turns amber for a stop and red for an error, while the message stays 此对话已结束.

The card

  • Borderless, always on top, bottom-right of the primary screen's working area.
  • Never takes focus, so typing continues in whatever window you are in.
  • Slides in, closes itself after 8 s, or closes immediately when clicked.
  • A click also posts the session id back to the Host, which asks the page to open that conversation; the card disappears first so the jump feels instant.
  • Follows the DSH theme, not the OS one: the page reports body[data-ds-dark-theme] to the Host, which passes -Theme dark|light explicitly. auto (read the Windows app theme) stays only as the fallback for a Host that no page ever reported to, so a dark DSH on a light Windows still matches.
  • At most four cards sit on screen at once; a fifth closes the top one early — no notification is lost, that card had already been shown, and the newest one stays visible instead of hiding behind it.

For other plugins

A plugin can watch a session on the user's behalf through the same write path the sidebar menu uses — one session-notify.json, one SSE stream, event name watched — so there is never a second source of truth.

# watch
curl -s -X POST "http://127.0.0.1:$PORT/session-notify/watch" \
  -H 'content-type: application/json' \
  -d '{"sessionId":"session-xxxx","on":true}'
# → {"ok":true,"sessionId":"session-xxxx","watching":true}

# unwatch
curl -s -X POST "http://127.0.0.1:$PORT/session-notify/watch" \
  -H 'content-type: application/json' \
  -d '{"sessionId":"session-xxxx","on":false}'
# → {"ok":true,"sessionId":"session-xxxx","watching":false}

# read the list back
curl -s "http://127.0.0.1:$PORT/session-notify"
# → {"ok":true,"watched":{"session-xxxx":{"title":"…","locale":"zh",…}}}
CaseBehaviour
on is not a boolean, sessionId missing, bad JSON400 {"ok":false,"error":…}, nothing written
Cross-origin caller403, nothing written
Not POST405
No live session for that id on this Host200 {"ok":true,"watching":false,"reason":"unknown-session"}, nothing written
Repeated on:true / on:falseunchanged result, no second write, no second event

Caller notes:

  • sessionId must belong to a session that is live on this Host (checked with ctx.sessions.get()); a closed session or one never opened answers unknown-session.
  • $PORT is DSH's web address and can change on every desktop launch.
  • The caller need not send a title: the browser half fills it in when a page is open.
  • Watching only adds the finish card; the menu toggle still belongs to the user.

Self-test

The plugin's own detail page (Settings → Plugins → Session finish notifications) carries a 自检 / Self-test section that answers "is this plugin working right now?"

CheckPasses when
Host routes (GET /session-notify)200 and the answer carries a watched object
Event stream (/session-notify/events)the first frame arrives within 2 s; skipped when the page has no EventSource
Sample card (/session-notify/test — this pops one card)the Host answers shown: true
Theme endpoint (/session-notify/theme)a bad value must be refused with 400 (a probe only; the card's real theme is untouched)
  • Nothing runs until you press 运行自检 — opening the page sends no request.
  • Each check has a 2 s budget (AbortController); a failure shows its reason and leaves the other rows alone.
  • 弹一张示例卡 shows one card immediately; 复制结果 copies the result as Markdown (- [x] label — Pass / - [ ] label — Fail: reason).

Configuration

The row in cordis.patch.yml carries the tunables:

keydefaultmeaning
enabledtrueKeep the watch list but draw no cards.
durationMs8000How long one card stays (1200–60000).
stickyfalseKeep the card until it is clicked.
powershell—Absolute path to powershell.exe when it is not in the system directory.

Adding -LogPath <file> to a manual popup.ps1 run writes one line per lifecycle step, which is the fastest way to answer "why did no card appear".

Requirements and limits

  • Windows only. The card is a PowerShell 5.1 + WinForms window. On other platforms the plugin keeps the durable watch list and the trigger, and simply draws nothing.
  • The DSH Host process must be running — the card is drawn outside the Web page, so a background or tray-resident app keeps notifying, and a fully quit app does not.
  • Drawing starts a short-lived powershell.exe (~0.5–1 s to the card being visible). Corporate script policies are bypassed for this single file with -ExecutionPolicy Bypass; endpoint protection that blocks PowerShell will block the card, and the DSH log then carries a [session-notify] warning.
  • The watch list lives in session-notify.json under the DSH home, so it survives restarts and reloads. Nothing is sent anywhere.

Files

filerole
index.jsHost: watch file, /session-notify routes, SSE, turn trigger, launcher.
client.jsBrowser: the menu entries and the row bell.
popup.ps1The card itself: geometry, theme, stacking, dismissal.
demo/preview.ps1Show the card once with sample text.
test/host.test.mjsHost routes, durability, and the trigger, with a spawn seam.
test/client.logic.test.mjsClient slots driven against the real Host over a fake fetch.
test/shot.ps1Screenshot harness for the card.
node --test test/host.test.mjs
node --test test/client.logic.test.mjs
powershell -NoProfile -ExecutionPolicy Bypass -File demo\preview.ps1

Install from GitHub

dsh plugin --profile desktop add github:879745uhjun/dsh-session-notify

Reload the Web UI page after installing.

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 purejiang

Desktop notifications for DeepSeek Harness (dsh) Web sessions: get notified when a session waits for approval or finishes, then click to jump back to it.

Manifest valid

★ 0

MIT

JavaScript

Oct 26, 2026

dsh plugin --profile web add dsh-system-notifications

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 CoCoCoDeDeDe

Desktop notifications for DSH Web sessions: browser notifications plus Windows toast when a session finishes, fails, needs an approval, or asks a question. Clicking one opens the session; browser noti

Notifications & IntegrationsSessions & MessagesManifest valid

★ 2

MIT

JavaScript

Oct 24, 2026

dsh plugin --profile web add dsh-session-notifier

by LeeRolling

Desktop notifications for turn completion, pending approval and pending questions, each with a per-situation title and the task summary it carries; silent while the client window is in front, and back

Notifications & IntegrationsManifest valid

★ 0

MIT

JavaScript

Nov 18, 2026

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

by chenvinc

任务看板卡片结算后自动通知发起会话的 DSH 插件

Notifications & IntegrationsManifest valid

★ 0

MIT

JavaScript

Oct 28, 2026

dsh plugin --profile web add dsh-task-settle-notify