dsh-ding 🔔

DSH（DeepSeek Harness）宿主插件：对话完成时提醒你——每当 Agent 结束一轮对话（状态回到 idle，不再主动输出），播放提示音并弹出 Windows 通知，让你切到别的窗口等回复时也不会错过。

A DSH host plugin that notifies you when a conversation finishes: whenever the Agent completes a turn (back to idle, no more proactive output), it plays a sound and shows a Windows notification, so you never miss the reply while working in another window.

切换语言 / Language： 中文 · English

---

中文

主要功能

• 🔔 提示音：对话完成后播放提示音——默认使用 ding.mp3（可配置任意音频文件：mp3/wav/mid/wma/aac），找不到时回退系统"叮咚"双音
• 🪟 Windows 原生通知：弹出系统原生 Toast（含会话标题、DSH 蓝鲸图标）。首次使用时自动注册 AppUserModelID（开始菜单快捷方式），确保通知真正显示——未注册的 AUMID 会被 Windows 静默丢弃
• 🎚️ 音量可调：volume 配置项（0.0 ~ 1.0）控制提示音大小，改配置即时生效
• 🔔 Web 铃铛按钮：对话页顶栏有个铃铛——单击开关提示音、悬停拖音量滑杆（松手自动试听）、右键选择音效并可上传自己的音频文件；设置即时保存，无需改配置
• 🖱️ 通知点击直达会话：Windows 通知（toast/气泡）点击后自动打开浏览器并直达输出完成的对话（快捷方式激活 + dsh-ding:// 协议 + ?dingOpen= 参数定位会话）
• 🔕 当前会话免打扰：窗口在前台且完成的会话正是你正在查看的会话时静默；切走窗口、看别的会话、或没开对话页时照常提醒
• ⏱ 长任务运行中提醒：任务运行超 3 分钟后每 5 分钟提醒一次（只弹通知、不响铃），提醒文本含已运行时长
• ❓ 用户提问提醒：Agent 通过 ask_user_question 提问等待回答时立即提醒（文本区别于完成通知）
• 🛠 高级设置弹窗：右键菜单底部「⚙ 高级设置」打开页面内设置窗口，可改全部参数（通知开关/标题/时机毫秒/音量/自定义通知模板），自定义模板支持参数引用：{title} 会话标题、{prefix} 对话前缀、{elapsed} 耗时、{question} 问题文本
• 🌐 双语：通知正文与标题、面板文案跟随 WebUI 界面语言（中/英）
• 🎯 时机精准：以会话 turn 是否真正结束判断完成（排除回复中途的短暂空闲），完成通知带耗时
• 🧹 不误报：自动跳过子代理（subagent）的完成事件（那只是主对话的中间过程）
• ⚡ 防抖节流：默认 200ms 防抖 + 3s 全局节流，避免连发

安装方法

$DSH_HOME 默认为 ~/.dsh。

方法 A：一行命令（推荐，bundle 安装）

dsh plugin --profile web add github:CAOGGL/dsh-ding

装完重启 dsh web 生效（依赖 pnpm，npm install -g pnpm 即可）。本插件也支持 insert 行挂载（改配置即时生效），见方法 C。

方法 B：插件市场

设置 → 插件市场 → 搜索 dsh-ding → 一键安装（已收录于 awesome-dsh-plugin，市场目录每日刷新后出现）。

方法 C：手动放置（无需 pnpm）

1. 把本仓库克隆（或下载）到：$DSH_HOME/profiles/node_modules/dsh-ding/
2. 在 profile 的用户补丁 $DSH_HOME/profiles/web/cordis.patch.yml（其他 profile 同理）追加：

- insert:
    - id: dsh-ding
      name: 'dsh-ding'
      inject: ['webServer']   # 必需：声明对 webServer 的依赖，Web 铃铛 API 才能挂载
      config:
        sound: true
        balloon: true

1. 保存即生效（补丁文件是热监控的）；插件代码本身的改动需要重启服务才生效。

npm（dsh plugin --profile web add dsh-ding）：即将上线，上线后安装更快。

验证：对话完成后应听到提示音并看到通知；也可以先单独测试通知脚本：

