MIT 授權、為 DeepSeek Harness 原生設計的本機+線上音樂播放器:本機曲庫、雲端播放清單、歌詞、快取、中繼資料與播放統計共用一個側邊欄播放器和一個佇列。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-11-15
授權條款
MIT
01它能幫你完成什麼?
在 DeepSeek Harness 裡直接播放硬碟上的音樂資料夾
多根目錄掃描得到的本機曲庫(歌曲 / 專輯 / 演出者 / 資料夾 / 收藏 / 統計檢視)、黑膠播放頁、可拖曳的佇列,並記住上次播放的曲目與進度
把音樂檔案放在本機、希望在 DSH 側邊欄聽歌而不必另開播放器的 DSH Web / Desktop 使用者
把 NetEase Cloud Music / QQ Music / KuGou 的雲端播放清單和自架 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 介面,瀏覽器端是由 `src/**` 建置出的單一檔案 `client.js`,以宿主注入的 `react` 繪製側邊欄面板、輸入框上方的歌詞列與工作階段內播放控制;從 DSH 外掛市集安裝,或在 DSH profile 目錄執行 `pnpm add`,重新啟動 DSH 後生效。
本機曲庫掃描與播放
一個或多個音樂資料夾,可設定子資料夾深度→依歌曲 / 專輯 / 演出者 / 資料夾 / 收藏 / 統計瀏覽的曲庫,支援清單循環、單曲循環、隨機、拖曳進度與每首歌續播
線上來源與共用佇列
掃碼登入的 NetEase / QQ Music / KuGou 帳號,或 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 原廠預設
中繼資料比對與曲庫整理
本機曲目與線上中繼資料來源(NetEase / QQ Music / iTunes / MusicBrainz)→整曲或單一欄位比對,可編輯標題 / 演出者 / 專輯 / 年份 / 曲目與碟片編號 / 曲風 / 作曲 / 作詞 / 註解欄位,支援封面替換、重複偵測與資源回收筒復原
刪除操作會進入外掛資源回收筒,不會立即永久刪除
04適合誰?何時不該用?
適合
- 把音樂檔案放在本機、希望在 DSH 側邊欄聽歌而不必另開播放器的 DSH Web / Desktop 使用者
- 同時使用本機檔案與串流帳號或自架音樂伺服器、不想在應用程式之間來回切換的人
- 維護大型本機曲庫、希望中繼資料修正與播放待在同一個視窗的使用者
不適合
- 僅支援 DSH Web / Desktop 宿主。播放需要瀏覽器載體,沒有瀏覽器執行環境的宿主即使裝好外掛也無法出聲。
- 線上平台使用公開的非官方介面,可能失效、限流或改版;失敗只在介面提示,不影響本機播放。
- 勾選「Save password, enable complete library」後,密碼會以明文額外寫入本機 `~/.dsh/music/providers.json`;該檔案原本就存放登入 Cookie、token 與 Navidrome 的加鹽 token,因此本機帳號外洩時的影響範圍會擴大。
05相容性、維護與安全提醒
- 僅支援 DSH Web / Desktop 宿主。播放需要瀏覽器載體,沒有瀏覽器執行環境的宿主即使裝好外掛也無法出聲。
- 線上平台使用公開的非官方介面,可能失效、限流或改版;失敗只在介面提示,不影響本機播放。
- 勾選「Save password, enable complete library」後,密碼會以明文額外寫入本機 `~/.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 發起並經同源代理;唯一例外是主動勾選「Save password, enable complete library」,此時密碼會以明文額外寫入同一個檔案。
Navidrome 的完整曲庫是預設開啟的嗎?
不是。預設的「All songs」是隨機取樣;只有在連線表單勾選「Save password, enable complete library」才會用 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資料與來源
**A local + online music player, natively embedded in DeepSeek Harness.**
**Requires DSH Web / Desktop.** A browser runtime is needed for playback.
Sidebar entry, lyric line above the composer, in-conversation playback, host theme tokens, and light/dark support.
Host: `index.js` + `lib/**`, exposing `/music/*` HTTP routes.
Web: `client.js` is built from `src/**` as a single CJS module with no runtime dependencies beyond the host-provided `re…
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-15。發現錯誤?提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。
