dsh-sound-notify

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/requested、approval/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 写入设置