DeepSeek Harness 插件

dsh-music-plugin

DeepSeek Harness music plugin. Play and control music inside DSH.(英文原文)

跳到安装方式

来源信息

GitHub 仓库
syy-shark/dsh-music-plugin
最近更新
2026年8月14日
分类
趣味扩展
GitHub stars
3
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/syy-shark/dsh-music-plugin
插件名:dsh-music-plugin
作者:syy-shark

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

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

这次没做

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