网易云音乐助手 XiaoMao-yty/dsh-netease-music

dsh-netease-music

网易云音乐工具插件（DSH / Cordis）。附带一个零 npm 依赖的 Node CLI nm.js 和配套技能，让智能体能抓取、下载、并管理网易云账号里的内容。

安装

dsh plugin --profile web add https://github.com/XiaoMao-yty/dsh-netease-music/archive/refs/heads/main.tar.gz

装完必须重启 dsh web —— 只有重启，Host 才会挂载插件、把 netease 工具注册进去，并同步 netease-cloud-music 技能。

卸载：

dsh plugin --profile web remove dsh-netease-music

这个插件提供什么

| 提供物 | 说明 |
| netease 工具 | 把 CLI 的全部子命令暴露成 DSH 原生工具，模型不用知道路径、不走 bash |
| 技能 netease-cloud-music | 完整用法、音质档位决策规则、已知接口坑、策展流程 |
| nm.js | 稳定落在 $DSH_HOME/netease/bin/nm.js，也可直接用 bash 调用 |

能力一览

- 单曲：128k / 192k / 320k MP3、无损 FLAC、Hi-Res、超清母带；自动写标签与封面
- MV：240p / 480p / 720p / 1080p
- 歌词：导出 .lrc，可选原文 / 译文 / 罗马音 / 双语合并，含 [ti:]/[ar:]/[al:] 标签
- 云村笔记（Mlog）：视频、正文、图片
- 歌单：查看、新建、加歌、移出、改名、删除
- 其它：搜索、专辑、歌手主页、用户主页、评论、听歌排行、排行榜、收藏夹、音乐云盘、相似歌曲、每日推荐、图片原图（专辑封面 / 歌手头像与写真 / MV 封面 / 主页背景）
- AI 私人电台：读口味 → 混合每日推荐 / 私人雷达 / 相似歌曲 → 挑歌写推荐语 → 建私密歌单； dj check 能自主检测推荐是否已刷新（网易云不暴露刷新时刻，靠内容指纹实测）

登录

首次使用需要扫码：

node $DSH_HOME/netease/bin/nm.js login --qr # 出码，并把二维码复制到工作区
node $DSH_HOME/netease/bin/nm.js login --wait # 等待扫码（不要重跑上面那条，会换码）

配合 dsh-better-sidebar 的 /sidebar/file 媒体路由，二维码可以直接内联渲染在聊天窗口里扫。
会话写入 $DSH_HOME/netease/session.json（权限 600）。

这个文件等价于账号凭据 —— 不要提交到仓库，也不要随技能目录一起打包分享。

配置

写在配置档的 cordis.patch.yml（常用路径 ~/.dsh/profiles/web/cordis.patch.yml）：

- id: dsh-netease-music
config:
cliPath: '' # 覆盖 CLI 路径；留空用包内 scripts/nm.js timeoutMs: 600000 # 单次命令超时，默认 10 分钟（够下 MV） workspace: '' # 默认工作目录；留空用会话工作区

依赖

- node ≥ 18（只用内置模块 + 全局 fetch，无 npm 依赖）
- python3 + segno —— 仅用于渲染登录二维码：pip3 install segno
- ffmpeg / ffprobe —— 写标签封面、读取真实分辨率；缺失时跳过而不失败

建议把下载目录放在会话工作区内 —— 配合 dsh-better-sidebar 的 /sidebar/file 媒体路由，专辑封面与登录二维码就能直接内联渲染在聊天里（该路由只服务工作区内的文件）。

已知接口坑（改代码前必读）

1. 必须走 weapi 加密；明文 /api/ 登录类路径会被风控返回 -462
2. /weapi/cloudsearch/get/web 已废弃（恒 50000005），搜索要用 /weapi/search/get
3. shell 里用 curl 调网易云要加 -g，否则 ids=[123] 的方括号会被当 glob
4. 歌曲直链约 20 分钟过期
5. 笔记视频/图片的元数据宽高不可信，一律以 ffprobe 实测为准
6. 评论总数在 total，cnum 恒为 0
7. 同一数据在不同接口字段结构不一致（ar/al vs artists/album）
8. 写操作有频率限制（405 操作过于频繁），不要循环重试

完整说明见 skills/netease-cloud-music/SKILL.md。

License

MIT