前言¶
DeepSeek Harness（DSH）支持通過插件擴展功能。對於經常在 DSH 界面中進行對話或開發的用戶，在操作過程中需要播放背景音樂或聽書，頻繁切換應用窗口會打斷心流。這個插件通過 Host 端與 Web 端的雙面結構，將音樂播放、歌詞顯示、頻譜可視化以及 AI 講書功能集成進 DSH 的 Web 界面，解決了在對話窗口內完成音頻播放的需求。
核心功能¶
該插件提供本地音頻流式播放與多種播放模式，支持刷新後斷點續播、順序播放、單曲循環與亂序播放。播放面板支持實時頻譜可視化，可在柱狀圖與波形圖之間切換。對於本地音樂，插件支持內嵌歌詞、LRC 文件及在線歌詞匹配，並具備防止電腦休眠的功能。播放面板支持自由拖動、調整大小，位置與尺寸可跨刷新記憶。
AI 講書與工具¶
插件支持本地 .txt / .epub 文件的 AI 語音朗讀，能自動識別書名、前言、章節與尾聲結構，並提供 4 種中文 AI 聲音。Agent 可通過 music_play 模型工具調用播放功能，例如輸入“播放周杰倫的歌”即可觸發播放。此外，插件還提供每日新聞播報功能，Agent 可聯網搜索今日頭條並生成口播稿，或通過 music_play 工具直接播放網絡電臺。
在線音樂與網絡電臺¶
插件支持多種音頻格式（mp3/m4a/flac/wav/ogg/webm 等），並能掃描並顯示音質檔位。面板支持自建歌單管理與收藏功能。集成方面，插件內置了在線音樂（QQ音樂、酷狗音樂、網易雲音樂）入口，支持掃碼登錄並瀏覽歌單、排行榜及搜索。同時支持網絡電臺，使用 radio-browser 全球開放電臺目錄，並支持 HLS 流播放。
安裝與啓用¶
使用前需確保已安裝 dsh CLI。
- 安裝插件：
執行以下命令安裝（將<profile>替換爲實際配置文件名）：
dsh plugin --profile <profile> add dsh-music-player
- 配置與啓動：
安裝後重啓 DSH，打開 Web GUI。點擊播放條右側的列表按鈕打開播放面板，在面板頂部點擊“選擇音樂目錄”並選定目標目錄（默認爲~/Music），插件會自動遞歸掃描。
典型用法¶
- Agent 播放：在對話框輸入“播放周杰倫的歌”，Agent 調用
music_play工具啓動播放。 - 網絡電臺：在對話框輸入“播放網絡電臺 中國之聲”，Agent 使用
music_play工具並指定source=radio。 - AI 講書：將本地
.txt或.epub文件拖入對話框，Agent 會自動識別章節並進行語音朗讀。 - 新聞播報：讓 Agent 收集今日頭條，整理篩選後用 AI 聲音播報。
技術細節與注意事項¶
插件爲 Host 端（Node.js）與 Web 端的雙面結構，配置與狀態持久化保存在 Host 端文件 ~/.dsh/music-player-prefs.json 中，包括音量、播放順序、面板位置及播放進度。升級舊版本時，舊數據會自動遷移至 Host 端。
使用聲明：
在線音樂（QQ音樂、酷狗音樂、網易雲音樂）功能通過非官方接口訪問，僅供個人學習、技術研究及日常試聽使用。嚴禁用於商業用途、公開傳播或盈利行爲。因使用非官方接口導致的賬號風控、封禁及版權糾紛由使用者自行承擔。網絡電臺數據來源於 CC 開放數據，僅供個人收聽，不錄製或二次分發。
鏈接¶
- GitHub: https://github.com/kendu76/dsh-music-player
