dsh-plugin-music
DSH Music — 内嵌 DeepSeek Harness 的独立音乐播放器插件,UI 1:1 复刻 AlgerMusicPlayer,数据来自网易云音乐开放接口。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:caimc21069065-prog/dsh-my-music#0c20c3c4ebf4d67971adb438f0b7b22d0bdf9b67Plugin Music 以 dsh-plugin-music 发布，当前版本为 1.0.3。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DSH Music — 内嵌 DeepSeek Harness 的独立音乐播放器插件。UI 按 AlgerMusicPlayer 5.1(MIT)做 1:1 复刻,去掉原品牌后作为 DSH 原生插件运行;不依赖本机安装任何播放器。
netease-cloud-music-api-alger)+ 本地 webserver 路由(数据 API + 音频流代理 + 下载落盘)music_search / music_song_url / music_lyric / music_playlist_tracks)| 歌单详情 | 播放列表 |
|---|---|
| 歌单 | 队列 |
| 沉浸式歌词 | 歌单广场 |
|---|---|
| 歌词 | 歌单广场 |
编辑 ~/.dsh/profiles/desktop/package.json:
"dependencies": {
"dsh-plugin-music": "file:C:/path/to/dsh-my-music"
},
"dsh": {
"profile": {
"bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-plugin-music"]
}
}
然后在该目录 pnpm install,重启 DSH;左侧图标栏会出现「音乐」。
dsh plugin --profile desktop add dsh-plugin-music
~/.dsh/profiles/desktop/cordis.patch.yml)- id: music
config:
cookie: 'MUSIC_U=xxxxxxxx' # 可选兜底;界面扫码登录/退出后不再起作用
requestTimeoutMs: 15000
defaultLevel: standard # 音频代理默认音质
downloadDir: 'C:/Users/you/Music/DSH' # 客户端下载目录,必须是绝对路径;留空用 ~/Music/DSH
~/.dsh/music-cookie.json,无需重启即对全部接口与音频代理生效播放条、歌曲行悬停区、右键菜单都有下载入口,走宿主 /music/api/download:按当前音质解析直链后由 Node 落盘,先写 .part 再改名;文件名中的 / \ * ? " < > | 与 .. 一律清洗,写入不会逃出 downloadDir。未登录或非会员时 VIP 曲目只能拿到试听片段,文件名会带 (试听) 后缀,下载完成的提示里也会标注。
落盘目录默认 ~/Music/DSH(可用插件配置 downloadDir 改成任意绝对路径)。下载完成的提示条带「打开目录」按钮,点击即在系统文件管理器里定位到刚下好的文件;设置 → 存储 里可以看到完整路径、最近下载的文件列表,并支持逐个「定位」:
npm install
npm run build # esbuild 打包 src/client.jsx → lib/client.js(ModuleLoader 工厂格式,CSS 内联)
npm test # 冒烟:工具 + 全部 /music/api/* + 音频流 Range + 下载落盘 + 扫码登录状态机(真实网络)
design/render-test/ 内置一套 mock 宿主 API 的渲染页,可以脱离 DSH 直接看各个页面(截图在 design/shots/):
npm run preview:build
cd design/render-test && python -m http.server 8391
# 打开 http://127.0.0.1:8391/preview.html?scene=home
scene 可选:home / list / toplist / search / search-result / playlist / album / artist / user / settings / queue / full / context / queue-next / fav;加 &guest=1 可看未登录首页。queue-next 会演示「下一首播放」后的队列顺序,fav 会弹出「取消全部收藏」确认框。
队列与播放模式的逻辑抽在 src/ui/queue.js(纯函数,不依赖 React/DOM),由冒烟测试直接覆盖:insertNext(下一首播放的插位)、nextIndex(列表/单曲/随机)、prevIndex、shuffled。抽出来的原因是这些下标运算很容易在重构中悄悄改错,而纯函数可以被 Node 直接断言。
src/ui 里只能用静态 import 引入本地模块。构建参数 minifyIdentifiers: false 下,esbuild 会把动态引入的解构变量编译成未改名的自由引用,运行期 ReferenceError 又被 .catch 吞掉,现象是「歌词永远空白」。lyric 接口(带 _nmclfl)而不是 lyric_new:后者把头部若干行返回成 JSON 富文本,纯音乐/逐字歌词缺失时反而整段丢行。<input type="range">,只通过 onChange 取值。DSH 宿主会在 document/window 上挂指针监听(输入模态、点击外部关闭浮层),任何自定义 pointer 逻辑在宿主里都不可靠;原生 range 由浏览器内建控件处理点按/拖动,实测在宿主的 document 捕获阶段 stopPropagation 之下依然生效。DSH 的插件客户端 bundle 由 dsh-client-modules 提供,URL 按文件的 mtime/ctime/size 生成 rev,响应头是 cache-control: public, max-age=31536000, immutable。也就是改了 lib/client.js 之后,只在页面里切换/刷新不一定能拿到新包,请完全退出 DeepSeek Harness(托盘 → 退出)再重开。判断是否加载了新包:把鼠标悬停到播放条进度条上,提示文字带当前版本号(如 v1.0.3),或看 设置 → 关于 的版本号。
DSH 桌面端
├─ 宿主插件 lib/index.js
│ ├─ /music/api/* 数据接口(见下)
│ ├─ /music/stream/:id 音频流代理(Range 透传,<audio> 直接指向此处)
│ └─ 4 个 agent 工具
└─ 客户端 lib/client.js(React,slots: main + sidebar.panellist)
└─ 与宿主同源通信(无需 CORS),音频走本地代理解决混合内容
宿主接口一览:
| 路由 | 说明 |
|---|---|
/api/home | 首页聚合(每日推荐 / 推荐歌单 / 热门歌手 / 新碟 / 新歌),单个板块失败不影响整页 |
/api/playlists、/api/playlists/categories | 歌单广场分类与分页 |
/api/playlist/detail、/api/playlist/tracks | 歌单详情与全部曲目 |
/api/toplists、/api/toplist/tracks | 榜单列表与曲目 |
/api/album/new、/api/album/detail | 新碟与专辑详情 |
/api/artist/top、/api/artist/detail、/api/artist/albums | 歌手 |
/api/search、/api/search/hot、/api/search/suggest | 搜索(结构化字段 + 旧版 detail 摘要) |
/api/song/detail、/api/song/urls、/api/lyric | 曲目元数据、直链、歌词 |
/api/personal/fm、/api/user/playlists、/api/like | 私人 FM、我的歌单、喜欢 |
/api/download | 下载落盘 |
/api/download/info | 下载目录与最近落盘的音频文件(供设置页「存储」展示) |
/api/download/open | 在系统文件管理器里打开下载目录;带 name 时精确选中该文件(越界路径退化为打开目录) |
/api/account、/api/login/qr/*、/api/logout | 账号与扫码登录 |
数据层对网易云接口的网络类错误(TLS 断连 / 5xx)会重试两次,避免个别板块偶发空白。
UI 结构复刻自 AlgerMusicPlayer(MIT,感谢原作者 algerkong);数据依赖社区维护的第三方接口库,仅供个人学习研究。音乐内容版权归网易云及版权方所有,请遵守当地法律,勿用于商业用途。不包含任何音源解锁组件。
MIT