DeepSeek Harness（DSH）是一個插件化框架，允許通過插件擴展界面與功能。開發者在工作中常需聽音樂保持專注，dsh-netease-music 插件直接在 DSH 網頁版中集成了網易雲音樂播放功能。它提供常駐頂部的迷你播放器與可展開的完整面板，內置自動啓動的 NeteaseCloudMusicApi 本地服務，並支持通過 AI 對話控制播放。
核心功能¶
- 頂部條迷你播放器：常駐顯示封面、歌名、歌手及播放控制按鈕。
- 展開播放面板：包含每日推薦、我的歌單、私人 FM、搜索、播放隊列、播放歷史及設置。
- 播放控制：支持順序/列表循環/單曲循環/隨機播放，可拖動進度條、調節音量。
- 斷點續播：自動記錄上次播放的歌曲、歌單及進度，重啓後恢復。
- 掃碼登錄：通過手機 App 掃碼登錄，狀態持久化。
- AI 控制工具：註冊
netease_music工具，可在對話中直接控制播放器。
安裝與啓用¶
環境要求¶
- DeepSeek Harness（
dsh web） - Node.js、pnpm
安裝步驟¶
# 1. 進入 web profile 目錄
cd "$env:USERPROFILE\.dsh\profiles\web"
# 2. link 安裝本插件（<路徑> 替換爲插件目錄的絕對路徑）
pnpm add 'link:C:/<路徑>/dsh-netease-music'
# 3. 安裝插件運行時依賴 NeteaseCloudMusicApi
pnpm add NeteaseCloudMusicApi
# 4. 編輯 package.json，在 dsh.profile.bundles 末尾追加 "dsh-netease-music"
完成上述步驟後，重啓 dsh web（Host 端需要重啓進程加載），刷新頁面即可在頂部條看到播放器。
典型用法¶
- 展開面板：點擊頂部條迷你播放器左側的封面或箭頭，或使用快捷鍵
Ctrl+Shift+M。 - 搜索播放：在面板的「搜索」頁輸入關鍵詞，選擇歌曲或歌單播放。
- AI 對話控制：在對話中輸入自然語言指令，例如「幫我播放周杰倫的晴天」。
- 命令控制：使用工具命令，如
next（下一首）、previous（上一首）、pause（暫停）、volume（調節音量）。
適用場景與注意¶
- 適用場景：DSH Web 環境下的開發者或用戶，需要在開發工作流中接入音樂播放。
- 注意事項：
- 首次播放限制：由於瀏覽器自動播放策略，首次播放需要手動點擊一次。
- 本地服務安全：本地 API 服務（默認端口 3000）僅監聽本機，不可暴露到公網。
- 數據隔離：登錄 Cookie 僅保存在本機 profile 目錄，不會隨插件分發。
- 版權限制：部分歌曲因版權或 VIP 限制無法播放，非 VIP 音質會自動降級。
該插件通過集成本地 API 和 AI 工具，將音樂播放無縫融入 DSH 工作流。作者爲 JasonCHTT，採用 MIT 許可證。
