前言¶
在 DeepSeek Harness（DSH）裏等智能體跑任務時，很多人會切到別的窗口刷網頁或開音樂客戶端。DSH 側邊欄本可以承載輕量工具，但默認並沒有與流媒體對接的入口。維護者 breakc0re 的插件 dsh-yandex-music（GitHub：breakc0re/dsh-yandex-music，社區分類：聯網工具）把 Yandex Music（Яндекс.Музыка） 嵌進側欄底部：點一行字即可展開播放器，搜索、隊列、歌單、「我的電波（Моя волна）」和帶卡拉 OK 的歌詞都在同一界面，不必反覆切窗開瀏覽器。
下文按「是什麼 → 能做什麼 → 怎麼裝 → 怎麼用 → 注意點」說明，事實均來自倉庫 README 與 package.json（版本 1.0.0，許可證 MIT）。
這是什麼¶
dsh-yandex-music 是面向 DSH 的 Web 端插件（package.json 中 dsh.client.platform 爲 web）。服務端入口爲 server.js，在 Cordis 上註冊 /api/plugins/yandex-music/* 一類路由；客戶端 client.js 通過 @deepseek-ai/dsh-client-ui-sidebar 等注入側欄 UI。
設計目標很直接：側欄最下方出現 「Яндекс.Музыка」 入口（README 說明該位置原可能與 Remote Control 相關；安裝後 Remote Control 改到 「更多」 菜單）。登錄使用 Yandex Device Flow，令牌保存在本機 <DSH_HOME>/plugin-data/dsh-yandex-music/auth.json，README 寫明令牌不會進入界面、日誌或發往插件作者以外的第三方（音樂請求除外，見下文隱私表）。
前提：需要 Yandex 賬號；完整曲目播放依賴 Yandex Plus 訂閱。未識別到 Plus 時，Yandex 只提供約 30 秒預覽——這是服務側限制，不是插件本地裁切。
核心功能¶
播放與隊列¶
- 可拖拽排序的播放隊列，支持 ↑↓ 調整順序。
- 單曲循環、列表循環、隨機（僅作用於當前隊列中尚未播放部分）。
- 預加載下一首，減少曲目間隙。
- 重啓 DSH 後從上次暫停的 秒數 繼續。
- 音量：點擊揚聲器靜音，懸停顯示豎向滑塊；側欄圖標上滾輪也可調音量。
鍵盤與系統媒體鍵¶
- 支持媒體鍵與系統媒體浮層（曲名、藝人、封面、播放控制）。
- 播放器獲焦時：
Space播放/暫停，←→進退 5 秒，↑↓音量，M靜音。
搜索與曲庫導航¶
- 按曲目、藝人、專輯搜索。
- 藝人頁、專輯頁內點選即可入隊。
- 曲目右鍵：下一首播放、加入隊列末尾、加入歌單、收藏、跳轉藝人、複製鏈接。
「我的電波」（Моя волна）¶
- README 稱目錄含約 700 個電臺維度（情緒、場景、年代、流派、語言等）。
- 可按藝人名生成個人化電臺；跳過與不喜歡的反饋會回傳 Yandex，用於調整推薦。
歌單¶
- 創建、重命名、公開/私密、刪除。
- 曲目拖拽排序、單條刪除。
- 「我喜歡」打開後進入「當前」視圖，README 寫明約 300 首常聽曲目在側。
歌詞與翻譯¶
- 獨立小窗貼靠播放器，背景爲封面。
- 卡拉 OK：按 LRC 時間軸高亮當前行，列表自動滾動；點某行可 seek 到對應位置。
- 外語歌詞可用 「Я」 譯爲俄語：優先站點上的文學譯本，否則走機器翻譯（見隱私一節）。
安裝與啓用¶
插件以當前 DSH 進程權限運行；安裝前建議瀏覽倉庫源碼與 MIT 許可證。DSH 插件可從社區目錄發現（breakc0re/dsh-yandex-music 目錄頁），與 DeepSeek / 幻方無官方從屬關係，屬社區生態。
方式一：插件市場¶
- 打開 DSH 插件目錄，搜索「Яндекс.Музыка」。
- 點擊安裝。
- 重啓 DSH。
方式二：GitHub 安裝命令¶
README 給出的命令如下（desktop 爲示例 profile，請換成你實際使用的 profile 名）：
dsh plugin --profile desktop add github:breakc0re/dsh-yandex-music
若 profile 需要顯式掛載 bundle，在對應 cordis.patch.yml 中追加：
- insert:
- id: yandex-music
name: dsh-yandex-music
保存後 重啓 DSH。運行環境要求 Node.js >= 20（來自 package.json 的 engines）。
典型用法：首次登錄¶
- 點擊側欄底部的 「Яндекс.Музыка」。
- 插件展示短碼；在瀏覽器打開 ya.ru/device 並輸入該碼。
- 完成後 Plus 狀態會自動識別；有 Plus 即可播放完整曲目。
若只聽到 30 秒預覽，README 建議覈對播放器右上角頭像是否爲 已訂閱 Plus 的賬號。
日常聽評：用搜索或電波入隊，在「當前」裏拖拽順序；需要看詞時打開歌詞窗。開發模式下改 client.js / server.js 等只需重載 DSH 窗口，無需單獨構建（README「Разработка」一節）。
網絡訪問與隱私¶
插件僅爲功能訪問下列端點（README 表格摘要）：
| 目標 | 用途 |
|---|---|
api.music.yandex.net |
播放、搜索、歌單、電波（攜帶你的令牌與請求） |
lrclib.net |
帶時間軸歌詞（曲名與藝人） |
translate.googleapis.com |
歌詞機器翻譯（歌詞文本） |
amalgama-lab.com |
現成文學譯詞（藝人名與曲名） |
令牌、登錄與訂閱信息除發往 Yandex 外，README 聲明不向其他方發送。
適用場景與注意¶
適合誰：已在用 DSH 桌面/Web 側欄、且有 Yandex Plus 的開發者或用戶；希望在長任務等待時側欄內完成點播、電臺和歌詞，而不切換獨立音樂應用。
需要注意：
- Yandex Music 使用 非公開 API，無官方插件支持承諾；若 API 變更，功能可能中斷——README 已聲明與 Yandex 無隸屬關係。
- 側欄底欄位置被本插件佔用時，Remote Control 入口遷至 「更多」。
- 插件請求外網；企業或離線環境需自行評估策略。
- GitHub 星標爲 0（線索數據）；成熟度以你本地實測爲準。
結尾¶
dsh-yandex-music 把 Yandex Music 的搜索、隊列、歌單、電波和卡拉 OK 歌詞收進 DSH 側欄，Device Flow 登錄、令牌本地存放，目標是在智能體工作時少切一次窗。進一步瞭解可訪問 SkillHub 目錄頁 與 GitHub 倉庫。
