网易云点歌台 genius-crazy/unblockneteasemusic-for-dsh

为 DSH 解锁网易云音乐

在 DeepSeek Harness 的 Web GUI 里听网易云音乐：搜索、点歌、侧边栏迷你播放卡。音源经本机 UnblockNeteaseMusic/server 代理获取，灰色/VIP 歌曲由代理自动用酷我/咪咕等替代源解锁，无需登录、无需 cookie。

功能

- LLM 点歌工具：music_search / music_play / music_playlist / music_prev / music_next / music_control——直接对模型说「放一首鼓XXX」即可。
- 侧边栏迷你播放卡：封面/歌名/歌手、上一首/播放暂停/下一首、可拖动进度条。
- 代理自动拉起：插件启动时探测代理是否已就绪；未运行则自动在后台拉起（autoStartProxy=true，默认开启），卸载时回收。

安装

方式一：npm 安装（推荐，发布后）

前置：已装好 DeepSeek Harness（能跑起 dsh web）。

1. 在 profile 目录安装插件：

cd "$DSH_HOME/profiles/web" # 你的 profile 目录
pnpm add unblockneteasemusic-for-dsh

2. 在 profile 的 cordis.patch.yml 里加一行：

- insert:
- id: unm-music
name: 'unblockneteasemusic-for-dsh'

3. 重启 DSH，刷新浏览器页面即可。

方式二：从源码

git clone https://github.com/<你的用户名>/unblockneteasemusic-for-dsh.git
cd unblockneteasemusic-for-dsh
npm install
npm run build # 产出 lib/index.js + lib/client.js

然后把 lib/、package.json、manifest.json 放进 DSH profile 的 node_modules/unblockneteasemusic-for-dsh/，并按方式一的第 2、3 步注册、重启。

代理：自动拉起 or 手动运行

插件默认（autoStartProxy=true）会在启动时探测 apiBaseUrl：

- 已就绪 → 直接复用（你自己 node app.js 或 .bat 起的代理不会被重复拉起、也不会被误杀）；
- 未就绪 → 自动拉起一个 @unblockneteasemusic/server 子进程（已作为依赖打进插件）。

若你更想完全自己管理代理，设 autoStartProxy=false，然后手动跑：

npx -p @unblockneteasemusic/server unblockneteasemusic # 默认 127.0.0.1:8080

安全提醒：UnblockNeteaseMusic 官方不提供在线 demo，请各自在本机运行代理，勿连来历不明的公网代理。

配置

在 cordis.patch.yml 的 config 下设置（均可省略，有默认值）：

| 键 | 默认 | 说明 |
| apiBaseUrl | http://127.0.0.1:8080 | 本机 UnblockNeteaseMusic 代理地址 |
| neteaseHost | music.163.com | 代理转发目标 Host |
| br | 320000 | 请求码率 |
| autoStartProxy | true | 代理未运行时是否自动后台拉起 |
| proxyReadyTimeoutMs | 10000 | 等待代理就绪的超时（毫秒） |

架构

仿照 lx-music-for-dsh 的 host/client 双端，但音源层整体替换：

- host（src/index.ts）：PlaybackService（Typert Remote remote.music，播放权威状态）+ music_ 工具 + storageDomain 持久化。
- client（src/client.ts + src/ui/）：HTML5 Audio 执行端 + sidebar.footer.action 迷你播放卡，500ms 轮询 host 状态。
- 音源层（src/netease.ts）：明文表单调用代理，零加密。
- 代理层（src/proxy.ts）：探测 + 拉起 + 回收 @unblockneteasemusic/server。

音源层对代理发明文表单 POST（均伪造 Host: music.163.com）：

| 需求 | 请求 | 返回 |
| 搜索 | POST /api/cloudsearch/pc，s=<关键词>&type=1&limit=&offset=0&total=true | result.songs[] |
| 取播放地址 | POST /api/song/enhance/player/url，ids=["<id>"]&br=320000 | data[0].url（灰色歌曲已被解锁） |
| 播放 | 把返回的 /package/... host 重写为本地代理 | 206 audio/mpeg 流 |

开发

npm install # esbuild / typescript / zod / @unblockneteasemusic/server
npm run typecheck # tsc --noEmit（需 @deepseek-ai/ peer 依赖已安装）
npm run build # 产出 lib/index.js + lib/client.js
node scripts/smoke.ts # 音源层冒烟测试（需代理在跑）
node probe/e2e.mjs # 端到端冒烟（需 DSH 在跑）
@deepseek-ai/* 是 peer 依赖，构建时外置、不打包，运行时从 DSH 配置档的 node_modules 解析。插件版本对照 DSH 0.1.0-rc.5（cordis 4.0.1、schemastery 3.18.1）。

许可与致谢

- 本插件：MIT。
- 依赖 UnblockNeteaseMusic/server（LGPL-3.0，作为独立进程运行，版权归其作者）。

已知限制

- 无歌词、无登录 cookie、固定 320k 码率、单音源。
- 播放列表为内存态 + 持久化（重启恢复列表/音量/静音），但不含收藏/歌单同步。
- client 端 Typert Remote 描述符为手写（对齐 host 的 ctx.typert.register），未走 typert-generator 生成面。