@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 Analysis
核心用途是在 Agent 结束运行或需要人工审批时播放声音。适合挂机运行长任务、需要声音提醒及时介入的 DSH 用户。
Install
This plugin has no verified bundle, or compatibility checks failed. Read the repository notes first. Read the full README ↗
README
Read the full 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). |