@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 plugin --profile web add link:/abs/path/to/dsh-sound-alert
# 或把包放到 profile bundles 后重启 dsh web

安装后重启 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 顶部/末尾加：

dsh-sound-alert:
  enabled: true
  cooldownMs: 1200
  fallbackWav: ''
  reviewWav: ''
  doneWav: ''
  failedWav: ''
  manualTools: []

各 wav 留空时使用系统蜂鸣；wav 路径写本机绝对路径，支持中文/空格。

开发

npm run build        # tsc 编 host + tsdown 编 client
dev_build_plugin E:/work/DeepSeek-Harness_work/create01/dsh-sound-alert
dev_inject_plugin E:/work/DeepSeek-Harness_work/create01/dsh-sound-alert