返回目錄

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 使用者

  • 把 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 目錄作為工作目錄

安裝步驟

  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 介面,瀏覽器端是由 `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 最後套用的設定為準。
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 發起並經同源代理;唯一例外是主動勾選「Save password, enable complete library」,此時密碼會以明文額外寫入同一個檔案。

Navidrome 的完整曲庫是預設開啟的嗎?

不是。預設的「All songs」是隨機取樣;只有在連線表單勾選「Save password, enable complete library」才會用 Navidrome 原生分頁介面瀏覽全庫。這個檢視依賴內部 `/api/song` 介面,失效時會退回隨機取樣,不影響搜尋、播放與收藏。

08資料與來源

  • 作者聲明github.com70a370eb8e4a…

    **A local + online music player, natively embedded in DeepSeek Harness.**

  • 作者聲明github.com70a370eb8e4a…

    **Requires DSH Web / Desktop.** A browser runtime is needed for playback.

  • 作者聲明github.com70a370eb8e4a…

    Sidebar entry, lyric line above the composer, in-conversation playback, host theme tokens, and light/dark support.

  • 作者聲明github.com70a370eb8e4a…

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

  • 作者聲明github.com70a370eb8e4a…

    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 個值得優先安裝的外掛,涵蓋各個分類。

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。