前言¶
在 DeepSeek Harness (DSH) 的開發與使用場景中，如果需要在 Web 界面直接獲取音樂服務，往往需要手動跳轉或使用外部播放器，導致體驗割裂。DSH 插件體系提供瞭解決這一問題的思路，通過底層協議對接將服務注入到宿主環境中。
這是什麼¶
dsh-tencent-music 是一個爲 DeepSeek Harness (DSH) 量身定製的 QQ 音樂播放器插件。由用戶 L-1124 維護。它解決了在 DSH 環境中直接調用 QQ 音樂協議的問題，提供從搜索、播放到個性化推薦的全鏈路服務，並深度融合了 DSH 的 Agent 智能體工具體系。
核心功能¶
- 無縫 Web UI 集成：提供頂欄快捷喚醒入口與可摺疊的浮動播放器面板，支持進度拖動、音量控制及多種循環模式。
- Agent 智能點歌：註冊了
music智能體工具，支持用戶使用自然語言控制播放器（如點歌、切歌、音量調節、開啓電臺）。 - 個性化電臺與推薦：內置猜你喜歡、雷達推薦、新歌首發等多種電臺模式，支持播放列表的無感續拉。
- 全方位檢索與導入：支持按單曲、歌手、專輯、歌單或歌詞進行深度搜索，並且可以直接通過 QQ 音樂歌單 ID 或分享鏈接一鍵導入（如輸入
201導入“我喜歡的音樂”）。 - 全檔位高解析音質：支持從 128k MP3、320k HQ 到 SQ 無損 (FLAC)、Hi-Res 以及臻品母帶 (AI Master) 的全檔位音質。
- 快捷安全登錄：播放器內嵌 QQ / 微信掃碼登錄，持久化存儲多端 OAuth 憑據，重啓自動恢復會話。
安裝與啓用¶
建議通過 DSH CLI 工具進行本地化安裝與掛載：
dsh plugin --profile web add ./dsh-tencent-music
安裝完成後，請重新啓動 dsh web 並在瀏覽器中刷新，即可在頁面頂欄看到音樂播放器圖標。
典型用法¶
通過在聊天框向 Agent 發送自然語言指令，你可以輕鬆操控播放器：
- 放一首周杰倫的晴天
- 開啓猜你喜歡電臺
- 播放今日推薦歌曲
- 下一首 / 暫停 / 繼續
- 把音量調大一點
- 幫我導入歌單 201
- 看看現在在放什麼歌
適用場景與注意¶
- 環境依賴：本插件依賴於
@deepseek-ai/cordis與 DSH 的 Web UI 注入框架。使用前請確保你的 DSH 宿主環境版本兼容。 - VIP 降級策略：當遇到無權限播放的 VIP 歌曲時，系統會自動平滑降級，獲取並播放 30 秒官方試聽片段 (RS02)，確保播放隊列不會中斷。
- 權限檢查：插件以當前 dsh 進程權限運行，安裝前建議檢查源碼與許可證。
總結¶
該插件通過深度整合 QQ 音樂協議與 DSH 的 Agent 體系，爲開發者與用戶提供了一個無需跳轉即可掌控全鏈路音樂服務的解決方案。
- 目錄頁：https://www.skillhub.cn/plugins/L-1124/dsh-tencent-music
- GitHub：https://github.com/L-1124/dsh-tencent-music
