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 提问等待回答时立即提醒（文本区别于完成通知）
- 🛡️ 工具审批提醒：工具调用等待你批准（approval/request）时立即提醒，点击通知直达该会话，在 WebUI 里完成审批
- 🛠 高级设置弹窗：右键菜单底部「⚙ 高级设置」打开页面内设置窗口，可改全部参数（通知开关/标题/时机毫秒/音量/自定义通知模板），自定义模板支持参数引用：
{title} 会话标题、{prefix} 对话前缀、{elapsed} 耗时、{question} 问题文本、{tool} 工具名（审批模板）
- 💾 导入/导出配置：右键菜单底部可导出配置（下载 JSON 文件）或导入配置（从 JSON 恢复全部设置）
- ▶ 铃声试听：右键菜单铃声列表每项右侧有播放按钮，可单独试听每个铃声（不切换当前铃声）
- 🧪 通知测试按钮：高级设置页提供完成 / 运行中 / 提问 / 审批 4 个测试按钮，点击立即弹出对应类型的真实通知，点击通知打开测试结果页
- 🏷️ 通知应用名可改：高级设置可自定义通知应用名；留空时跟随 WebUI 中英文自动切换（中文：DSH叮当通知，英文：dsh-ding-notifier）
- 📦 内置 ding.mp3：提示音文件随插件包分发，不再依赖启动目录或主目录存在 ding.mp3
- 🌐 双语：通知正文与标题、面板文案跟随 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）
- 把本仓库克隆（或下载）到：
$DSH_HOME/profiles/node_modules/dsh-ding/
- 在 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
- 保存即生效（补丁文件是热监控的）；插件代码本身的改动需要重启服务才生效。
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）/ 用户主目录 找 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 |
完整示例：
- 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/）；面板底部 ⚙ 高级设置 进入全部参数编辑（通知开关/标题/时机毫秒/音量，即时保存）；底部还有 导出配置 / 导入配置（下载/恢复 JSON 配置） |
卸载
- 从
cordis.patch.yml 删掉 dsh-ding 那一整块
- 删除
$DSH_HOME/profiles/node_modules/dsh-ding/ 目录
更新日志
- v1.0.2（2026-08-21）：铃声试听——右键菜单铃声列表每项右侧新增 ▶ 播放按钮，可单独试听每个铃声（不切换当前铃声），
GET /dsh-ding/audio 支持 ?file=<id> 指定音效；配置导入/导出——右键菜单底部新增「导出配置 / 导入配置」，可把当前配置下载为 JSON 或从 JSON 恢复全部设置；内置 ding.mp3——ding.mp3 随插件包分发，notify.ps1 搜索链新增插件自身目录，不再依赖启动目录或用户主目录里存在 ding.mp3；四种通知测试按钮——高级设置页新增完成/运行中/提问/审批四个测试按钮，点击立即发出对应类型的真实通知，点击通知跳转到测试结果页，并记录本次测试使用的配置；通知应用名可改——高级设置新增「通知应用名」，留空时跟随 WebUI 中英文自动切换（中文默认：DSH叮当通知，英文默认：dsh-ding-notifier），填写后固定使用
- v1.0.1（2026-08-17）：工具审批提醒——工具调用等待你批准（
approval/request）时播放提示音并弹出 Windows 审批通知（标题与文案可自定义，支持 {tool} 工具名参数）；点击通知直达发起审批的会话，在 WebUI 里完成批准/拒绝；新增配置项 approvalNotify / approvalTitle / approvalTemplate（可在高级设置里编辑）；提示音异步播放——提示音与通知同时弹出，不再等待音效放完（修复音效尾音长时通知卡顿的问题）
- v1.0.0（2026-08-15，08-16/08-17 更新）：提醒体系完整版——① 当前会话免打扰（默认开）：窗口在前台且完成的会话正是你正在查看的会话时静默；切走窗口、看别的会话、或没开对话页时照常提醒（浏览器上报前台状态与当前会话，新增
POST /dsh-ding/presence）；② 完成通知带耗时：通知文本显示"用时 X 分 Y 秒"（宿主自动记录任务开始时间）；③ 长任务运行中提醒（默认开）：任务运行超 3 分钟后首次提醒、之后每 5 分钟一次，只弹通知不响铃（尊重"完成前不打扰"），提醒文本含已运行时长；④ 点击通知跳转会话：点击 Windows 通知自动打开浏览器直达对应对话（dsh-ding:// 协议激活 + toast-activate.ps1 + ?dingOpen= 深链）；⑤ 用户提问提醒（默认开）：Agent 通过 ask_user_question 提问等待回答时立即提醒；⑥ 高级设置弹窗：右键菜单「⚙ 高级设置」打开页面内设置窗口（遮罩 + 居中面板），全部参数运行时编辑（通知开关/标题/时机毫秒/音量/子代理完成通知）；⑦ 自定义通知模板：完成/运行中/提问通知文本可自定义，支持 {title}/{prefix}/{elapsed}/{question} 参数引用；⑧ 双语通知：通知正文与标题跟随 WebUI 界面语言（DSH 完成/DSH Done、DSH 提问/DSH Question、DSH 运行中/DSH Running），内置音效名跟随语言；⑨ 完成判定修复：以 turn 真正结束 + 相位过滤判断完成，修复回复中途误通知与完成不通知的问题。（08-16 更新）：⑩ 运行中提醒独立标题——运行中通知标题由「DSH 完成」改为「DSH 运行中」，并新增 runningTitle 配置项与高级设置「运行中通知标题」输入框；⑪ 运行中通知模板——新增 runningTemplate 配置项与高级设置「运行中通知模板」编辑框；⑫ 标题框语言化——标题输入框在未自定义时随 WebUI 语言显示对应默认标题（中文 DSH 完成/DSH 运行中/DSH 提问，英文 DSH Done/DSH Running/DSH Question）；⑬ 设置文件热重载——直接编辑 data/dsh-ding.json 保存后即时生效，无需重启。（08-17 更新）：⑭ 点击跳转修复——Windows 11 对非打包应用的 toast 点击（foreground 激活）失效，改为 activationType="protocol" 协议激活，并补全 注册标志、修复 launch 参数解析（ 中 open 被解析为 host 的情况）、浏览器端深链加自动重试；⑮ ——协议命令改用 wscript + 无窗口启动器（避免 powershell 控制台黑窗闪烁）。新增配置项： / / / / / / / / / ，全部参数可在高级设置窗口运行时修改
常见问题
- 没有声音？ 检查
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)
- 🛡️ Tool approval reminder: alerts immediately when a tool call waits for your approval (
approval/request); clicking the notification jumps to that conversation, where you approve or reject in the WebUI
- 🛠 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, {tool} tool name (approval template)
- 💾 Export/import config: at the bottom of the right-click menu you can (download a JSON file) or (restore all settings from JSON)
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)
- Clone (or download) this repo to:
$DSH_HOME/profiles/node_modules/dsh-ding/
- 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
- 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 (bundled ding.mp3) / 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 Done | 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) |
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); the bottom also has Export config / Import config (download/restore JSON settings) |
Uninstall
- Remove the whole
dsh-ding block from cordis.patch.yml
- Delete the
$DSH_HOME/profiles/node_modules/dsh-ding/ directory
Changelog
- v1.0.2 (2026-08-21): Per-sound preview — every sound item in the right-click menu now has a ▶ play button to preview that sound without switching;
GET /dsh-ding/audio supports ?file=<id>. Export/import config — new Export config / Import config entries at the bottom of the right-click menu (download/restore JSON settings). Bundled ding.mp3 — the plugin now ships its own ding.mp3; notify.ps1 searches the plugin directory, so it no longer depends on the start directory or home directory containing ding.mp3; Four notification test buttons — the advanced settings page gains four test buttons (completion/running/question/approval) that immediately send a real notification of that type; clicking the toast opens a test result page and records the configuration used for the test; Renamable notification app name — a new "Notification app name" field in advanced settings; leave it empty to follow the WebUI language automatically (zh default: DSH叮当通知, en default: dsh-ding-notifier), or enter a name to pin it
- v1.0.1 (2026-08-17): Tool approval reminder — when a tool call waits for your approval (
approval/request), the plugin plays the sound and shows an approval notification (title & text customizable, {tool} placeholder supported); clicking the notification jumps to the conversation that requested approval, where you approve or reject in the WebUI. New config keys: approvalNotify / approvalTitle / approvalTemplate (editable in Advanced settings). Async sound — the alert sound now plays in parallel with the notification instead of blocking it until the sound file finishes (fixes notification lag with long tail sounds)
- 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 + protocol + deep link, new ); ⑤ (default on): alerts immediately when the agent asks you via and waits; ⑥ : 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); ⑦ : completion and question text are customizable with /// placeholders; ⑧ : text and title follow the WebUI language (DSH 完成/DSH Done, DSH 提问/DSH Question, DSH 运行中/DSH Running), built-in sound name follows too; ⑨ : completion is judged by the turn actually ending plus phase filtering — fixes mid-reply false notifications and missed completion notifications. : ⑩ — the progress toast title changed from "DSH 完成" to "DSH 运行中" and a new config key plus an advanced-settings "Running title" input were added; ⑪ — new config key plus an advanced-settings "Progress template" editor (//); ⑫ — 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: / / / / / / / / / , all editable at runtime in the advanced settings window
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
