前言¶
在 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 仓库。
