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 通知：同时弹出系统原生通知（优先 WinRT Toast，失败自动回退经典气泡通知），会显示会话标题
• 🎯 时机精准：订阅宿主事件 agent/status，状态从 running 变为 idle 时触发——这正是"整轮对话彻底结束、不会再主动输出"的时刻
• 🧹 不误报：自动跳过子代理（subagent）的完成事件（那只是主对话的中间过程）；跳过 inbox 仍有待处理消息的空闲（马上会继续）
• ⚡ 防抖节流：默认 800ms 防抖 + 3s 全局节流，避免连发
• ♻️ 热生效：配置文件（cordis.patch.yml）改动即时生效，无需重启服务

安装方法

$DSH_HOME 默认为 ~/.dsh。

方法 A：手动放置（最简单）

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'
      config:
        sound: true
        balloon: true

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

方法 B：pnpm 安装

dsh plugin --profile web add git+https://github.com/CAOGGL/dsh-ding.git

然后在 cordis.patch.yml 里注册上面的 insert 行。

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

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	800	状态防抖毫秒数
minIntervalMs	3000	两次通知的最小间隔
notifySubagents	false	是否也通知子代理完成

完整示例：

- insert:
    - id: dsh-ding
      name: 'dsh-ding'
      config:
        sound: true
        soundFile: 'C:\codewhale\ding.mp3'
        volume: 0.8
        balloon: true
        title: 'DSH 完成'
        debounceMs: 800
        minIntervalMs: 3000

卸载

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

常见问题

• 没有声音？ 检查 soundFile 指向的文件是否存在；文件不存在会自动回退系统"叮咚"双音；两者都无声请检查系统音量/静音。
• 没有通知？ 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
• 🪟 Windows notification: shows a native notification (WinRT Toast first, classic balloon as fallback), including the session title
• 🎯 Precise timing: subscribes to the host agent/status event and fires when the status transitions from running to idle — exactly the moment the turn is fully done with no more proactive output
• 🧹 No false positives: ignores subagent completion events (they are just intermediate steps of the main conversation) and idle states with pending inbox messages (the agent is about to continue)
• ⚡ Debounced & throttled: 800ms debounce and 3s global rate limit by default
• ♻️ Hot reload: config changes in cordis.patch.yml take effect immediately without restarting the service

Installation

$DSH_HOME defaults to ~/.dsh.

Method A: manual placement (simplest)

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'
      config:
        sound: true
        balloon: true

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

Method B: pnpm

dsh plugin --profile web add git+https://github.com/CAOGGL/dsh-ding.git

Then register the insert block above in cordis.patch.yml.

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	800	Status debounce in ms
minIntervalMs	3000	Minimum interval between two notifications
notifySubagents	false	Also notify when subagents finish

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: 800
        minIntervalMs: 3000

Uninstall

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

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? WinRT Toast failures automatically fall back to the NotifyIcon balloon. If both fail, check Settings → System → Notifications.
• Want a different sound? Drop in a new audio file and point soundFile to it (takes effect immediately).

---

License

MIT