@dsh-external/dsh-sound-notify
dsh plugin: play a sound on the host when an agent finishes its turn (running → idle) or waits for approval; configurable via the Plugins settings card
AI 분석
核心用途是在 Agent 结束运行或需要人工审批时播放声音。适合挂机运行长任务、需要声音提醒及时介入的 DSH 用户。
설치
검증된 bundle이 없거나 호환성 검사에 실패했습니다. 먼저 저장소 설명을 읽어 주세요. 전체 README 읽기 ↗
配置项 / Configuration
| 字段 Field | 类型 Type | 默认 Default | 说明 Description |
|---|---|---|---|
enabled | boolean | true | 总开关；false 时任务完成与审批都不提示。Master switch. |
sound | string | "" | 音频文件绝对路径（wav/mp3/ogg…）。留空使用内置默认音效（assets/default-notify.mp3）。Absolute path to an audio file; empty = built-in default sound. |
volume | number | 1 | 音量 0..1。仅非 wav 文件生效。Volume 0..1 (non-wav only). |
onlyTopLevel | boolean | false | true 时只对顶层 agent 完成提示。Notify only for top-level agents. |
cooldownMs | number | 2000 | 防抖窗口（毫秒）。Debounce window (ms), per event type. |
notifyApproval | boolean | true | 审批等待时提示；策略为 never 时自动不响。Notify on approval requests. |
preview | number | 0 | 内部试听触发计数（UI 隐藏）。Internal preview counter (hidden). |