xcyyan520/dsh-sound-alert

README 摘要

@dsh-external/dsh-sound-alert 声音提示插件： 只要有工作需要手动选择/审查，或者任务完成/失败，就播放声音提醒 。 功能 触发场景 声音类型 agent 调用 ask user question / exit plan mode 等需要人工选择的工具 review （叮-咚） DSH 任务看板出现「待规划 / 待办」等需要手动处理的任务 review （叮-咚） 一轮会话 / 一个任务正常完成 done （轻快上行） 一轮会话 / 一个任务失败 failed （低频下行） - 会话级 ：监听 DSH 官方 session/event ，无需改动 DSH 源码。 - 任务看板级 ：浏览器半区监听任务看板 localStorage（ dsh.taskBoard.v1 ），状态变化时上报 host 播放声音。 - Web 可视化设置 ：DSH 设置页新增「声音提示」页面，可给每个场景配置 wav、上传音频文件、试听。 - 声音引擎 ：默认 Windows 系统蜂鸣；也可配置自定义 wav（支持全局 fallback 或按事件类型单独指定）。 安装 安装后 重启 dsh web 生效。 Web 设置页（推荐） 安装并重启后，打开 DSH Web → 设置 → 声音提示 ： - 启用声音提示 ：总开关 - 同事件冷却 (ms) ：防连响间隔 - 需要人工选择/审查 ：review 音效 - 任务完成 ：done 音效 - 任务失败 ：failed 音效 - 全局兜底音效 ：没单独指定时使用 - 额外“人工选择”工具 ：逗号分隔的自定义工具名 - 每个音效行都有： - 选择音频… ：从本机选 .wav 文件，自动上传到 storages/sounds/ - 试听 ：立即播放当前场景声音 - 音量滑块 ：0-100%，保存后试听和真实事件都按该音量播放 - 点 保存设置 后实时生效，并持久化到本机 storages/dsh-sound-alert.json 手动 YAML 配置（可选） Web 设置页保存后会自动写入 storages/dsh-sound-alert.json ，一般不需要手动改。若想用配置文件初始化，可以在 %USERPROFILE%\.dsh\settings.yaml 顶部/末尾加： 各 wav 留空时使用系统蜂鸣；wav 路径写本机绝对路径，支持中文/空格。 开发

分类