dsh-music-alert
为 DSH 智能体提供任务完成提示音及按需音乐播放功能的插件，支持多种本地播放器与 Web 设置页管理。 核心用途是实现任务完成或模型提问时的音频播报。适合需要声音反馈的挂机任务用户，或希望智能体能主动调用工具播放音乐的用户。
安裝
此插件尚未提供可驗證的 bundle，或相容性檢查未通過。請先閱讀倉庫說明。 閱讀完整 README ↗
說明文件
閱讀完整 README ↗Configuration
| 配置项 | 默认值 | 说明 |
|---|---|---|
musicDir | ~/.dsh/music | 音乐库目录，支持前导 ~ 展开 |
enabled | true | 是否启用声音提醒（完成音 + 提问音的总开关） |
player | 自动探测 | 播放器命令；未指定时按 afplay → ffplay → mpg123 → aplay → paplay 顺序探测 |
minGapSeconds | 0 | 两次自动播报之间的最小间隔（秒） |
运行状态持久化于 ~/.dsh/music/.state.json（enabled / events）：
{ "enabled": true, "events": { "completion": ["complete.mp3"], "question": [] } }
events.completion：完成播报使用的音乐文件名列表（触发时随机播其中一首）。events.question：提问播报使用的音乐文件名列表（触发时随机播其中一首）。- 旧版单值
defaultFile会在加载时自动迁移为events.completion = [defaultFile]。
支持音频扩展名：.mp3 .wav .m4a .ogg .flac .aac .aiff .caf。