DeepSeek Harness plugin

dsh-sound-notify-flayteas

DSH web plugin: play a notification chime when the agent asks the user a question (ask_user_question / plan review) or requests approval (sandbox escalation, tool approval).

Jump to install

Source facts

Repository
flayteas/dsh-sound-notify
Latest update
Aug 18, 2026
Category
Notifications & Integrations
GitHub stars
1
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/flayteas/dsh-sound-notify
Plugin: dsh-sound-notify-flayteas
Author: flayteas

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

dsh-sound-notify

DSH web 插件:个性化面板——当 agent 向你提问、发起审批申请或完成一轮任务时播放提示音(每个触发条件可单独设置音效、音量、重复次数与间隔),并可自定义主背景(背景色、背景图片、全局遮罩、侧边栏遮罩)。

安装

方式一:一条命令(推荐,需要 pnpm)

# 在下载了 dsharness-dsh-sound-notify-0.1.0.tgz 的目录里执行
dsh plugin --profile web add .\dsharness-dsh-sound-notify-0.1.0.tgz

方式二:手动安装(没有 pnpm 时)

1. 把 @dsharness/dsh-sound-notify 整个目录复制到 $DSH_HOME/profiles/node_modules/@dsharness/dsh-sound-notify 2. 在 $DSH_HOME/profiles/web/cordis.patch.yml 里追加:

- insert:
    - id: sound-notify
      name: '@dsharness/dsh-sound-notify'

安装后重启 dsh web 并刷新页面即可生效。

界面

打开 设置 → 个性化

  • 背景:背景色(色板)、背景图片(URL 或选择本地文件上传)、全局遮罩(聊天/内容区底色遮盖,越低图片越清晰、越高文字越易读)、侧边栏遮罩(降低让左侧栏显示背景图片)、恢复默认。背景色与主题(设置 → 外观)互补
  • 提示音:启用总开关 + 三个触发条件(提问 / 审批 / 任务完成)各一组:音效(上扬 / 下行 / 叮咚 / 单声 / 自定义音频 / 静音)、音量次数(1–10)、间隔(0–5000 ms),带试听按钮。选"自定义音频"后可选择本地音频文件上传

改动自动保存到 $DSH_HOME/settings.yaml,实时生效,无需刷新。本地文件经 /plugins/sound-notify/upload 上传,存于 $DSH_HOME/sound-notify/,设置中只保存返回的 URL。

实现

  • host 半lib/index.js):注册 sound-notify 设置 namespace(声明 inject: ["settings", "webServer"],等设置服务就绪;webServer 用于上传与文件路由)——/plugins/sound-notify/upload(POST 存文件)+ /plugins/sound-notify/files/*(静态服务)
  • 浏览器半lib/client.js):

- 提示音:订阅客户端会话运行时——question/requestedapproval/requested 帧变成会话的 pending 交互,任务完成表现为 running 位翻转;内置音效用 Web Audio 在音频时钟上一次性调度整个序列(免疫后台标签页定时器节流)+ 500ms 起播余量防卡音;自定义音频用 <audio> 播放 - 背景:背景色/遮罩通过 ctx.theme.overrideTokens 覆盖主题令牌(--dsw-alias-bg-base--dsw-specific-sidebar-fill,转 rgba 实现全局/侧边栏遮罩);背景图片注入固定 body::before 层(cover 铺满),框架背景转透明后图片透出 - 本地文件:<input type="file"> 选择后 fetch POST 到上传路由,返回 URL 写入设置