dsh-netease-music
网易云音乐工具插件（DSH / Cordis）。附带一个零 npm 依赖的 Node CLI nm.js
和配套 skill，让 agent 能抓取、下载、并管理网易云账号里的内容。
安装
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 skill。
卸载：
dsh plugin --profile web remove dsh-netease-music
这个插件提供什么
| 提供物 | 说明 |
|---|
netease 工具 | 把 CLI 的全部子命令暴露成 DSH 原生工具，模型不用知道路径、不走 bash |
skill 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）。
这个文件等价于账号凭据 —— 不要提交到仓库，也不要随 skill 目录一起打包分享。
配置
写在 profile 的 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
媒体路由，专辑封面与登录二维码就能直接内联渲染在聊天里（该路由只服务工作区内的文件）。
已知接口坑（改代码前必读）
- 必须走 weapi 加密；明文
/api/ 登录类路径会被风控返回 -462
/weapi/cloudsearch/get/web 已废弃（恒 50000005），搜索要用 /weapi/search/get- shell 里用 curl 调网易云要加
-g，否则 ids=[123] 的方括号会被当 glob
- 歌曲直链约 20 分钟过期
- 笔记视频/图片的元数据宽高不可信，一律以 ffprobe 实测为准
- 评论总数在
total，cnum 恒为 0
- 同一数据在不同接口字段结构不一致（
ar/al vs artists/album）
- 写操作有频率限制（
405 操作过于频繁），不要循环重试
完整说明见 skills/netease-cloud-music/SKILL.md。
License
MIT
