前言¶
DeepSeek Harness（DSH）支持通過插件擴展功能。在 Web profile 中，開發者通常需要在對話和聽音樂之間切換，這會打斷工作流。dsh-music 插件解決了這個問題，它直接接入 QQ 音樂，在 Web 界面中提供了一個懸浮播放器，允許用戶在對話過程中控制音樂播放。
插件介紹¶
dsh-music 是一個開源插件（MIT 許可證），由用戶 1608kiy 維護。它不依賴外部前端框架，通過 host 端代理解決跨域問題，並提供了掃碼登錄 QQ 音樂賬號的能力。
核心功能¶
- 懸浮播放器與交互：播放器採用深色毛玻璃效果，支持展開/收起動畫。右下角卡片可自由拖動並記憶位置，播放中封面會旋轉。鼠標離開 5 秒後，播放器自動收縮成小唱片圈，靠近屏幕邊緣會自動吸附。
- 快捷控制與狀態記憶：支持鍵盤快捷鍵（空格暫停/播放，左右箭頭切歌）。插件會自動記憶隊列、音量、循環模式，重啓後自動恢復。提供 128k 和 320k 兩種音質選擇。
- 最小化與插件管理：播放器右上角可收起，最小化爲角落小圈（封面繼續旋轉，雙擊/三擊控制切歌）。可在設置中停用或啓用插件。
- QQ音樂接入與登錄：支持通過官方 vkey 解析播放，Meting 作爲兜底。提供精緻的掃碼登錄頁，憑證保存在本地，登錄後可解鎖 VIP 歌曲播放、導入「我喜歡」及個人歌單。
- Agent 集成：內置
music工具，可通過對話指令（如“放首歌”、“暫停”、“音量調到 50%”）控制播放器，無需手動點擊 UI。 - 默認曲庫配置：支持通過環境變量
DSH_MUSIC_PLAYLIST配置默認加載的 QQ 音樂歌單 ID。
安裝與配置¶
- 下載插件包到本地路徑。
- 使用 DSH CLI 安裝插件：
dsh plugin --profile web add "file:/path/to/dsh-music"
- 安裝後重啓 DeepSeek Harness Web 應用。
- 可選配置：設置環境變量
DSH_MUSIC_PLAYLIST爲 QQ 歌單 ID，啓動時自動加載爲內置曲庫。
使用方法¶
- 操作播放器：點擊右下角卡片展開播放器，拖動頂部可移動位置。鼠標離開 5 秒自動收縮。
- 搜索與導入：在播放器搜索框輸入歌名/歌手回車搜索，或粘貼 QQ 音樂歌單鏈接/ID 導入。
- 快捷鍵控制：在輸入框外使用空格暫停/播放，左右箭頭切歌。
- Agent 指令：直接對模型說指令，如“放首歌”、“暫停”、“音量調到 50%”。
- 管理插件：在設置 → 插件 → 插件配置中管理啓用/停用狀態。
注意事項¶
- 本項目與 DeepSeek、騰訊 QQ 音樂無關，音頻來自公開接口與第三方解析服務，僅供學習交流。
- 受版權或權限限制的歌曲可能無法播放，播放器會自動跳過。
- 登錄憑證僅保存在本地 DSH 實例中，用於向 QQ 音樂接口發起請求。
music工具與 UI 操作均在本地 DSH 實例內完成，無持久化同步。
總結¶
dsh-music 通過集成 QQ 音樂接口和 Agent 工具，爲 DSH Web 用戶提供了輕量級的音樂播放解決方案。它支持本地憑證存儲、斷點續播和快捷鍵控制，適合需要兼顧對話與背景音樂的開發者。
