返回目录

dsh-music-panel

精选清单收录维护状态: 活跃

aliboder/dsh-music-panel

DeepSeek Harness 本地音乐面板,可扫描曲库、浏览封面和标签,并在侧栏播放歌曲、管理播放列表与同步歌词。

前往 GitHub项目主页
$ dsh plugin add dsh-music-panel

39

星标

2

Fork

JavaScript

语言

AGPL-3.0

许可证

2026-11-04

创建于

2026-11-20

最近推送

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 目录作为工作目录

安装步骤

  1. 01

    在 DSH 的插件市场搜索 `dsh-music-panel`,或让 Agent 执行 `plugin_manager install_bundle dsh-music-panel`

  2. 02

    另一种方式:在 DSH profile 目录下执行 `pnpm add dsh-music-panel`

  3. 03

    安装后完整重启 DSH,不是只刷新页面

验证接入成功

  • 完整重启后左侧栏出现音乐图标,点击即可打开音乐面板
  • 侧栏没有图标:先确认版本是 0.27.3 或更高,再到插件市场把音乐插件关闭再开启一次
  • 仍然没有图标:检查 profile 的 `cordis.patch.yml` 是否残留 `id: music` / `disabled: true` 的禁用覆盖,删除这一段后重启

回滚

  • 在插件市场把音乐插件关闭后重启;插件管理器与市场两层状态不一致时,以 profile 最终应用的配置为准
  • 若 `cordis.patch.yml` 中残留 `- id: music` / `disabled: true` 段,删除这一段后重启,不要删除上面的 `- insert:` 音乐插件配置

03DSH 适配与能力边界

DSH 适配原生运行时

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 最终应用的配置为准。
2026-11-042026-11-13v0.35.0

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` 接口,失效时会退回随机采样,不影响搜索、播放和收藏。

08数据与来源

  • 作者声明github.com70a370eb8e4a…

    **在 DeepSeek Harness 里,把本地曲库、在线音乐平台和自建音乐服务器装进同一台播放器。**

  • 作者声明github.com70a370eb8e4a…

    **要求:DSH Web / Desktop。** 插件需要浏览器载体播放音频,并使用宿主已配置的网络与存储。

  • 作者声明github.com70a370eb8e4a…

    左侧栏入口、输入框上方歌词条、会话内播放控制,跟随宿主深浅色主题与组件规范。

  • 作者声明github.com70a370eb8e4a…

    Host: `index.js` + `lib/**`, exposing `/music/*` HTTP routes.

  • 作者声明github.com70a370eb8e4a…

    客户端不向外部域名发请求:在线搜索、取链、歌词、封面均由 Host 发起并同源代理。

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-15。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。