MIT 协议、为 DeepSeek Harness 原生设计的本地 + 在线音乐播放器:本地曲库、云端歌单、歌词、缓存、元数据与播放统计共用一个侧栏播放器和一个队列。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-11-15
许可证
MIT
01它能帮你完成什么?
在 DeepSeek Harness 里直接播放硬盘上的音乐文件夹
多根目录扫描得到的本地曲库(歌曲 / 专辑 / 歌手 / 文件夹 / 喜欢 / 统计视图)、黑胶播放页、可拖拽队列,并记忆上次播放的曲目与进度
把音乐文件放在本机、希望在 DSH 侧栏里听歌而不必另开一个播放器的 DSH Web / Desktop 用户
把网易云 / QQ 音乐 / 酷狗的云端歌单和自建 Navidrome / Subsonic 曲库放进同一个播放队列
扫码登录后的云端歌单、喜欢与最近播放,Subsonic 的搜索 / 播放 / 歌词 / 封面 / 收藏,以及跨来源保留的播放队列
既听本地文件、又用流媒体账号或自建音乐服务器,不想在多个应用之间来回切换的人
不打开第三方标签工具就修好标签、封面与歌词
整曲或单字段的在线元数据匹配、封面替换、写回内嵌歌词前自动备份、重复检测,以及可按原路径恢复的插件回收站
维护大规模本地曲库、希望元数据修正和播放待在同一个窗口里的用户
02如何接入 DeepSeek Harness?
前置条件
- DSH Web / Desktop 宿主:插件需要浏览器载体播放音频,并使用宿主已配置的网络与存储
- 版本 0.27.3 或更高:0.27.2 及更早版本缺少 `package.json` 的 `./package.json` 导出,DSH 会静默把插件判定为非客户端包
- 走 npm 方式时,以 DSH profile 目录作为工作目录
安装步骤
- 01
在 DSH 的插件市场搜索 `dsh-music-panel`,或让 Agent 执行 `plugin_manager install_bundle dsh-music-panel`
- 02
另一种方式:在 DSH profile 目录下执行 `pnpm add dsh-music-panel`
- 03
安装后完整重启 DSH,不是只刷新页面
验证接入成功
- 完整重启后左侧栏出现音乐图标,点击即可打开音乐面板
- 侧栏没有图标:先确认版本是 0.27.3 或更高,再到插件市场把音乐插件关闭再开启一次
- 仍然没有图标:检查 profile 的 `cordis.patch.yml` 是否残留 `id: music` / `disabled: true` 的禁用覆盖,删除这一段后重启
回滚
- 在插件市场把音乐插件关闭后重启;插件管理器与市场两层状态不一致时,以 profile 最终应用的配置为准
- 若 `cordis.patch.yml` 中残留 `- id: music` / `disabled: true` 段,删除这一段后重启,不要删除上面的 `- insert:` 音乐插件配置
03DSH 适配与能力边界
DSH 插件包:Host 侧 `index.js` + `lib/**` 提供 `/music/*` HTTP 接口,Web 侧是由 `src/**` 构建出的单文件 `client.js`,用宿主注入的 `react` 渲染侧栏面板、输入框上方歌词条与会话内播放控制;从 DSH 插件市场安装或直接在 DSH profile 目录下 `pnpm add`,重启 DSH 后生效。
本地曲库扫描与播放
一个或多个音乐文件夹,可配置子文件夹深度→按歌曲 / 专辑 / 歌手 / 文件夹 / 喜欢 / 统计浏览的曲库,支持列表循环、单曲循环、随机、进度拖动与每首歌断点续播
在线来源与共享队列
扫码登录的网易云 / QQ 音乐 / 酷狗账号,或 Navidrome / Subsonic 的服务器地址、用户名与密码→云端歌单、喜欢与最近播放,Subsonic 的搜索 / 播放 / 歌词 / 封面 / 收藏,全部和本地文件共用同一个播放队列
登录 Cookie、token 以及 Navidrome 的 salt + token 写入本机 `~/.dsh/music/providers.json`(权限 0600)音频缓存
播放中的在线曲目→边播边写的本地音频缓存,默认上限 10 GB、LRU 淘汰,可在设置 → 缓存查看并清空
缓存与播放记录落在 `~/.dsh/music/`歌词与翻译
内嵌歌词、`.lrc` 文件或在线歌词源→逐行高亮、翻译、字号 / 粗细 / 模糊 / 对齐可调、±0.5s 偏移,写回内嵌歌词前自动备份
音量均衡与 10 段均衡器
正在播放的曲目→浏览器内置 EBU R128(BS.1770)逐曲增益(不依赖 ffmpeg),以及 10 段均衡器(Q=1.41,±12 dB),带 AutoEQ 耳机补偿曲线与 Winamp 出厂预设
元数据匹配与曲库整理
本地曲目与在线元数据源(网易云 / QQ 音乐 / iTunes / MusicBrainz)→整曲或单字段匹配,可编辑标题 / 艺术家 / 专辑 / 年份 / 音轨号 / 碟号 / 风格 / 作曲 / 作词 / 注释字段,支持封面替换、重复检测与回收站恢复
删除操作进入插件回收站,不会立即永久删除
04适合谁?何时不该用?
适合
- 把音乐文件放在本机、希望在 DSH 侧栏里听歌而不必另开一个播放器的 DSH Web / Desktop 用户
- 既听本地文件、又用流媒体账号或自建音乐服务器,不想在多个应用之间来回切换的人
- 维护大规模本地曲库、希望元数据修正和播放待在同一个窗口里的用户
不适合
- 只支持 DSH Web / Desktop 宿主。播放需要浏览器载体,没有浏览器运行时的宿主即使装上插件也无法出声。
- 在线平台走公开的非官方接口,可能失效、限流或改版;失败只在界面提示,不影响本地播放。
- 勾选「保存密码,启用完整曲库」后,密码会以明文额外写入本机 `~/.dsh/music/providers.json`,此外该文件本就保存登录 Cookie、token 与 Navidrome 的盐化 token,一旦本机账户泄露影响面会扩大。
05兼容性、维护与安全提示
- 只支持 DSH Web / Desktop 宿主。播放需要浏览器载体,没有浏览器运行时的宿主即使装上插件也无法出声。
- 在线平台走公开的非官方接口,可能失效、限流或改版;失败只在界面提示,不影响本地播放。
- 勾选「保存密码,启用完整曲库」后,密码会以明文额外写入本机 `~/.dsh/music/providers.json`,此外该文件本就保存登录 Cookie、token 与 Navidrome 的盐化 token,一旦本机账户泄露影响面会扩大。
- 「完整曲库」依赖 Navidrome 内部的 `/api/song` 接口,可能随版本变化,失效时退回随机采样;Subsonic 标准接口目前只在 Navidrome 0.64.2 上实测。
- profile 的 `cordis.patch.yml` 里残留的 `- id: music` / `disabled: true` 覆盖会让插件保持停用,即使插件管理器显示已启用;两层状态不一致时以 profile 最终应用的配置为准。
MIT · 最新发布 v0.35.0(2026-11-14T13:14:47Z)
06常见问题
怎么把它装进 DeepSeek Harness?
在 DSH 插件市场搜索 `dsh-music-panel`,或执行 `plugin_manager install_bundle dsh-music-panel`;也可以进入 DSH profile 目录执行 `pnpm add dsh-music-panel`。之后必须完整重启 DSH(不是刷新页面),左侧栏就会出现音乐图标。
需要什么样的 DSH 宿主?
只支持 DSH Web / Desktop。插件需要浏览器载体播放音频,并使用宿主已配置的网络与存储,纯服务端或无浏览器载体的宿主不支持。
装完后侧栏没有音乐图标怎么办?
先确认版本是 0.27.3 或更高:0.27.2 及更早版本缺少 `package.json` 的 `./package.json` 导出,DSH 会静默把插件判定为非客户端包,服务端工具可用但浏览器端不加载。然后完整退出并重启 DSH;再到插件市场把音乐插件关闭再开启一次;最后检查 profile 的 `cordis.patch.yml` 是否残留 `- id: music` / `disabled: true`,删除这一段后重启,不要删除上面的 `- insert:` 配置。
Cookie 和缓存的音频存在哪里?
全部逻辑在本机运行:登录 Cookie、token 与 Navidrome 的 salt + token 只写入 `~/.dsh/music/providers.json`(权限 0600),缓存与播放记录位于 `~/.dsh/music/`。客户端不向外部域名发请求,在线搜索、取链、歌词、封面都由 Host 发起并同源代理;唯一例外是主动勾选「保存密码,启用完整曲库」,此时密码会以明文额外写入同一文件。
Navidrome 的完整曲库是默认开启的吗?
不是。默认「全部歌曲」是随机采样;只有在连接表单里勾选「保存密码,启用完整曲库」才会用 Navidrome 原生分页接口浏览全库。这个视图依赖内部 `/api/song` 接口,失效时会退回随机采样,不影响搜索、播放和收藏。
07相关的 DSH 工作流
dsh-tui
作者 ccch1mneyyy
DSH's officially top-recommended TUI plugin — high performance, low overhead, cute pixel whale, smooth mouse interaction. One-command install via npm. / DSH 官方首推的 TUI 插件,高性能低占用,可爱像素鲸鱼,流畅鼠标交互,npm 一键安装
dsh-better-sidebar
作者 omdsh-dev
开放的侧边栏底座,支持三方拓展注册新侧边栏页面。内置文件渲染编辑/终端/侧边对话/Git/子代理页面 | Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, side chat, Git, and sub-agent pages.
dsh-media-desk
作者 woniuniuniu
DeepSeek Harness 自媒体工作台插件:一句话记灵感,一键生成脚本、封面、配图和分镜
dsh-drawai
作者 fourzkw
DSH 右侧栏里的可编辑画布 —— 加上让模型直接改图的两个工具
08数据与来源
**在 DeepSeek Harness 里,把本地曲库、在线音乐平台和自建音乐服务器装进同一台播放器。**
**要求:DSH Web / Desktop。** 插件需要浏览器载体播放音频,并使用宿主已配置的网络与存储。
左侧栏入口、输入框上方歌词条、会话内播放控制,跟随宿主深浅色主题与组件规范。
Host: `index.js` + `lib/**`, exposing `/music/*` HTTP routes.
客户端不向外部域名发请求:在线搜索、取链、歌词、封面均由 Host 发起并同源代理。
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-15。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
