@deepseek-ai/dsh-client-audio-alert

English | 中文

用声音提醒会话中断、向你提问与回合完成——当会话需要你时，播放提示音提醒你回来查看，不用一直盯着界面。node 半注册 audio-alert settings 命名空间；浏览器半订阅会话列表，在三个注意力边界播放声音：审批请求（pendingInteraction 变为 approval 或 plan-review）、ask-user 提问（pendingInteraction 变为 question），以及回合结束（会话的 running 位由 true 翻转为 false）。

声音可通过 audio-alert settings 命名空间逐触发配置（设置 → 插件配置，或 settings.yaml 文档）。每个字段都可选：enabled（默认 true）、volume（默认 0.8，区间 [0, 1]）、approvalSound / questionSound / doneSound，以及 debug（默认 false）。声音字段接受 data URI、http(s)/blob URL、根相对 URL（以 / 开头）或本地文件路径。空字段选择该触发内置的合成音。debug: true 会把解析后的配置与每次播放记录到浏览器控制台与服务端日志。

本地路径（例如 C:/sounds/alert.mp3、~/sounds/alert.mp3 或 ./alert.mp3）由 node 半在运行 dsh web 的机器上读取，并通过 /audio-alert/audio/ 提供给浏览器，因此浏览器自身不接触文件系统。写路径时不要带 data: 或 file: 前缀。

安装教程

前置条件 —— 一个 dsh web 部署（DeepSeek Harness；web 配置文件在首次使用时自动创建）、Node ^22.19 || >=24 和 pnpm。插件会从配置文件自己的 node_modules 解析 @deepseek-ai/* 的 peer 依赖，无需额外安装。

安装 —— dsh plugin 会把参数转发给配置文件目录里的 pnpm：

# 从 GitHub 安装（推荐；安装时会自动构建）
dsh plugin --profile web add https://github.com/ellelkktrraaa/dsh-audio-alert.git

# 或从本地目录安装
dsh plugin --profile web add C:\path\to\dsh-audio-alert

# 卸载（按包名）
dsh plugin --profile web remove @deepseek-ai/dsh-client-audio-alert

配置 —— 在 $DSH_HOME/settings.yaml（默认 C:\Users\\.dsh\settings.yaml）里加一段 audio-alert:：

audio-alert:
  enabled: true
  volume: 0.8
  approvalSound: "C:/sounds/approval.mp3"   # 空 = 内置提示音；或填 data:/http(s) URL
  questionSound: "C:/sounds/question.mp3"
  doneSound: "C:/sounds/done.mp3"
  debug: true