dsh-plugin-task-notify

Long-task audio reminder for DeepSeek Harness — a short "beep" when a sub-agent finishes, a clear "ding" when the whole turn is done and you should come back. Pure browser-side; works with any AI provider.

DSH（DeepSeek Harness）长任务完成提醒：你发出消息不响；子任务（子代理）完成响一声"嘟"；整轮任务跑完、该回来操作了，响一声"叮"（附带可选标题闪动 / TTS 播报）。纯浏览器端做提醒，和你用哪家 AI 模型无关。

Features / 特性

• Beep on sub-task / 嘟（子任务完成）: listens for sub-agent tool calls (subagent, subagent_fork, etc.) settling; plays a short beep per completion, with an automatic merge window for rapid consecutive ones.
• Ding on turn end / 叮（整轮完成）: starts a timer when the turn begins; if the turn runs past a configurable threshold (default 5 min), plays a rising two-tone ding when the agent returns idle — the signal to come back. Short turns stay silent.
• Multi-session / 多会话全局: monitors all sessions by default; configurable to current session only.
• Self-contained audio / 声音自包含: Web Audio API synthesis, no external assets; optional TTS via speechSynthesis (off by default) with customizable template — use {time} as a placeholder for the actual duration.
• Two-half structure / 两个半结构: Host half registers the settings namespace; Client half runs the browser reminder.

Install / 安装

From the plugin market / 从插件市场安装

dsh plugin add dsh-plugin-task-notify

Restart dsh web and the settings card appears under Settings → Plugins.

Manual install / 手动安装

1. Build (or use the pre-built lib/ artifacts):

   pnpm install && pnpm build
   

   The lib/ directory ships pre-built; only rebuild after modifying src/.

2. Copy the whole package into the DSH profile:

   <dsh-home>/profiles/web/node_modules/dsh-plugin-task-notify/
   

3. Add a cordis.patch.yml entry to the profile (the inject: [settings] line is required):

   - insert:
       - id: task-notify
         name: dsh-plugin-task-notify
         inject: [settings]
         config:
           enabled: true
           thresholdMinutes: 5
   

4. Restart DSH. The settings card appears under Settings → Plugins.

⚠️ The inject: [settings] line is critical. Without it the cordis loader never waits for the settings service, so the host half's apply() runs but the namespace never registers — and the settings card silently does not appear. See Troubleshooting below.

Configuration / 配置项

Field	Meaning	Default
enabled	Master switch	true
thresholdMinutes	Turn-end ding threshold (minutes)	5
subReminderEnabled	Sub-task beep switch	true
mergeMs	Consecutive sub-task merge window (ms)	500
masterVolume	Ding volume, 0..1	0.6
subVolume	Beep volume, 0..1	0.5
ttsEnabled	TTS readout (default off)	false
ttsTemplate	TTS template, {time} = actual duration	任务完成，用时约 {time} 分钟
titleFlash	Title-bar flash on turn end	true
globalSessions	Monitor all sessions	true
batchSingleBeep	Single beep per turn for all sub-tasks	false

Sound trigger rules / 声音触发规则

• You send a message: silent.
• Sub-task completes: a sub-agent-family tool call disappears from runningCalls → short beep. Merge window deduplicates rapid completions; batchSingleBeep makes one beep per whole turn.
• Turn ends: session goes from running to idle AND the timer ≥ threshold → rising two-tone ding + optional title flash + optional TTS using your custom template (with {time} replaced by actual duration).

Browser notes / 浏览器注意

• Needs one user gesture (click/keypress) before audio plays — click the page or send a message first.
• TTS may be throttled in background tabs; Web Audio beeps/dings are unaffected.
• Stops when the page closes; DSH host keeps running but sound needs the browser open.

Compatibility / 兼容性

• Targets DSH 0.1.0-rc.8 client contract (same baseline as dsh-plugin-agent-workflow).
• Uses only public session snapshots (sessions.list, running, runningCalls) and standard settings slots.
• Settings card staleness fix (0.2.1, 2026-09): the card now receives the live bound settings scope and subscribes to it, so saved values render immediately (the slot renderer caches a one-shot inject() snapshot forever).
• DSH 0.1.2-rc.1 snapshot-shape fix (2026-09): the client notifier previously read snap.runningCalls / snap.turnTimings as flat fields, but on 0.1.2-rc.1 SessionSnapshot only exposes running (running-call tree / turn timings moved into the chat view views.get('chat')?.legacy). Reading the flat field threw TypeError: items is not iterable inside walk → every SessionTracker.adopt() died → trackers= 0 and the whole notifier was silent, with the error repeating on every sync. Fix: added runningCallsOf() / turnTimingsOf() adapters that read views.get('chat')?.legacy?.runningCalls first, fall back to the flat field, and degrade to empty on absence; walk now guards Array.isArray. On 0.1.2-rc.1 the turn-end "叮" works (it only needs running); the sub-agent "嘟" is a silent no-op there because the running-call tree is not reachable through sessions without the chat-view service.

Troubleshooting / 排坑

Card shows stale values right after Save (controls look like they "did not work" even though the settings file actually updated):

The DSH slot renderer caches each slot entry's inject() result per registration (dsh-client-ui-renderer cachedRootInject, a WeakMap keyed by the entry). The settings card therefore receives whatever the inject closure returned on first render, forever. The 0.2.0 card was injected a one-shot value snapshot, so after Save (which writes via the live scope.set) the card fell back to the frozen snapshot and displayed the pre-save state. Fix (0.2.1): the inject closure hands the card the live bound settings scope instead of a snapshot; the card subscribes to it (scope.subscribe + scope.getSnapshot().value) and re-reads after every settled write, so Save updates the card without a reload.

Settings card does not appear even though the plugin shows as mounted and active in the plugin list:

The cordis loader reads inject from the patch line only, not from the plugin module's export const inject. If the patch line omits inject: [settings], the host half's apply() runs but any async delay (like installSettingsSection) never fires — the settings namespace is never registered, and the card never appears. Fix: add inject: [settings] to the patch line and use synchronous ctx.settings.register() in apply().

License

MIT © DearMrChai