Skip to content
  • Home
  • Plugin manual
  • dsh-notify-sound

xxxxxxxyu/dsh-notify-sound

40Last commit Aug 14, 2026

dsh-notify-sound DSH plugin

This plugin adds an audible cue when an agent finishes its turn in DSH web. It provides a settings panel under DSH Settings where you can toggle the sound, choose from 44 built-in sound effects, adjust volume, and preview any sound. The notification is delivered via WebSocket for instant feedback without polling.

ui-productivity

How to install the dsh-notify-sound DSH plugin

dsh plugin --profile web add git+https://github.com/<you>/dsh-notify-sound.git

This source command needs manual review. Copying does not run it.

dsh-notify-sound DSH plugin data source

dsh-notify-sound DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-notify-sound DSH plugin can do

  • Automatically plays a notification sound when a turn/end event is received via WebSocket
  • 44 built-in sound effects to choose from, organized in series like alert, bip-bop, nope, staplebops, and yup
  • Settings panel in DSH Settings (Settings → Notifications Sound) with on/off toggle, sound selector, volume slider (0–100%), and preview button
  • Preferences are saved instantly to the DSH settings service (namespace dsh-notify-sound) and persist across restarts
  • Sound files are bundled inside the plugin, requiring no external network access on playback

Where the dsh-notify-sound DSH plugin fits

  • Get notified when a long-running AI response completes without needing to watch the screen
  • Differentiate between multiple open DSH sessions by assigning distinct notification sounds
  • Quickly mute or adjust volume during a work session using the settings panel
  • Preview and select a pleasant sound that fits your personal preference

Who the dsh-notify-sound DSH plugin is for

  • DSH web users who want auditory feedback for AI task completion
  • Users who multitask and rely on sound cues to stay aware of agent status

dsh-notify-sound DSH plugin limitations

  • Works only with DSH web profile (dsh web); not compatible with other DSH profiles
  • Requires Node.js >= 20
  • Preferences are stored in the DSH settings service, which may not be available in offline or standalone modes
  • Only supports turn/end (reply completion) events; does not provide sounds for other events like errors or start of response

dsh-notify-sound DSH plugin: from the repository README

Quoted from the xxxxxxxyu/dsh-notify-sound README, the upstream source of the dsh-notify-sound DSH plugin. Copyright remains with the original authors.

DSH (DeepSeek Harness) web 插件：**AI 回复完毕后自动播放提示音**。 支持在 DSH 设置页中随时更换音效（内置 44 个音效）、调整音量、开关。 ## 功能 - 回合结束（agent 回复完毕）自动播放提示音，通过 WebSocket 实时推送，零轮询 - 默认音效 staplebops-01.aac - 设置页（设置 → 提示音）：开/关、音效选择、音量调节、试听 - 设置即时保存，重启后保留（存储在 DSH 设置服务，全局生效） - 音效文件内置在插件中，无需联网 ## 安装 要求：DSH web profile（dsh web），Node.js >= 20。 ```` # 从 GitHub 安装 dsh plugin --profile web add git+https://github.com/<you>/dsh-notify-sound.git # 或本地开发安装 cd C:/Users/<you>/.dsh/profiles/web pnpm add file:/path/to/dsh-notify-sound ```` 安装后确认包已加入 dsh.profile.bundles，然后**重启 dsh 服务**生效。 ## 设置 打开 DSH 设置页，左侧导航出现"提示音"： | 设置项 | 说明 | | --- | --- | | 回复完成提示音 | 开关（默认开启） | | 提示音 | 下拉选择音效（44 个），选中即生效 | | 试听 | 播放当前选中的音效 | | 音量 | 0 ~ 100% 滑块 | ## 架构 - 后端（src/index.ts）：监听会话事件中的 turn/end（回合结束）→ WebSocket 广播； 提供音效静态路由（/notify-sound/sounds/<name>.aac）与偏好 API （/notify-sound/api/sounds.list | prefs.get | prefs.update）；偏好存储在 DSH 设置服务（namespace dsh-notify-sound）。 - 前端（src/client/index.tsx）：连接通知 WebSocket，收到 turn/end 播放所选音效； 注册 DSH 设置页 settings.section 插槽。 - 所有路由经过与 /api 网关相同的浏览器信任围栏（loopback / 同源校验）。 ## 开发构建 ```` npm install npm run build # 产出 lib/index.js + lib/client.js ```` ## 音效来源 内置音效（sounds/*.aac，alert / bip-bop / nope

Read the full READMERepository license: MIT

dsh-notify-sound DSH plugin questions

How do I install dsh-notify-sound?

You need DSH web profile (dsh web) and Node.js >= 20. Run the command: `dsh plugin --profile web add git+https://github.com/<you>/dsh-notify-sound.git`. Alternatively, you can install it locally by cloning the repo and running `pnpm add file:/path/to/dsh-notify-sound` inside the profile directory. Then restart the DSH service to activate the plugin.

How do I change the notification sound?

Open DSH Settings, you will see a new section called 'Notifications Sound' (or '提示音') in the left navigation. Under that section, you can select a different sound from the dropdown list of 44 built-in sounds. The sound will take effect immediately after selection. You can also preview it with the 'Preview' button.

Can I turn off the notification sound completely?

Yes, in the DSH Settings → Notifications Sound section, there is an on/off toggle for 'Reply completion sound'. Set it to off to disable the sound. The setting is saved immediately and persists across restarts.

Does the plugin support custom sound files?

According to the documentation, the plugin includes 44 built-in sound effects, but there is no mention of a way to add custom sounds. The sound files are bundled inside the plugin, so custom sounds are not supported out of the box.

Will the notification sound work on other DSH profiles like desktop or mobile?

No, this plugin is specifically designed for the DSH web profile (dsh web). It integrates with the web settings panel and WebSocket, which are not available in other profiles. You must be using the web profile to use this plugin.