前言¶
DSH 以插件擴展 Web 客戶端能力。ncm-player 解決的是在 DSH Web 頁面中順手聽歌、搜歌、看歌詞的需求：不需要另開播放器，也能在頁面裏保留一個可拖拽、可隱藏的網易雲音樂浮窗。
下面介紹它的定位、核心功能、安裝方式與使用限制。
這是什麼¶
ncm-player 是一個運行在 DeepSeek Harness（DSH）Web 界面裏的網易雲音樂浮窗播放器。維護者爲 WolfGenerals，許可證爲 MIT。
它把播放控制、搜索與發現、歌詞、播放隊列、賬號登錄和設置放在同一個浮窗中。安裝並重啓 DSH Web 後，頁面右下角會出現音符按鈕，點擊即可展開播放器。
核心功能¶
播放與隊列¶
支持：
- 播放/暫停、上一首/下一首、進度拖拽、音量與靜音
- 順序、單曲循環、隨機三種播放模式
- 播放隊列添加、移除、清空
- 重啓後恢復隊列、進度、播放模式、音量
搜索與賬號¶
支持：
- 搜索單曲、歌單、專輯
- 熱門歌單推薦
- 網易雲 App 掃碼登錄或粘貼 Cookie 登錄
- 登錄後查看創建、收藏、喜歡的歌單與收藏的專輯
歌詞¶
支持：
- 逐行同步歌詞高亮
- 點擊歌詞跳轉進度
- 歌詞翻譯（有翻譯時顯示）
- 迷你模式顯示當前歌詞，超長歌詞自動橫向滾動，字號可調
浮窗與設置¶
支持：
- 展開、迷你條、隱藏三種浮窗形態且可拖拽
- 界面顏色自動跟隨 DSH 皮膚主題
- 音質、歌詞翻譯開關、迷你歌詞開關、滾動和字號設置自動持久化
安裝與啓用¶
在 DSH Web 插件環境中執行：
dsh plugin --profile web add @wolfgenerals/ncm-player
執行後重啓 DSH Web。頁面右下角出現音符按鈕，點擊展開播放器。
ncm-player 以當前 dsh 進程權限運行。安裝前建議檢查源碼與許可證；項目許可證爲 MIT。插件運行依賴本機 PATH 上的 Node.js 運行時，以及可訪問 music.163.com 的網絡。
典型用法¶
- 安裝插件並重啓 DSH Web 後，點擊頁面右下角音符按鈕，展開播放器。
- 在「發現」頁搜索單曲、歌單、專輯，或選擇熱門歌單；點擊任意一首歌開始播放。
- 在「播放」頁切歌、拖進度、調音量、切換播放模式。
- 在「歌詞」頁查看逐行歌詞與翻譯；僅當歌曲有翻譯數據時顯示翻譯。
- 在「設置」頁使用網易雲 App 掃碼登錄或粘貼 Cookie，解鎖「我的音樂」與收藏。
- 點擊窗口右上角
-收起爲迷你條，點擊×隱藏；再次打開點擊右下角音符按鈕。
數據保存¶
登錄態與播放隊列保存在本機瀏覽器 localStorage，鍵爲 ncmply-settings，不寫入磁盤文件。
- 換瀏覽器或清除站點數據會丟失登錄態/隊列，需重新登錄。
- 瀏覽器隱私模式下 localStorage 不可用時，功能照常，但僅不持久化。
- 升級自 ≤1.0.7 的用戶：舊文件
~/.dsh/ncmply-settings會在啓動時被只讀讀取一次並自動遷入 localStorage，隨後不再寫入。
使用限制¶
- 部分歌曲受版權/會員限制無法播放。
- 歌詞翻譯僅當歌曲有翻譯數據時顯示。
- 收藏受網易雲賬號風控影響，失敗時會有提示，屬正常現象。
- 登錄 Cookie 只用於請求
music.163.com，不發送給任何第三方。 - 僅供個人學習使用，請遵守網易雲音樂服務條款與當地法律法規。
結尾¶
ncm-player 提供的是一個輕量級的 DSH Web 網易雲音樂浮窗：播放、搜索、歌詞、隊列、登錄和設置都集中在同一個浮窗裏。
GitHub 地址：https://github.com/WolfGenerals/ncm-player.git
