前言¶
在 DSH「一切皆插件」的思路下，Agent 可以按场景接入本地工具。对开发者来说，一个具体需求是：电脑里已经有一批音乐文件，希望 Agent 不只给出播放说明，而是能搜索、播放、暂停、切歌，并在网页端查看当前播放状态。dsh-music-plugin 面向这个场景：它给 DeepSeek Harness 增加一个本地音乐开关。
这是什么¶
syy-shark/dsh-music-plugin 是 DSH 插件，package.json 中的名称为 dsh-music-plugin，当前版本为 0.1.0，许可证为 MIT，由 syy-shark 维护。
它把本机文件夹里的歌曲接到 Agent 可用接口上：Agent 可以通过工具调用找歌、播放、暂停、继续、下一首和查询状态。关闭插件后，声音也会停。
核心功能¶
下面列出已核实的插件能力：
- 找歌：Agent 可调用
music_search。 - 播放：Agent 可调用
music_play。 - 暂停 / 继续：Agent 可调用
music_pause/music_resume。 - 下一首：Agent 可调用
music_skip。 - 状态：Agent 可调用
music_status查询现在在播什么。 - 队列：播放中再点播会排进队列，不会掐掉当前播放。
- 出声：使用
afplay；电脑里有mpv时优先使用mpv，flac更稳。 - 插件复用：其他 DSH 插件可写
inject: ['music']，然后调用ctx.music.play / pause / search。
安装与启用¶
1、先把歌放进本地目录。默认 libraryDir 为 ~/Music。
2、安装插件。资料中给出的命令使用本机路径：
npx @deepseek-ai/dsh plugin --profile web add /Users/shark/项目/DSH-music-plugin
资料未提供通用仓库安装命令；如果不在同一台机器或同一目录，需要按实际本地路径处理。
3、启动 DSH Web：
npx @deepseek-ai/dsh web
4、打开：
http://127.0.0.1:3080
右侧会出现「本地音乐」面板。可以看到歌单，点播放 / 暂停 / 下一首；也可以继续跟 Agent 说「播放 xxx」。
典型用法¶
- 找歌：对 Agent 说「找一下某首歌」，对应
music_search。 - 播放：对 Agent 说「播放 xxx」，对应
music_play。 - 暂停 / 继续：对应
music_pause/music_resume。 - 下一首：对应
music_skip。 - 查询当前：对应
music_status。 - 命中多首：Agent 会列出路径，需要按准确路径再播放一次。
- 开发调试：可以用
--patch临时挂源码，不写进配置。
配置¶
配置在 cordis.yml 中，改完重新加载即可：
libraryDir：音乐文件所在文件夹，默认~/Music。backend：可设为auto/afplay/mpv。extensions：用于识别音乐文件的后缀。
移除¶
npx @deepseek-ai/dsh plugin --profile web remove dsh-music-plugin
版本与依赖¶
package.json 中的相关信息：
name:dsh-music-pluginversion:0.1.0license:MITpeerDependencies:@deepseek-ai/cordis >=4.0.0@deepseek-ai/dsh-tools *@deepseek-ai/schemastery *
适用场景与注意¶
适合需要在 DSH 里控制本机音乐的开发者：歌曲已经在本机文件夹中，需要 Agent 能直接调用播放控制，或者需要网页端看到一个简单的本地音乐面板。
当前未做：网易云、进度条拖拽、歌词。
使用注意：
- 插件会以当前
dsh进程权限运行。 - 安装前应检查源码、依赖与许可证。
- 资料中给出的安装命令是本机路径，未提供通用仓库安装命令。
- 社区目录是独立站点，不等同于官方应用商店；不要理解为与 DeepSeek 或幻方存在官方从属关系。
相关链接¶
- GitHub：https://github.com/syy-shark/dsh-music-plugin
- 目录页线索链接：https://www.skillhub.cn/plugins/syy-shark/dsh-music-plugin（来自线索，未在已抓取资料中直接出现）
