dsh-notify-plus

dsh-notify-plus

English | 中文

Context-rich native notifications for DSH Desktop.

DSH Desktop's built-in notification tells you that a turn finished. It never tells you which conversation, or what the turn actually produced — so the toast is impossible to act on:

	Built-in	dsh-notify-plus
Title	用户回合已完成 / User Turn Completed	重构通知插件 — the live conversation title
Body	一个由你发起的回合已完成。 / A user-initiated turn has finished.	已经修复了通知排序，现在会优先选择最近的助手… — a distilled one-liner

This plugin replaces the built-in row and reuses its settings namespace, so the existing Desktop toggles keep working and no user preference is lost.

What it does

• Titles every toast with the live conversation title. The title comes from the log-backed session title service, so it follows renames and automatic title revisions instead of being a constant.
• Distils the turn into one actionable line. For CJK replies the body is 10–20 characters; for Latin replies it stays inside the Windows toast body envelope. Nothing is sent to a model — the distillation is deterministic, so it costs no tokens and adds no latency.
• Keeps failure reasons. A failed turn reports the actual error instead of a generic apology, and a context-exhaustion stop is labelled separately.
• Carries the job label on background job notifications, so pnpm test finishing is distinguishable from several other jobs finishing at once.
• Never fires for internal fan-out. Delegated subagent sessions and turns that no user message started are ignored, exactly like the built-in row.

Requirements

DSH Desktop	2.0.x (verified against 2.0.3)
Harness	@deepseek-ai/dsh 0.1.1-rc.x
Node	>=22.19.0 (only for development and tests)

The plugin depends on one harness-provided module, @deepseek-ai/schemastery, which DSH already mounts. You do not need to install it yourself.

Install

From the DSH Desktop Market

Search for dsh-notify-plus in the Desktop plugin market and install it. The market writes the package into the active profile's dsh.profile.bundles, which is all this plugin needs.

From the command line

dsh plugin --profile  add dsh-notify-plus

dsh plugin is a pnpm forwarder: it installs the package into the profile and reconciles dsh.profile.bundles against the installed state. A package that declares dsh.bundle.patch — this one does — joins the layer stack automatically.

From a local checkout

git clone https://github.com/hoyin-law/dsh-notify-plus.git
dsh plugin --profile  add C:\path\to\dsh-notify-plus

Then restart DSH Desktop. Confirm the row is live before assuming anything:

dsh --profile  dump-config | Select-String "dsh-notify-plus"

How the replacement works

Both rows are Cordis plugins. Rather than racing the built-in observer (which would raise two toasts per turn), this plugin ships a bundle patch that disables the built-in row and inserts its own:

- id: desktop-notifications
  disabled: true

- insert:
    - id: dsh-notify-plus
      name: dsh-notify-plus

The order matters and is what makes the override safe. DSH Desktop composes patches as:

1. each layer in dsh.profile.bundles, in order — and the launcher splices its own dsh-plugin-desktop layer in right after @deepseek-ai/dsh-web-app;
2. the active profile's cordis.patch.yml;
3. $DSH_HOME/cordis.patch.yml;
4. the launcher's computed per-install patches.

Third-party bundles come after the launcher's layer, so an id-targeted patch in this package's cordis.patch.yml wins over desktop-notifications. Patching a row that does not exist is a warning rather than an error, which is why the same patch stays inert — instead of breaking boot — on a host that is not DSH Desktop.

Settings

The plugin registers the dsh-desktop-notifications namespace with the same five keys DSH Desktop already renders, so Settings → Notifications controls this plugin unchanged:

Key	Default	Effect
enabled	true	Master switch for every notification
notifyOnTurnCompletion	true	A conversation turn finished
notifyOnTurnFailure	true	A conversation turn failed or ran out of context
notifyOnJobCompletion	true	A background job finished
notifyOnJobFailure	true	A background job failed

DSH Desktop already suppresses notifications while its window is focused, so nothing fires for work you are watching.

What the body line is

lib/summarize.js is dependency-free and deterministic. It:

1. strips fenced code, inline code, link targets, bare URLs, HTML tags, headings, list markers, blockquotes, emphasis, and control characters;
2. splits the remainder into sentences, keeping terminators attached;
3. drops a leading acknowledgement clause (好的，, Sure,) so the line starts with the work rather than the pleasantry;
4. accumulates sentences until the script's minimum is met;
5. truncates at a clause boundary inside the budget, appending ….

Budgets live in one place and are easy to argue with:

export const DEFAULT_LIMITS = Object.freeze({
  cjk: Object.freeze({ min: 10, max: 20 }),
  latin: Object.freeze({ min: 40, max: 140 }),
});

When a turn produced tool work but no prose at all, the body falls back to a tool-call count (已完成 3 项工具调用…) rather than a hollow "done".

Compatibility

This plugin reads harness internals that are not a stable public contract: desktopRuntime.notifyAttention, sessions.on("session/event"), ctx.get("sessionTitle"), and jobs.onJobDone. The wiring is pinned to DSH Desktop 2.0.3 and is verified by tests against that shape.

If a harness release changes those service shapes, the plugin fails loud at boot rather than silently dropping notifications — desktopRuntime is a declared hard dependency, so the row waits for the Desktop shell instead of activating blind. Please open an issue with your DSH Desktop version if that happens.

Development

npm install            # only needed for the harness-provided schemastery peer
npm test               # 64 assertions across 4 suites, no harness required
npm run verify:layering   # composes the real patch layers via the dsh CLI

The test suite covers the pure layers — summarisation, copy, session projections, and the turn/job state machine — with hand-built event fixtures, so the behavioural contract is checked without launching Electron.

verify:layering is the one check that needs DSH Desktop installed. It builds a throwaway DSH_HOME, stands in for the launcher-owned layer, and asks the real dsh --dump-config to compose the tree, asserting that the built-in row ends up disabled: true, that this plugin's row follows it, and that a host without the built-in row still exits 0 with only a warning. Point it elsewhere if your installation is not in the default location:

node scripts/verify-layering.mjs --app "D:\Apps\DSH Desktop\DSH Desktop.exe"

lib/
  index.js       Cordis wiring: settings, jobs, sessions observers
  turn.js        session event -> notification payload state machine
  summarize.js   deterministic text distillation
  copy.js        localized copy for every locale
  session.js     read-only projections over DSH session values
  settings.js    the shared dsh-desktop-notifications namespace
cordis.patch.yml bundle patch: disable the built-in row, insert this one
scripts/
  verify-layering.mjs     composes the real patch layers through the dsh CLI
tools/
  asar.mjs                reads harness interfaces out of app.asar
  read-windows-toasts.mjs reads delivered toasts out of the Windows history DB

Verifying a live install

notifyAttention returns early while the DSH Desktop window is focused, and it raises an Electron Notification that leaves no application log line — so a focused test can look like a no-op. The only reliable check is the shell's own toast history:

node tools/read-windows-toasts.mjs --limit 10

A working replacement looks like this, with the cutover exactly at the restart:

2026/9/14 04:33:35  title="重构通知插件"   body="已经修复了通知排序逻辑，现在会优先…"
2026/9/14 04:23:24  title="用户回合已完成"  body="一个由你发起的回合已完成。"

One row per turn, the title is a real conversation name, the body is a truncated distillation rather than a fixed sentence, and the hard-coded row stops appearing at the restart rather than alongside the new one — which is what proves the built-in observer was disabled instead of merely joined.

License

MIT