插件目录 / Developer / dsh-music-plugin
dsh-music-plugin
已验证 · 实测可装 syy-shark
功能简介
dsh-music-plugin — DSH 插件(工具)
可用 — 实测通过,早期项目
dsh-music-plugin — DSH 插件(工具) 实测能干净安装、正常启动。早期项目,但功能可用。
「已验证」表示我们的自动化 CI 在干净 profile 里实际执行了 dsh plugin add 并启动成功——仅此而已。功能描述与版本兼容性均为作者声明。这不是安全审计,也不代表对第三方代码的背书。
README
DSH 音乐插件
给 DeepSeek Harness 加一个音乐开关:Agent 能搜、播、暂停你电脑里的歌。关掉插件,声音也会停。
今天接的是本机文件夹。以后要接网易云或加播放器界面,都走这个开关,不用推倒重来。
怎么用
- 把歌放进
~/Music(就是 Mac「音乐」文件夹)。 - 装一次(写进 DSH 配置,以后不用再贴路径):
npx @deepseek-ai/dsh plugin --profile web add /Users/shark/项目/DSH-music-plugin
- 以后直接启动:
npx @deepseek-ai/dsh web
打开 http://127.0.0.1:3080。右侧会出现「本地音乐」面板:能看见歌单,点播放 / 暂停 / 下一首。也可以继续跟 Agent 说「播放 xxx」,两边是同一套播放。
拔掉:
npx @deepseek-ai/dsh plugin --profile web remove dsh-music-plugin
开发时还可以用 --patch 临时挂源码,不写进配置。
能听到声音就算成了。找到好几首时,Agent 会列出路径,你让它按准确路径再播一次。
它能干什么
| 你说的 | Agent 会调 |
|---|---|
| 找一下某首歌 | music_search |
| 播放 xxx | music_play |
| 暂停 / 继续 | music_pause / music_resume |
| 下一首 | music_skip |
| 现在在播什么 | music_status |
正在播的时候再点播,会排进队列,不会把当前这首掐掉。
出声用 Mac 自带的 afplay。电脑里有 mpv 的话会优先用它(flac 更稳)。
配置
都在 cordis.yml 里,改完重新加载即可:
libraryDir:歌在哪个文件夹,默认~/Musicbackend:auto/afplay/mpvextensions:当音乐文件的后缀
给别的插件用
别的 DSH 插件可以 inject: ['music'],然后调 ctx.music.play / pause / search。不用自己去扫文件夹、也不用管 afplay。
这次没做
网易云、进度条拖拽、歌词。先做到打开网页就能看见歌、点一下能出声。
安装
装一次目录插件,之后本站所有插件都能让 DeepSeek Harness 自动找、自动装:
dsh plugin add dshbase-catalog 然后对 agent 说「帮我装 dsh-music-plugin」,它会在目录里找到并自动安装。文档:dshbase-catalog · 已验证场景包。
该插件是 GitHub 源码(未发 npm)——直接从仓库装:
Web profile:
dsh plugin --profile web add github:syy-shark/dsh-music-plugin Headless(CLI)profile:
dsh plugin --profile headless add github:syy-shark/dsh-music-plugin 实测报告
验证通过:从 GitHub 源码完成 L1 安装 + L2 加载 + L3 运行(dsh 0.1.0-rc.6)。
使用场景
扩展 agent 的编码能力面——给它一个新工具、工作流或集成,让它接手以前做不了的开发任务。
适合谁
想让 dsh 在真实代码库上像队友一样干活的开发者——能改、能跑、能验证,而不只是回答问题。
二次开发建议
工具/命令面就是缝:暴露更多 SDK 能力、加更聪明的上下文接线,或收紧改代码与验证之间的循环。