前言¶

在 DSH（DeepSeek Harness）宿主环境中，等待 Agent 完成一轮对话、等待 Agent 提问回答、等待工具调用批准时，通常需要切回对话页确认状态。dsh-ding 是一个 DSH 插件：对话完成时播放提示音，并弹出 Windows 原生通知；WebUI 中的铃铛按钮可用于开关提示音、调整音量、选择音效或上传音频。

该插件由 CAOGGL 维护，许可证为 MIT。

这是什么¶

dsh-ding 用于把 DSH 对话和任务状态转成提醒。它覆盖对话完成、长任务运行中、Agent 提问、工具调用等待批准等场景。

核心功能¶

下面按已核实能力列出：

• 对话完成时播放提示音。
• 弹出 Windows 原生通知。
• Web 铃铛按钮：单击开关提示音、悬停调整音量、右键选择音效或上传音频。
• 点击 Windows 通知后自动打开浏览器并直达对应会话。
• 当前会话免打扰。
• 长任务运行中提醒。
• Agent 通过 ask_user_question 提问并等待回答时提醒。
• 工具调用等待批准时提醒。
• 高级设置弹窗中运行时修改通知开关、标题、时机毫秒、音量、自定义通知模板。
• 导入/导出 JSON 配置。
• 内置 ding.mp3 提示音文件。
• 通知正文与标题、面板文案跟随 WebUI 中/英文语言。
• 默认 200ms 防抖和 3s 全局节流。
• 自动跳过子代理完成事件。

提示音文件格式资料列明为 mp3/wav/mid/wma/aac；Web 上传音效还列明支持 m4a/ogg/flac。

安装与启用¶

命令行安装¶

如果环境尚未安装 pnpm，可先执行：

npm install -g pnpm

然后执行安装命令：

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

安装后重启 dsh web 生效。

WebUI 插件市场¶

1、进入“设置 -> 插件市场”。

2、搜索 dsh-ding。

3、点击一键安装。

手动放置¶

1、把插件目录放到：

$DSH_HOME/profiles/node_modules/dsh-ding/

2、在 cordis.patch.yml 中追加 dsh-ding 的 insert 配置。

3、保存后，补丁文件热监控即时生效；插件代码本身改动需要重启服务。

典型用法¶

铃铛按钮¶

在对话页顶栏的铃铛上：

1、单击：开关提示音。

2、悬停：调整音量。

3、右键：选择音效或上传音频。

高级设置¶

打开高级设置后，可运行时修改通知开关、标题、时机毫秒、音量、自定义通知模板。

高级设置页提供测试按钮，可分别发出完成、运行中、提问、审批通知。

测试通知脚本¶

单独测试 Windows 通知脚本时，可运行资料给出的 PowerShell 命令：

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

适用场景与注意¶

适合等待 Agent 回复、长任务运行中、Agent 提问、工具审批等场景。

注意：

• 插件以当前 dsh 进程权限运行，安装前应检查仓库源码与 MIT 许可证。
• Windows 通知首次使用时需自动注册 AppUserModelID；未注册的 AUMID 会被 Windows 静默丢弃。
• 手动放置方式中，cordis.patch.yml 补丁变更即时生效，插件代码变更需要重启服务。

链接¶

• GitHub：https://github.com/CAOGGL/dsh-ding
• WebUI 插件市场入口：设置 -> 插件市场 -> 搜索 dsh-ding