MIT ライセンスで DeepSeek Harness にネイティブ統合されるローカル+オンライン音楽プレーヤー。ローカルライブラリ、クラウドプレイリスト、歌詞、キャッシュ、メタデータ、再生統計を 1 つのサイドバープレーヤーと 1 つのキューで扱えます。
DSH 統合
ネイティブ実行
作者による申告
安全性監査
未監査
最終検証日
2026-11-15
ライセンス
MIT
01どんなタスクに使えるのか?
DeepSeek Harness の中でハードディスク上の音楽フォルダーをそのまま再生する
複数ルートをスキャンしたローカルライブラリ(曲 / アルバム / アーティスト / フォルダー / お気に入り / 統計ビュー)、レコード風の再生画面、ドラッグできるキュー、最後に再生した曲と位置の復元
音楽ファイルを手元に置き、別のプレーヤーを開かずに DSH のサイドバーで聴きたい DSH Web / Desktop ユーザー
NetEase Cloud Music / QQ Music / KuGou のクラウドプレイリストと自前の Navidrome / Subsonic を同じキューで扱う
QR サインイン後のクラウドプレイリスト・お気に入り・最近の再生、Subsonic の検索 / ストリーミング / 歌詞 / カバー、ソースを切り替えても残るキュー
ローカルファイルとストリーミングアカウントや自前の音楽サーバーを併用し、アプリを何度も切り替えたくない人
第三者のタグエディターを開かずにタグ・カバー・歌詞を整える
曲単位またはフィールド単位のオンラインメタデータ照合、カバー差し替え、内蔵歌詞への書き戻し前の自動バックアップ、重複検出、元のパスで復元できるプラグインのゴミ箱
大きなローカルライブラリを維持し、メタデータ修正と再生を同じウィンドウで済ませたいユーザー
02DeepSeek 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 を再起動すると有効になります。
ローカルライブラリのスキャンと再生
1 つ以上の音楽フォルダー(サブフォルダーの深さを設定可能)→曲 / アルバム / アーティスト / フォルダー / お気に入り / 統計でたどれるライブラリ。リストリピート、1 曲リピート、シャッフル、シーク、曲ごとの続き再生に対応します
オンラインソースと共有キュー
QR サインインした NetEase / QQ Music / KuGou のアカウント、または Navidrome / Subsonic のサーバー URL・ユーザー名・パスワード→クラウドのプレイリスト・お気に入り・最近の再生と、Subsonic の検索 / ストリーミング / 歌詞 / カバーを、ローカルファイルと同じキューで再生します
Cookie、トークン、Navidrome の salt + token はローカルの `~/.dsh/music/providers.json`(パーミッション 0600)に書き込まれますオーディオキャッシュ
再生中のオンライン曲→再生しながら書き込むローカルキャッシュ。既定の上限は 10 GB で LRU により削除され、設定 → キャッシュから一覧表示と消去ができます
キャッシュと再生履歴は `~/.dsh/music/` に保存されます歌詞と翻訳
内蔵歌詞、`.lrc` ファイル、またはオンラインの歌詞ソース→行単位のハイライト、翻訳、文字サイズ / 太さ / ぼかし / 配置の調整、±0.5 秒のオフセット、内蔵歌詞への書き戻し前の自動バックアップ
音量の均一化と 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 専用です。再生にはブラウザーランタイムが必要なため、ブラウザーを持たないホストではプラグインを導入しても音を出せません。
- オンライン各社は公開された非公式 API を使っており、仕様変更・スロットリング・停止が起こりえます。失敗は UI に表示され、ローカル再生には影響しません。
- 「Save password, enable complete library」を有効にすると、Navidrome のパスワードが平文でローカルの `~/.dsh/music/providers.json` に追記されます。このファイルには Cookie・トークン・salt 付きトークンも入るため、端末のアカウントが侵害された場合の影響が広がります。
05互換性・メンテナンス・セキュリティ上の注意
- DSH Web / Desktop 専用です。再生にはブラウザーランタイムが必要なため、ブラウザーを持たないホストではプラグインを導入しても音を出せません。
- オンライン各社は公開された非公式 API を使っており、仕様変更・スロットリング・停止が起こりえます。失敗は UI に表示され、ローカル再生には影響しません。
- 「Save password, enable complete library」を有効にすると、Navidrome のパスワードが平文でローカルの `~/.dsh/music/providers.json` に追記されます。このファイルには Cookie・トークン・salt 付きトークンも入るため、端末のアカウントが侵害された場合の影響が広がります。
- 完全なライブラリ表示は 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 専用です。音声再生にブラウザーランタイムが必要で、ホストに設定済みのネットワークとストレージを利用します。ヘッドレスやサーバー専用の DSH ホストでは動作しません。
導入したのにサイドバーへアイコンが出ないときは?
まずバージョンが 0.27.3 以降か確認してください。0.27.2 以前は `package.json` の `./package.json` エクスポートを欠いていたため、DSH はクライアントパッケージではないと静かに判定し、ブラウザー側が読み込まれません。次に DSH を完全に終了して再起動し、プラグインマーケットで音楽プラグインを無効化してから再度有効化します。最後に profile の `cordis.patch.yml` に `- id: music` / `disabled: true` が残っていないか確認し、そのブロックだけを削除して再起動してください。
Cookie やキャッシュはどこに保存されますか?
すべて端末内で動きます。Cookie、トークン、Navidrome の salt + token は `~/.dsh/music/providers.json`(パーミッション 0600)だけに書き込まれ、キャッシュと再生履歴は `~/.dsh/music/` に置かれます。ブラウザー側は外部ドメインを呼ばず、検索・ストリーム解決・歌詞・カバーは Host が同一オリジンでプロキシします。例外は「Save password, enable complete library」を自分で有効にした場合で、Navidrome のパスワードが平文で同じファイルに追記されます。
Navidrome の完全なライブラリ表示は既定で有効ですか?
いいえ。既定の「All songs」はランダムサンプリングで、接続フォームで「Save password, enable complete library」を有効にしたときだけ Navidrome のネイティブなページング API で全曲をたどれます。この表示は内部の `/api/song` に依存するため、動かない場合はサンプリングに戻り、検索・再生・お気に入りには影響しません。
07関連する DSH ワークフロー
dsh-tui
by ccch1mneyyy
Claude Code 風の全画面 TUI プラグイン。鯨トップバー、リアルタイム状態行、思考ストリーミング、Esc 二連打の巻き戻し、コンテキスト進捗バーと TPS メーター搭載。npm で一発インストール
dsh-better-sidebar
by omdsh-dev
ファイル表示・編集、ターミナル、Git、サブエージェントのページを内蔵し、サードパーティによる新規サイドバーページの登録にも対応する拡張可能なサイドバー基盤
dsh-media-desk
by woniuniuniu
DeepSeek Harness向けのメディア制作ワークスペース。ひらめきの記録から台本、表紙、画像、絵コンテの作成まで行えます。
dsh-drawai
by fourzkw
DeepSeek Harnessの右サイドバーに編集可能なキャンバスを追加します。モデルが画像を直接変更するための2つのツールも利用できます。
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。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。
