flayteas/dsh-sound-notify

README 摘要

dsh-sound-notify DSH web 插件：个性化面板——当 agent 向你提问、发起审批申请或完成一轮任务时播放提示音（每个触发条件可单独设置音效、音量、重复次数与间隔），并可自定义主背景（背景色、背景图片、全局遮罩、侧边栏遮罩）。 安装 方式一：一条命令（推荐，需要 pnpm） 方式二：手动安装（没有 pnpm 时） 1. 把 @dsharness/dsh-sound-notify 整个目录复制到 $DSH HOME/profiles/node modules/@dsharness/dsh-sound-notify 2. 在 $DSH HOME/profiles/web/cordis.patch.yml 里追加： 安装后 重启 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 起播余量 防卡音；自定义音频用 播放 - 背景：背景色/遮罩通过 ctx.theme.overrideTokens 覆盖主题令牌（ --ds…

分类