syy-shark/dsh-music-plugin

Name: syy-shark/dsh-music-plugin
Author: syy-shark

Plugin插件 Native原生 ⭐ 3 MIT Sessions & Context会话与上下文

DeepSeek 音乐插件（dsh-plugin）

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

DSH Music Plugin is a local-music switch for DeepSeek Harness that lets the agent search, play, and pause songs on your computer. It reads from ~/Music by default and exposes five tools: music_search, music_play, music_pause, music_skip, and music_status. New tracks are queued without interrupting the current one. Install once via the DSH CLI, then access the panel at http://127.0.0.1:3080; other DSH plugins can use inject: ['music'] to call ctx.music.play/pause/search. It prefers mpv and falls back to afplay. Caveat: local files only, no streaming, seek bar, or lyrics.

DSH 音乐插件是 DeepSeek Harness 的本地音乐开关，让 Agent 能搜、播、暂停你电脑里的歌。默认读取 ~/Music 文件夹，调用 music_search、music_play、music_pause、music_skip、music_status 五个工具控制播放，点播会进队列而不打断当前曲目。使用时把歌曲放入音乐文件夹，启用插件即可；其他插件可通过 inject: ['music'] 调用。播放后端优先 mpv，没有则用 afplay，仅支持本地文件，不含网易云、进度条和歌词。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我了解并安装插件：【dsh-music-plugin】【https://github.com/syy-shark/dsh-music-plugin】

Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装

dsh plugin --profile web add github:syy-shark/dsh-music-plugin

把 syy-shark/dsh-music-plugin 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

2.1 KB · 缓存于 2026-08-23 03:42:23 · 2.1 KB

DSH 音乐插件

DeepSeek 鲸鱼听歌

给 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：歌在哪个文件夹，默认 ~/Music
backend：auto / afplay / mpv
extensions：当音乐文件的后缀

给别的插件用

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

这次没做

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

渲染基于仓库 syy-shark/dsh-music-plugin 的 README.md。在 GitHub 查看原文 →

CLI Install命令行安装 Copy Install复制安装命令