Plugin directory / Developer / dsh-music-plugin
dsh-music-plugin
Verified · install-tested on dsh syy-shark
What it does
DeepSeek Harness music plugin (dsh-plugin)
Works — verified, early-stage project
DeepSeek Harness music plugin (dsh-plugin) It installs cleanly and boots without issues in our testing. It's early-stage but functional.
“Verified” means our automated CI actually ran dsh plugin add in a clean profile and it booted — nothing more. Feature descriptions and version compatibility are the author’s claims. This is not a security audit and not an endorsement of third-party code.
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。
这次没做
网易云、进度条拖拽、歌词。先做到打开网页就能看见歌、点一下能出声。
Install
Install the catalog once, then DeepSeek Harness can find and install any plugin from this site automatically:
dsh plugin add dshbase-catalogThen say "install dsh-music-plugin for me" — your agent finds it in the directory and installs it. Docs: dshbase-catalog · verified packs.
This plugin is GitHub source (not published to npm) — install it straight from the repo:
Web profile:
dsh plugin --profile web add github:syy-shark/dsh-music-pluginHeadless (CLI) profile:
dsh plugin --profile headless add github:syy-shark/dsh-music-pluginTest report
Verified: L1 install + L2 load + L3 runtime from GitHub source on dsh 0.1.0-rc.6.
When to use it
Extend the agent's coding surface — give it a new tool, workflow, or integration so it handles a dev task it couldn't before.
Who it's for
Developers who want dsh to behave like a teammate on real codebases — editing, running, and verifying changes rather than just answering.
For developers — extending it
The tool/command surface is the seam: expose more of the SDK, add smarter context wiring, or tighten the loop between code changes and verification.
Share this badge
Drop this badge into your README — it links back here and updates automatically when our test status changes:
[](https://dshbase.com/plugins/dsh-music-plugin/)<a href="https://dshbase.com/plugins/dsh-music-plugin/"><img src="https://dshbase.com/badges/dsh-music-plugin.svg" alt="dshbase install-tested"></a>