dsh-music-alert
Completion sound + on-demand music playback for DSH agents (Host afplay/aplay/ffplay/mpg123, Web settings tab)
AI 분석
核心用途是实现任务完成或模型提问时的音频播报。适合需要声音反馈的挂机任务用户，或希望智能体能主动调用工具播放音乐的用户。
설치
검증된 bundle이 없거나 호환성 검사에 실패했습니다. 먼저 저장소 설명을 읽어 주세요. 전체 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。