DeepSeek Harness plugin

dsh-music-plugin

DeepSeek Harness music plugin. Play and control music inside DSH.

Jump to install

Source facts

Repository
syy-shark/dsh-music-plugin
Latest update
Aug 14, 2026
Category
Just for Fun
GitHub stars
3
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/syy-shark/dsh-music-plugin
Plugin: dsh-music-plugin
Author: syy-shark

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

DSH 音乐插件

<p align="center"> <img src="docs/deepseek-whale-music.png" alt="DeepSeek 鲸鱼听歌" width="360"> </p>

给 DeepSeek Harness 加一个音乐开关:Agent 能搜、播、暂停你电脑里的歌。关掉插件,声音也会停。

今天接的是本机文件夹。以后要接网易云或加播放器界面,都走这个开关,不用推倒重来。

怎么用

1. 把歌放进 ~/Music(就是 Mac「音乐」文件夹)。 2. 装一次(写进 DSH 配置,以后不用再贴路径):

npx @deepseek-ai/dsh plugin --profile web add /Users/shark/项目/DSH-music-plugin

3. 以后直接启动:

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
播放 xxxmusic_play
暂停 / 继续music_pause / music_resume
下一首music_skip
现在在播什么music_status

正在播的时候再点播,会排进队列,不会把当前这首掐掉。

出声用 Mac 自带的 afplay。电脑里有 mpv 的话会优先用它(flac 更稳)。

配置

都在 [cordis.yml](cordis.yml) 里,改完重新加载即可:

  • libraryDir:歌在哪个文件夹,默认 ~/Music
  • backendauto / afplay / mpv
  • extensions:当音乐文件的后缀

给别的插件用

别的 DSH 插件可以 inject: ['music'],然后调 ctx.music.play / pause / search。不用自己去扫文件夹、也不用管 afplay

这次没做

网易云、进度条拖拽、歌词。先做到打开网页就能看见歌、点一下能出声。