powershell -NoProfile -ExecutionPolicy Bypass -File "$env:USERPROFILE\.dsh\profiles\node_modules\dsh-ding\notify.ps1" -Title "测试" -Text "dsh-ding 工作正常"

配置

配置项	默认值	说明
sound	true	播放提示音
soundFile	空	提示音文件路径（mp3/wav/mid/wma/aac）。留空时自动在 服务器工作目录 / 插件目录 / 用户主目录 找 ding.mp3，找不到则回退系统"叮咚"双音
volume	1.0	提示音音量（0.0 ~ 1.0，1.0 为原始音量，如 0.5 即一半音量）
balloon	true	显示 Windows 通知
title	DSH 完成	通知标题
debounceMs	200	状态防抖毫秒数
minIntervalMs	3000	两次通知的最小间隔
notifySubagents	false	是否也通知子代理完成
quietOnViewing	true	当前会话免打扰：窗口在前台（可见且有焦点）且完成的会话正是正在查看的会话时静默；切走窗口 / 看别的会话 / 没开对话页时照常提醒
runningNotify	true	长任务运行中提醒：只弹 Windows 通知、不响铃
runningFirstAfterMs	180000	运行中提醒首次延迟毫秒数（默认 3 分钟）
runningIntervalMs	300000	运行中提醒后续间隔毫秒数（默认 5 分钟）
runningTitle	DSH 运行中	运行中提醒的通知标题（v1.0.0 更新新增）
questionNotify	true	用户提问提醒：Agent 通过 ask_user_question 提问等待回答时立即提醒（文本区别于完成通知）
questionTitle	DSH 提问	提问提醒的通知标题
doneTemplate	空	自定义完成通知文本（支持 {title}/{prefix}/{elapsed}，留空用默认）
runningTemplate	空	自定义运行中提醒文本（支持 {title}/{prefix}/{elapsed}，留空用默认）
questionTemplate	空	自定义提问通知文本（支持 {title}/{prefix}/{question}，留空用默认）

完整示例：

- insert:
    - id: dsh-ding
      name: 'dsh-ding'
      config:
        sound: true
        soundFile: 'C:\codewhale\ding.mp3'
        volume: 0.8
        balloon: true
        title: 'DSH 完成'
        debounceMs: 200
        minIntervalMs: 3000
        quietOnViewing: true
        runningNotify: true
        runningFirstAfterMs: 180000
        runningIntervalMs: 300000

Web 铃铛按钮（v0.4.0+）

对话页顶栏右侧的铃铛，全部设置即时保存到 $DSH_HOME/profiles/<name>/data/dsh-ding.json（仅覆盖你动过的项，其余仍跟随 cordis.patch.yml 配置）：

操作	效果
单击铃铛	快速开关提示音
悬停铃铛	铃铛正左侧滑出音量条（行内元素带宽度动画，同行元素自动左移）；拖动松手自动试听
右键铃铛	打开通知设置面板：提示音/气泡通知开关（两个都关 = 对话完成时无任何提示）、当前会话免打扰（正在查看的会话完成时不提醒，别的会话完成/切走后照常提醒）、运行中提醒（任务运行中超 3 分钟后每 5 分钟提醒一次，仅通知）、提问提醒（Agent 提问等待回答时立即提醒），下方可选音效（内置叮咚 / 已上传的音频）或上传新音效（mp3/wav/mid/wma/aac/m4a/ogg/flac，存到 data/sounds/）；面板底部 ⚙ 高级设置 进入全部参数编辑（通知开关/标题/时机毫秒/音量，即时保存）

卸载

1. 从 cordis.patch.yml 删掉 dsh-ding 那一整块
2. 删除 $DSH_HOME/profiles/node_modules/dsh-ding/ 目录

更新日志

