sixtysevenlf/dsh-sound-alerts

Name: sixtysevenlf/dsh-sound-alerts
Author: sixtysevenlf

插件Plugin 原生Native ⭐ 2 BSD-3-Clause cat_label.cordis-plugincat_label.cordis-plugin cat_label.deepseek-harnesscat_label.deepseek-harness

DSH Web UI 声音提示插件：需要授权/提问与任务完成时播放提示音 (Web Audio, no assets)

项目介绍Project Overview

由知微Agent(zhiwei)编辑Edited by Zhiwei Agent (zhiwei)

dsh-sound-alerts 是 DSH Web UI 的浏览器端声音提示插件，在需要授权、提问、任务完成、失败或 goal 完成时播放提示音。内置音由 Web Audio 合成，支持上传自定义音频、音量与事件开关，设置持久化于 localStorage。适用于希望在后台标签页也能听到审批或完成提醒的场景。注意首次需点击或按键解锁 AudioContext，自定义音频加载失败会静默回退内置音。

dsh-sound-alerts is a browser-side sound alert plugin for the DSH Web UI. It plays sounds on approval requests, user questions, task completion, task failure, and goal completion. Built-in sounds are synthesized with Web Audio; custom audio uploads, per-event toggles, and volume are supported and persisted in localStorage. Use it to hear approval or completion alerts even in background tabs. Note that AudioContext unlocks only after the first click or key press, and failed custom audio silently falls back to built-in sounds.

在 GitHub 查看View on GitHub

发给你的 DSH 安装Send to your DSH

请帮我了解并安装插件：【dsh-sound-alerts】【https://github.com/sixtysevenlf/dsh-sound-alerts】

把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.

或使用命令行安装（适合开发者）Or use CLI install (for developers)

命令行安装CLI Install

dsh plugin --profile web add github:sixtysevenlf/dsh-sound-alerts

把 sixtysevenlf/dsh-sound-alerts 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

2.9 KB · 缓存于 2026-08-27 05:41:40 · 2.9 KB

@dsh-external/dsh-sound-alerts

DSH Web UI 声音提示插件（browser client bundle，platform: web）。

当以下事件发生时播放提示音：

事件	默认声音	触发源
需要授权（沙箱/命令审批）	双音 ×2（急切）	会话 `pendingInteraction === 'approval'`（`approval/requested` 帧）
需要回答问题（ask_user_question）	单次双音（柔和）	会话 `pendingInteraction` 为 `question` / `plan-review`
任务/运行完成	三连胜利音	会话 `running` true→false（2.5s 复检）或后台会话 `completed` 标记
任务失败	关羽之歌（合成致敬版）	当前会话 `lastAgentError` 从无到有（`host/agent-error` 帧）
goal 完成	四音胜利收尾	当前会话 goal 投影 phase → `complete`

默认音全部由 Web Audio 合成（无音频资源）；声音在浏览器标签页中播放（含后台标签页），首次点击/按键后解锁 AudioContext。

自定义声音

设置 → 通用 → "声音提示 (Sound Alerts)"，每个事件一行：

需要授权    [上传] [试听] [清除] 自定义文件名.mp3

上传：本地音频文件（mp3/wav/ogg/m4a/flac，≤10MB），以 dataURL 存入 IndexedDB（不占 localStorage 配额，刷新/重启不丢）
试听：有自定义播自定义，无自定义播内置合成音
清除：删除自定义音频，恢复内置音
自动回退：自定义音频加载/播放失败时静默回退内置合成音

播放时音量跟随滑杆；全局 1.2s 防抖避免批量事件轰炸。

设置

总开关 + 音量滑杆 + 各事件开关/上传/试听/清除，持久化于 localStorage 键 dsh-sound-alerts:settings。

诊断

console.debug('[sound-alerts]', ...) + window.__soundAlertsLog（最近 100 条）。

结构

src/index.ts — node half：空 apply（纯 UI 插件，让行出现在 host Loader）。
src/client/index.ts — 浏览器 half：声音引擎 + sessions 监视 + 设置行 + 自定义音频。
cordis.patch.yml — bundle patch：向 Web 装配树插入名录行 sound-alerts。
dsh.bundle.patch — 使本包作为 profile bundle 层装配（dependencies + bundles）。

构建与安装

# 依赖（esbuild 构建 client；--legacy-peer-deps 跳过内部 rc 包的 peer 自动安装）
npm install --legacy-peer-deps

# 构建（node half: tsc via scripts/build.sh；client half: esbuild via scripts/build-client.mjs）
bash scripts/build.sh        # DSH_CHECKOUT 自动探测（$HOME/dsh-harness）
npm run build:client

# 注入器环境内热装配（改 profile package.json + junction + loader.create）
dev_install_package D:/DSH/plugins/dsh-sound-alerts

安装后刷新浏览器页面：启动图 window.__DSH_BOOT__ 会包含本包 client.js，声音即生效（新名录行需一次刷新，之后 HMR 管内容热更）。

渲染基于仓库 sixtysevenlf/dsh-sound-alerts 的 README.md。在 GitHub 查看原文 →

命令行安装CLI Install 复制安装命令Copy Install

READMEREADME

@dsh-external/dsh-sound-alerts

自定义声音

设置

诊断

结构

构建与安装

相关推荐Related

命令行安装CLI Install