前言¶
在 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 。