• v1.0.0（2026-08-15，08-16 更新）：提醒体系完整版——① 当前会话免打扰（默认开）：窗口在前台且完成的会话正是你正在查看的会话时静默；切走窗口、看别的会话、或没开对话页时照常提醒（浏览器上报前台状态与当前会话，新增 POST /dsh-ding/presence）；② 完成通知带耗时：通知文本显示"用时 X 分 Y 秒"（宿主自动记录任务开始时间）；③ 长任务运行中提醒（默认开）：任务运行超 3 分钟后首次提醒、之后每 5 分钟一次，只弹通知不响铃（尊重"完成前不打扰"），提醒文本含已运行时长；④ 点击通知跳转会话：点击 Windows 通知自动打开浏览器直达对应对话（快捷方式激活 + dsh-ding:// 协议 + ?dingOpen= 深链，新增 toast-activate.ps1）；⑤ 用户提问提醒（默认开）：Agent 通过 ask_user_question 提问等待回答时立即提醒；⑥ 高级设置弹窗：右键菜单「⚙ 高级设置」打开页面内设置窗口（遮罩 + 居中面板），全部参数运行时编辑（通知开关/标题/时机毫秒/音量/子代理完成通知）；⑦ 自定义通知模板：完成与提问通知文本可自定义，支持 {title}/{prefix}/{elapsed}/{question} 参数引用；⑧ 双语通知：通知正文与标题跟随 WebUI 界面语言（DSH 完成/DSH Done、DSH 提问/DSH Question、DSH 运行中/DSH Running），内置音效名跟随语言；⑨ 完成判定修复：以 turn 真正结束 + 相位过滤判断完成，修复回复中途误通知与完成不通知的问题。（2026-08-16 更新）：⑩ 运行中提醒独立标题——运行中通知标题由「DSH 完成」改为「DSH 运行中」，并新增 runningTitle 配置项与高级设置「运行中通知标题」输入框；⑪ 运行中通知模板——新增 runningTemplate 配置项与高级设置「运行中通知模板」编辑框（支持 {title}/{prefix}/{elapsed}）；⑫ 标题框语言化——高级设置中的标题输入框在未自定义时随 WebUI 语言显示对应默认标题（中文界面 DSH 完成/DSH 运行中/DSH 提问，英文界面 DSH Done/DSH Running/DSH Question）。新增配置项：quietOnViewing / runningNotify / runningFirstAfterMs / runningIntervalMs / questionNotify / questionTitle / runningTitle / doneTemplate / runningTemplate / questionTemplate，全部参数可在高级设置窗口运行时修改
• v0.4.3（2026-08-14）：滑杆旋钮改为亮色黑球 / 暗色白球（跟随 WebUI 主题实时切换）；移除音量条标题行；菜单文案改为跟随 WebUI 语言设置（ctx.locale，切换语言即时生效，不再是页面 lang）
• v0.4.2（2026-08-14）：滑杆与右键菜单改用 WebUI 设计令牌（--dsw-alias-*）——自定义滑杆：4px 圆角轨道 + 品牌色填充 + 主题化旋钮（悬停/按压放大）；菜单表面/边框/阴影/文字/悬停/选中色全部对齐 WebUI 弹层样式（--dsw-specific-menu / --dsw-shadow-lv3），自动适配明暗主题
• v0.4.1（2026-08-14）：铃铛交互改版——音量条移至铃铛正左侧（行内宽度动画、同行元素自动左移）；右键设置面板新增提示音/气泡通知开关（全关 = 无任何提示）；弹层增加过渡动画；修复悬停时菜单被误关的问题
• v0.4.0（2026-08-14）：新增 Web 铃铛按钮——对话页顶栏单击开关提示音、悬停调音量（松手试听）、右键选音效/上传自定义音频；新增 GET/POST /dsh-ding/settings、/dsh-ding/test、/dsh-ding/sounds HTTP API，设置持久化到 data/dsh-ding.json
• v0.3.1（2026-08-14）：通知图标改为 DSH 蓝鲸 logo；README 同步安装方法并新增本日志
• v0.3.0（2026-08-14）：修复原生通知不显示——自动注册 AppUserModelID（未注册的 AUMID 会被 Windows 静默丢弃）
• v0.2.0（2026-08-14）：bundle 化，支持 dsh plugin add github:CAOGGL/dsh-ding 一行安装
• v0.1.0（2026-08-14）：首版——对话完成播放提示音 + Windows 通知；支持 soundFile / volume / 防抖节流 / 跳过子代理

