67-68/dsh-music-alert

README 摘要

dsh-music-alert DSH 任务完成 / 模型提问播放提示音 + 按需音乐播放插件。 长任务完成时自动播放一段完成音；模型调用 ask user question 提问时自动播放一段提问音；Agent 也可通过 play music 工具主动播放。Web 设置页提供「音乐提醒」面板：上传 / 试听 / 完成播报&提问播报下拉多选 / 删除 / 启停开关。 Overview - 解决什么问题 ：DSH 长任务（构建、批量生成、耗时等待）完成后、或模型通过 ask user question 提出结构化提问时，用户往往不在屏幕前。本插件在每轮 turn 结束（ agent/status → idle ）时播放完成音，在模型提问（ session/event → tool/call name= ask user question ）时播放提问音，把用户叫回来看结果。 - 适合谁 ：本地运行 DSH（macOS / Linux）且希望有声音提醒的用户。 - 能力 ： - Host 半（ lib/index.js ）：完成播报 + 提问播报 + play music 工具 + play-music skill 引导 + musicAlert Remote 服务（音乐库读写）。 - Web 半（ lib/client.js ）：设置页「音乐提醒」tab（上传 / 列表 / 播放 / 完成播报&提问播报下拉多选 / 删除 / 启用开关），通过 dsh.client 双面声明加载。 Compatibility - 面向 DeepSeek Harness（DSH）Web profile。 - peer 依赖： @deepseek-ai/ ^0.1.0-rc.6 、 @deepseek-ai/cordis ^4.0.1 、 react ^18.2.0 。 - 平台：Host 半调用系统命令行播放器（macOS afplay ；Linux aplay / paplay / ffplay / mpg123 ）；Web 半渲染于 Web profile 设置页。 - 最后验证：本地 dsh web （当前 mainline）实测通过（自动播报 + 工具 + Web tab），验证日期见仓库最近提交。 Install / Uninstall 安装（npm，发布后）： 或从 git 安装（插件市场走的也是 git 克隆 + 质量门禁）： 若 web 不是默认 profile，需追加 --profile web 。 升级（重装到新版本）： 卸载： 卸载只会移除依赖与挂载行；音乐文件保留在 /.dsh/music/ ，不会被删除。 Quick start 1. 安装后重启 dsh web 。 2. 放任意受支持音频到 /.dsh/music/ ，然后在设置页「音乐提醒」tab 展…

分类