前言¶
在 DeepSeek Harness（DSH）里长时间写代码或对话时，很多人会习惯性开系统播放器或浏览器标签放音乐。这类做法和会话窗口分离，搜索曲库、看歌词、切歌都要切出去；若音乐文件在本地硬盘，还要在资源管理器和 DSH 之间来回找路径。DSH 的插件模型允许在宿主界面里挂上业务能力，社区里已有面向客户端场景的扩展。dsh-music-panel 由 Aliboder 维护，归类为客户端插件，目标是把指定文件夹扫成可浏览、可播放的曲库，并在侧栏播放器中完成列表、歌词与基础整理，而不把音频上传到第三方平台。
这是什么¶
dsh-music-panel 是 DeepSeek Harness 的本地音乐面板插件：扫描你配置的音乐目录，用封面与标签展示曲目，在侧栏入口和全屏播放页中播放，支持循环、随机、队列与歌单。插件在 npm 上发布为 dsh-music-panel，当前资料中的版本号为 0.10.4，许可证为 MIT。GitHub 仓库：https://github.com/Aliboder/dsh-music-panel ；社区目录页：https://www.skillhub.cn/plugins/Aliboder/dsh-music-panel 。
与「只用系统播放器」相比，它把曲库浏览、播放控制和部分元数据维护放在 DSH 同一窗口：左侧栏音符入口、输入框上方歌词条、会话内可直接控制播放。本地文件以扫描与读标签为主，不依赖把文件上传到在线曲库；在线搜索与流媒体能力为可选补充，资料中明确说明使用非官方接口且可能失效。
曲库与播放¶
下面介绍本地曲库相关能力，均来自项目 README。
- 格式与扫描：可配置音乐文件夹及子目录深度，支持 MP3、FLAC、M4A、AAC、OGG、OPUS、WAV、AIFF、WMA、APE。
- 视图与排序：歌曲列表与封面网格；可按播放时长、次数、最近播放排序。
- 播放控制：列表循环 / 单曲循环 / 不循环、随机、上一首 / 下一首、进度拖动、音量与静音；队列面板支持拖拽排序、移除与跳播。
- 快捷键：空格播放 / 暂停；
Ctrl或⌘+←/→上一首 / 下一首；/聚焦搜索；Esc关闭播放页、队列或弹窗。 - 续播：记忆上次播放曲目与进度，单曲支持断点续播。
歌词、元数据与封面¶
歌词方面，插件读取内嵌歌词（如 MP3 ID3 USLT、FLAC Vorbis LYRICS）与同目录 .lrc 文件，来源顺序可调；播放页支持逐行高亮、翻译显示与 ±0.5s 偏移校准。输入框上方可显示歌名、频谱与当前唱词。资料中还提供在线歌词搜索：按歌名 / 艺术家选候选，预览后写入内嵌歌词，写前自动备份。
元数据与封面支持在线匹配（网易云、QQ 音乐、iTunes、MusicBrainz），可整曲或单字段匹配；可编辑标题、艺术家、专辑、年份、音轨号、风格、作词作曲等字段，并用本地或在线图片替换封面，写回时采用临时文件与原子替换策略，失败不破坏原文件。重复歌曲可按码率、采样率、文件大小保留音质最好的一首，其余移入插件回收站（路径为 <DSH_HOME>/music/trash/，可恢复）。
在线音乐与其他¶
主面板提供「在线」视图：网易云、QQ 音乐、酷狗搜索与播放；Host 取链并经同源代理流式传输，支持 Range 透传。设置中可对三平台扫码登录，登录态仅存本机；未登录可播放免费曲目。在线曲目可加载平台歌词（含翻译）。资料强调：仅流式播放，不下载、不批量抓取；接口为非官方，可能失效或被限流，离线时回退到本地标签。
其他能力包括喜欢列表、歌单（新建 / 重命名 / 增删歌曲）、播放统计（累计时长、次数、排行）、睡眠定时、播放设置（启动恢复 / 自动播放 / 断点续播），并跟随 DSH 深浅色主题。
安装与启用¶
安装后需重启 DSH，以便 Host 加载插件代码；成功时左侧栏会出现音符图标。
方式一：DSH 插件市场（README 推荐）
在插件市场中搜索 dsh-music-panel 安装，或由 Agent 执行：
plugin_manager install_bundle dsh-music-panel
方式二：npm
在 DSH profile 目录下执行：
pnpm add dsh-music-panel
典型用法¶
经过上面的安装与重启，可按 README 快速开始：
- 点击左侧栏 音乐 图标，打开音乐面板。
- 右上角 齿轮 → 音乐库，点「+ 添加文件夹」，选择本地音乐目录。
- 回到主面板，等待曲库扫描完成。
- 双击单曲播放，或使用「播放全部」。
缺歌词或封面时，可对曲目使用右键「编辑元数据」或「在线歌词」补齐；标签与封面会优先从文件内读取。
适用场景与注意¶
适合谁：已在 DSH Web 或 Desktop 宿主中工作、希望本地音乐库与对话界面同屏的用户；需要封面墙、队列、歌单与基础标签整理，且接受纯本地扫描为主、在线能力为辅助的开发者或重度 DSH 用户。
运行与权限：插件以当前 DSH 进程权限访问你添加的文件夹与写入元数据、回收站等路径。安装前应阅读仓库源码与 MIT 许可证，确认可接受其对磁盘的读写范围。
兼容与限制（README 原文要点）：
- 仅支持 DSH Web / Desktop 宿主（需要浏览器载体才能播放音频）。
- 在线元数据、歌词、流媒体依赖第三方非官方接口，可能失效；离线时自动回退本地标签。
- 删除重复项进入插件回收站，而非系统永久删除。
开发者若需二次开发：宿主 index.js 与 lib/** 暴露本地 HTTP API（/music/*）；Web 端 client.js 零构建，经 window.__ModuleLoader__ 加载。仓库提供 npm test、npm run check、npm run pack:check 等脚本。
结尾¶
dsh-music-panel 把「指定文件夹 → 可播放曲库」落在 DSH 客户端 UI 里，本地扫描与侧栏播放是主线，在线搜索与补全元数据是可选延伸。社区目录：https://www.skillhub.cn/plugins/Aliboder/dsh-music-panel ；源码与说明：https://github.com/Aliboder/dsh-music-panel 。
