跳到正文
  • 首页
  • 插件说明
  • dsh-music-plugin

syy-shark/dsh-music-plugin

30最近提交 2026年8月14日

dsh-music-plugin DSH 插件

该插件让 Agent 能通过自然语言控制本地音乐播放。它会扫描 ~/Music 文件夹，提供网页面板显示歌单，支持播放、暂停、队列等功能。使用 macOS 自带的 afplay 或 mpv 播放。

skills-workflowsbrowser-web

如何安装 dsh-music-plugin DSH 插件

dsh plugin --profile web add /Users/shark/项目/DSH-music-plugin

来源命令需要人工核对。复制不会执行命令。

dsh-music-plugin DSH 插件数据来源

dsh-music-plugin DSH 插件快照日期：2026年8月16日

discovered

dsh-music-plugin DSH 插件能做什么

  • 按名称或路径搜索本地音乐文件
  • 通过 Agent 指令播放指定歌曲
  • 暂停和继续当前播放
  • 跳到下一首歌曲
  • 查询当前播放状态
  • 正在播放时新点播歌曲自动排队，不打断当前曲目

dsh-music-plugin DSH 插件适合哪些场景

  • 用户说“播放某首歌”，Agent 找到并播放
  • 用户说“暂停”，Agent 暂停音乐
  • 用户说“下一首”，Agent 跳过
  • 用户问“现在在播什么”，Agent 返回状态
  • 用户想搜索本地音乐，Agent 列出匹配结果

dsh-music-plugin DSH 插件适合谁

  • 希望通过语音或文字控制本地音乐播放的 DSH 用户
  • 在 ~/Music 文件夹存放音乐的 macOS 用户
  • 喜欢通过网页面板查看和操作播放列表的用户

dsh-music-plugin DSH 插件的限制

  • 仅支持本地文件夹（默认 ~/Music），不支持网易云等流媒体服务
  • 没有进度条拖拽和歌词显示
  • 依赖 macOS 的 afplay 或 mpv，不支持 Linux/Windows
  • 早期版本，功能有限，可能存在稳定性问题

dsh-music-plugin DSH 插件的仓库 README 摘录

以下文字摘自 dsh-music-plugin DSH 插件的上游仓库 syy-shark/dsh-music-plugin 的 README，版权归原作者，仅作引用。

给 DeepSeek Harness 加一个音乐开关：Agent 能搜、播、暂停你电脑里的歌。关掉插件，声音也会停。 今天接的是本机文件夹。以后要接网易云或加播放器界面，都走这个开关，不用推倒重来。 ## 怎么用 1. 把歌放进 `~/Music`（就是 Mac「音乐」文件夹）。 2. 装一次（写进 DSH 配置，以后不用再贴路径）： ```sh npx @deepseek-ai/dsh plugin --profile web add /Users/shark/项目/DSH-music-plugin ``` 3. 以后直接启动： ```sh npx @deepseek-ai/dsh web ``` 打开 `http://127.0.0.1:3080`。右侧会出现「本地音乐」面板：能看见歌单，点播放 / 暂停 / 下一首。也可以继续跟 Agent 说「播放 xxx」，两边是同一套播放。 拔掉： ```sh 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`](cordis.yml) 里，改完重新加载即可： - `libraryDir`：歌在哪个文件夹，默认 `~/Music` - `backend`：`auto` / `afplay` / `mpv` - `extensions`：当音乐文件的后缀 ## 给别的插件用 别的 DSH 插件可以 `inject: ['music']`，然后调 `ctx.music.play / pause / search`。不用自己去扫文件夹、也不用管 `afplay`。 ## 这次没做 网易云、进度条拖拽、歌词。先做到打开网页就能看见歌、点一下能出声。

阅读完整 README仓库许可: MIT

dsh-music-plugin DSH 插件常见问题

如何安装 DSH 音乐插件？

运行命令：`npx @deepseek-ai/dsh plugin --profile web add /你克隆的插件路径`。然后启动 DSH：`npx @deepseek-ai/dsh web`，打开 http://127.0.0.1:3080 即可看到音乐面板。

可以修改音乐文件夹吗？默认是 ~/Music？

可以。编辑插件根目录下的 `cordis.yml` 文件，修改 `libraryDir` 字段为你想要的文件夹路径。保存后重新加载插件或重启 DSH 即可生效。

这个插件支持 Windows 或 Linux 吗？

目前不支持。插件依赖 macOS 自带的 `afplay` 命令。如果安装了 `mpv`，可能在其他平台也能用，但官方未做支持。README 明确只支持 Mac 和 afplay/mpv。

如何卸载插件？

运行命令：`npx @deepseek-ai/dsh plugin --profile web remove dsh-music-plugin`，即可从 DSH 配置中移除该插件。

可以用语音控制音乐吗？

插件与 DSH Agent 集成，你可以通过打字或语音说出“播放”、“暂停”、“下一首”或“搜索某首歌”，Agent 会自动调用对应的音乐功能。