xxxxxxxyu/dsh-notify-sound

Plugin插件 Native原生 ⭐ 3 MIT Notifications & Remote通知与远程

DSH(DeepSeek Harness)网页插件:当智能体回复完毕(回合/结束)时播放声音。声音、音量及开关可在设置中配置。

Project Overview项目介绍

This is a native plugin built exclusively for the DSH web profile. Its core function is to automatically play a notification sound after an AI completes a full reply. It requires Node.js 20 or newer to install and run properly. Users can install it directly from a GitHub repository via the DSH CLI command dsh plugin --profile web add git+https://github.com/<you>/dsh-notify-sound.git, or install it locally for development by adding it to the DSH web profile via pnpm. After installation, you must add the package to dsh.profile.bundles and restart the DSH service for the plugin to take effect.

Once activated, the plugin will add a new "Notification Sound" section to the DSH settings page. It is especially useful for users who often step away from their screens while waiting for long AI replies. Users can toggle the feature on or off, select from 44 built-in sound options, adjust the playback volume, and even test the selected sound before saving. The plugin listens for turn-end events via WebSocket, so it does not rely on constant polling and has minimal impact on DSH performance. All custom settings are saved to the DSH settings service, so they persist even after you restart the DSH service.

The plugin is split into two core parts: a backend that listens for turn-end session events and broadcasts them via WebSocket, and a frontend that connects to the WebSocket and plays the selected sound when it receives the signal. All sound files are bundled directly with the plugin, so no internet connection is required to play the notification after installation is complete. The built-in sounds are sourced from the open-source Stephanvs/opencode-sfx project, which is licensed under MIT, and copyright for the sounds belongs to the original project authors. The plugin code itself is also released under the open-source MIT license.

这是专为 DeepSeek Harness(DSH)网页版开发的原生插件,核心功能是在 AI 完成每一轮回复后自动播放提示音,提醒用户回复已结束。插件内置 44 种不同风格的提示音效,支持直接在 DSH 的设置页面自定义切换音效、调整音量大小和开关功能。所有音效都内置在插件包中,不需要额外联网下载,使用起来十分方便。

适合经常需要等待 AI 生成长文本回复,不能时刻盯着屏幕的用户使用。使用时,插件通过 WebSocket 实时监听回合结束事件,没有轮询消耗,对 DSH 整体性能影响极小。安装配置完成后,所有设置会自动保存在 DSH 的设置服务中,全局生效,重启 DSH 服务后也不会丢失自定义配置。

本插件要求运行在 DSH 网页版配置环境,需要 Node.js 版本不低于 20。插件代码采用 MIT 许可开源,内置音效来自 opencode-sfx 项目,版权归原作者所有,同样遵循 MIT 许可。安装后需要将插件加入 dsh.profile.bundles 并重启 DSH 服务才能生效。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:xxxxxxxyu/dsh-notify-sound

把 xxxxxxxyu/dsh-notify-sound 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-notify-sound

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/.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 / staplebops / yup 系列)来自 Stephanvs/opencode-sfx,MIT 许可, 版权归其作者所有,详见 sounds/LICENSE。

许可

MIT License —— 插件代码见 LICENSE;音效版权归 opencode-sfx 作者。

← 上一个 Prev dsh-file-uploads 下一个 Next dsh-splash-launcher →