常见问题

• 没有声音？ 检查 soundFile 指向的文件是否存在；文件不存在会自动回退系统"叮咚"双音；两者都无声请检查系统音量/静音。
• 没有通知？ 插件首次使用时会在开始菜单注册 dsh-ding-notifier 快捷方式（AppUserModelID 注册，这是 Windows 显示 toast 的前提）。若通知仍不显示，检查 设置 → 系统 → 通知 里 dsh-ding-notifier 是否被关闭；WinRT Toast 失败时脚本会自动回退 NotifyIcon 气泡。
• 想换提示音？ 在对话页铃铛上右键即可选/传音效；也可以放一个新音频文件，改 soundFile 指向它（即时生效）。

---

English

Features

• 🔔 Sound alert: plays ding.mp3 (configurable to any audio file: mp3/wav/mid/wma/aac) when a conversation completes; falls back to the system "ding-dong" beep if the file is missing
• 🪟 Native Windows notification: shows a system toast (including the session title and the DSH whale logo). On first use the plugin registers an AppUserModelID (Start Menu shortcut) so the toast is actually displayed — toasts with an unregistered AUMID are silently dropped by Windows
• 🎚️ Adjustable volume: the volume option (0.0 ~ 1.0) controls the alert loudness; config changes apply immediately
• 🔔 Web bell button: a bell in the conversation header — click toggles the sound, hover slides a volume bar out on the left of the bell (in-flow width animation; the other items in the row shift left), right-click opens the notification settings panel: sound/toast toggles (both off = no notification at all), sound picker and upload; changes save immediately, no config editing
• 🖱️ Click the notification to jump to the conversation: clicking the Windows toast/balloon opens the browser and lands on the finished conversation (shortcut activation + dsh-ding:// protocol + ?dingOpen= deep link)
• 🔕 Quiet on current: silent while the window is focused AND the finishing session is the one you are viewing; still reminds when you switch away, view another session, or no conversation page is open
• ⏱ Long-task progress reminder: first toast after 3 minutes, then every 5 minutes (toast only, no sound), with the elapsed time in the text
• ❓ Question reminder: alerts immediately when the agent asks you via ask_user_question and waits (text differs from completion)
• 🛠 Advanced settings window: the "⚙ Advanced settings" entry in the right-click menu opens an in-page settings window with every parameter (notification toggles, titles, timing in ms, volume, custom notification templates). Templates support placeholders: {title} session title, {prefix} conversation prefix, {elapsed} elapsed time, {question} question text
• 🌐 Bilingual: notification text & title and panel copy follow the WebUI language (zh/en)
• 🎯 Precise timing: completion is judged by the turn actually ending (phase filter excludes mid-reply pauses); completion text includes the elapsed time
• 🧹 No false positives: ignores subagent completion events (they are just intermediate steps of the main conversation)
• ⚡ Debounced & throttled: 200ms debounce and 3s global rate limit by default

Installation

$DSH_HOME defaults to ~/.dsh.

Method A: one-line install (recommended, bundle)

dsh plugin --profile web add github:CAOGGL/dsh-ding

Then restart dsh web (requires pnpm — npm install -g pnpm). The plugin also supports insert-row mounting with live config reload (see Method C).

Method B: plugin market

Settings → Plugin Market → search dsh-ding → one-click install (listed in awesome-dsh-plugin; the market catalog refreshes daily).

Method C: manual placement (no pnpm needed)

1. Clone (or download) this repo to: $DSH_HOME/profiles/node_modules/dsh-ding/
2. Append to your profile's user patch file $DSH_HOME/profiles/web/cordis.patch.yml (same for other profiles):

- insert:
    - id: dsh-ding
      name: 'dsh-ding'
      inject: ['webServer']   # required: depends on the webServer service so the bell API mounts
      config:
        sound: true
        balloon: true

1. It takes effect immediately on save (the patch file is hot-watched). Changes to the plugin code itself require a service restart.

npm (dsh plugin --profile web add dsh-ding): coming soon — faster installs once published.

Verification: finish a conversation and you should hear the sound and see the notification. You can also test the notification script standalone:

powershell -NoProfile -ExecutionPolicy Bypass -File "$env:USERPROFILE\.dsh\profiles\node_modules\dsh-ding\notify.ps1" -Title "Test" -Text "dsh-ding works"

Configuration

Option	Default	Description
sound	true	Play the alert sound
soundFile	empty	Path to the sound file (mp3/wav/mid/wma/aac). When empty, the script looks for ding.mp3 in the server working directory / plugin directory / user home; falls back to the system beep if not found
volume	1.0	Alert sound volume (0.0 ~ 1.0; 1.0 = original volume, e.g. 0.5 = half volume)
balloon	true	Show the Windows notification
title	DSH 完成	Notification title
debounceMs	200	Status debounce in ms
minIntervalMs	3000	Minimum interval between two notifications
notifySubagents	false	Also notify when subagents finish
quietOnViewing	true	Quiet on current: silent while the window is focused AND the finishing session is the one you are viewing; still reminds when you switch away, view another session, or no conversation page is open
runningNotify	true	Long-task progress reminder: Windows toast only, no sound
runningFirstAfterMs	180000	First progress reminder delay in ms (default 3 min)
runningIntervalMs	300000	Progress reminder interval in ms (default 5 min)
runningTitle	DSH Running	Notification title for progress reminders (new in v1.0.0 update)
questionNotify	true	Question reminder: alerts immediately when the agent asks you something via ask_user_question and waits (text differs from completion)
questionTitle	DSH 提问	Notification title for question reminders
doneTemplate	empty	Custom completion text ({title}/{prefix}/{elapsed}; empty = default)
runningTemplate	empty	Custom progress-reminder text ({title}/{prefix}/{elapsed}; empty = default)
questionTemplate	empty	Custom question text ({title}/{prefix}/{question}; empty = default)

Full example:

- insert:
    - id: dsh-ding
      name: 'dsh-ding'
      config:
        sound: true
        soundFile: 'C:\codewhale\ding.mp3'
        volume: 0.8
        balloon: true
        title: 'DSH 完成'
        debounceMs: 200
        minIntervalMs: 3000
        quietOnViewing: true
        runningNotify: true
        runningFirstAfterMs: 180000
        runningIntervalMs: 300000

Web bell button (v0.4.0+)

The bell in the conversation header saves every change immediately to $DSH_HOME/profiles/<name>/data/dsh-ding.json (only the fields you touched; everything else still follows cordis.patch.yml):

Action	Effect
Click the bell	Quickly toggle the sound
Hover the bell	A volume bar slides out on the left of the bell (in-flow width animation; the other items in the row shift left automatically); releasing the slider previews the sound once
Right-click the bell	Notification settings panel: Sound / Toast toggles (both off = no notification when a conversation finishes), Quiet on current (skip when the session you are viewing finishes; other sessions and away-window still remind), While running (progress toast every 5 min after 3 min, toast only), While asked (alert when the agent asks you a question and waits), plus the sound picker (built-in ding / your uploaded files) and upload (mp3/wav/mid/wma/aac/m4a/ogg/flac, stored in data/sounds/); the ⚙ Advanced settings entry at the bottom opens the full parameter editor (notification toggles, titles, timing in ms, volume — saved instantly)

Uninstall

1. Remove the whole dsh-ding block from cordis.patch.yml
2. Delete the $DSH_HOME/profiles/node_modules/dsh-ding/ directory

Changelog

• v1.0.0 (2026-08-15, updated 08-16): Complete reminder system — ① Quiet on current (default on): silent while the window is focused AND the finishing session is the one you are viewing; still reminds when you switch away, view another session, or no conversation page is open (the browser reports foreground state and the current session via the new POST /dsh-ding/presence); ② Completion text with elapsed time: the notification now shows "took Xm Ys" (the host tracks when the task started); ③ Long-task progress reminder (default on): first toast after 3 minutes, then every 5 minutes — toast only, no sound (respects "no noise before the task finishes"), with the elapsed time in the text; ④ Click the notification to jump to the conversation: opens the browser and lands directly on the finished session (shortcut activation + dsh-ding:// protocol + ?dingOpen= deep link, new toast-activate.ps1); ⑤ Question reminder (default on): alerts immediately when the agent asks you via ask_user_question and waits; ⑥ Advanced settings window: the "⚙ Advanced settings" entry opens an in-page modal window (overlay + centered panel) with every parameter editable at runtime (notification toggles, titles, timing in ms, volume, subagent completion); ⑦ Custom notification templates: completion and question text are customizable with {title}/{prefix}/{elapsed}/{question} placeholders; ⑧ Bilingual notifications: text and title follow the WebUI language (DSH 完成/DSH Done, DSH 提问/DSH Question, DSH 运行中/DSH Running), built-in sound name follows too; ⑨ Completion detection fix: completion is judged by the turn actually ending plus phase filtering — fixes mid-reply false notifications and missed completion notifications. (2026-08-16 update): ⑩ Dedicated progress-reminder title — the progress toast title changed from "DSH 完成" to "DSH 运行中" and a new runningTitle config key plus an advanced-settings "Running title" input were added; ⑪ Progress-reminder template — new runningTemplate config key plus an advanced-settings "Progress template" editor ({title}/{prefix}/{elapsed}); ⑫ Localized title inputs — when a title input still holds its default value, the advanced settings show the localized default (DSH 完成/DSH 运行中/DSH 提问 in Chinese, DSH Done/DSH Running/DSH Question in English) and switch with the WebUI language. New config keys: quietOnViewing / runningNotify / runningFirstAfterMs / runningIntervalMs / questionNotify / questionTitle / runningTitle / doneTemplate / runningTemplate / questionTemplate, all editable at runtime in the advanced settings window
• v0.4.3 (2026-08-14): Slider knob is now black in light mode / white in dark mode (follows the WebUI theme live); the volume-bar title row was removed; the menu copy now follows the WebUI language setting (ctx.locale, switches instantly, no longer tied to the page lang)
• v0.4.2 (2026-08-14): Slider and right-click menu restyled with WebUI design tokens (--dsw-alias-*) — custom slider: 4px rounded track, brand-colored fill, themed knob (grows on hover/press); the menu surface/border/shadow/text/hover/active colors now match the WebUI popover style (--dsw-specific-menu / --dsw-shadow-lv3) and adapt to light/dark themes automatically
• v0.4.1 (2026-08-14): Bell interaction redesign — the volume bar moved to the left of the bell (in-flow width animation, row items shift left); the right-click panel gained Sound/Toast toggles (both off = completely silent); popups got transition animations; fixed the hover menu closing too early
• v0.4.0 (2026-08-14): Web bell button added — click the bell in the conversation header to toggle the sound, hover for a volume slider (release to preview), right-click to pick/upload sounds; new GET/POST /dsh-ding/settings, /dsh-ding/test, /dsh-ding/sounds HTTP APIs; settings persist to data/dsh-ding.json
• v0.3.1 (2026-08-14): Toast icon switched to the DSH whale logo; README install methods updated, changelog added
• v0.3.0 (2026-08-14): Fixed native notifications not showing — auto-registers an AppUserModelID (toasts with an unregistered AUMID are silently dropped by Windows)
• v0.2.0 (2026-08-14): Bundled, installable with dsh plugin add github:CAOGGL/dsh-ding
• v0.1.0 (2026-08-14): Initial release — sound + Windows notification when a conversation finishes; supports soundFile / volume / debounce & throttle / skip-subagents

FAQ

• No sound? Check that the file pointed to by soundFile exists; if it doesn't, the script falls back to the system beep. If both are silent, check your system volume/mute settings.
• No notification? On first use the plugin registers the dsh-ding-notifier Start Menu shortcut (AppUserModelID registration — required for Windows to display toasts). If notifications still don't show, check Settings → System → Notifications to make sure dsh-ding-notifier is enabled. If the WinRT toast fails, the script falls back to a NotifyIcon balloon automatically.
• Want a different sound? Right-click the bell in the web UI to pick/upload one; or drop in a new audio file and point soundFile to it (takes effect immediately).

---

License

MIT