netease-music-cli

网易云音乐遥控器：一句话对上云里的内容（每日推荐 / 歌单 / 榜单 / 收藏 / FM / 最近 / 播客）并放出来；播放侧管好本机队列现场（快照 / back / 追加）

由 Pi 技能 netease-music 发布（同一个源还有技能包出口），当前版本 v0.1.6。 命令名是 netease-music：仓库名带 -cli，命令不带。

• 平台：macOS
• 许可：GPL-3.0-or-later（全文见 LICENSE）

安装

./scripts/install-cli.sh          # 链接到 ~/.local/bin/netease-music 并检查依赖
netease-music check                     # 自检：依赖与状态
netease-music help                      # 完整命令面

先准备什么

• node（运行环境），接口客户端与 mpv 控制都是 node 脚本，零 npm 依赖
• python3（运行环境）
• mpv（命令），安装：brew install mpv；真正的播放器（常驻 + unix socket 控制）
• qrencode（命令），安装：brew install qrencode；只在扫码登录时用

常用命令

命令	说明
daily	每日推荐分页入队播放（--limit N / --offset N / --shuffle；JSON 带 total）
play	播一首或一整张：关键词→最匹配一首；歌单 id/链接→整张（--shuffle）
play-ids	play-ids <id,id,...> [--start N]：按输入顺序整列替换，1 基起点默认 1；保留重复项，选中歌不可播则保留旧队列；关闭随机
search	只搜不播：列出 id/歌名/歌手/时长/是否要 VIP（--limit N / --offset N；JSON 带 total）
cover	cover <歌曲关键词
artist	歌手热门分页入队播放（名字或 id；--limit N / --offset N；JSON 带 total）
album	专辑按顺序分页入队播放（名字、id 或专辑链接；--limit N / --offset N；JSON 带 total）
albums	只列不播：歌手的专辑（含老专辑；--limit N / --offset N；JSON 带 total）
liked	分页播放「我喜欢的音乐」（--limit N / --offset N；JSON 带 total）
liked-ids	只读喜欢 ID 全表；--json 为 {count,total,ids:[数字,...]}；歌曲 JSON 透传可用的布尔 liked，缺字段时用全表按 id 判定
myplaylists	我的歌单（自建 + 收藏）；--limit N / --offset N 分页，collected/own 筛本页；JSON 带 total
pause	暂停
resume	继续播放
toggle	暂停/继续切换
next	下一首
prev	上一首
stop	停止并清空队列
clear	停止并清空 mpv 和本地队列，收掉保活；配置和快照保留，可重复调用
volume	读或设音量（0-130）
seek	跳进度（相对秒数，如 +30）
queue	看队列（mpv 真值）：每首歌名、时长，标出正在放的那首
jump	跳到队列第 N 首（从 1 开始），并回读状态确认
remove	remove ：按 queue 显示的 1 基序号删除；当前项选下一首，末尾选上一首，删空停止；同步本地文件
status	当前曲目/进度/音量/队列位置（mpv 真值）；repeat_mode 为 off/list/single
lyric	当前歌曲歌词（默认只显示当前句与下一句，--all 全文）
like	把当前这首歌加入「我喜欢的音乐」
unlike	把当前这首歌移出「我喜欢的音乐」
shuffle	队列随机开/关
repeat	repeat off
login	登录（--sms 手机号+验证码两步为主力；不带参数出二维码扫码），cookie 存本机 config
setup	写配置（--cookie/--quality）；不带参数打印登录办法
check	只读自检：依赖、登录态、mpv 可用性、默认音质
playlist	放一张歌单：名字/id/链接都行（--limit N / --offset N；JSON 带 total）
playlists	搜歌单（只列不播）：id / 名字 / 曲目数 / 作者 / 是否已收藏；--limit N / --offset N，JSON 带 total
charts	列排行榜（只列不播）：飙升榜 / 新歌榜 / …；--limit N / --offset N，JSON 带 total
chart	放某个榜单：名字或 id（--limit N / --offset N；JSON 带 total）
myalbums	我收藏的专辑（只列不播；--limit N / --offset N；JSON 带 total；id 可喂 album）
myartists	我收藏的歌手（只列不播；--limit N / --offset N；JSON 带 total；id 可喂 artist）
fm	私人 FM：没听过的歌，整列入队开播（--limit N）
dislike	dislike [歌曲id]：私人 FM 不喜欢（fm/trash）；省略 id 用当前歌曲，只上报，不自动切歌或改队列
recent	最近播放（只列不播，一周内，含播放次数；--limit N / --offset N；JSON 带 total）
replay	再放一次最近第 N 首（默认 1 = 最近那首）
podcasts	我的播客订阅（只列不播；--recommend 看推荐的；--limit N / --offset N；JSON 带 total）
podcast	放某播客的节目（--limit N 默认 3；--offset N；名字或 id；JSON 带 total）
episode	放某一期节目（节目 id 从 podcast 输出里抄）
queues	看本地队列快照（每次换队列会自动留一条「上一条」）
queue-save	把当前队列存成命名快照（只存歌曲列表，地址回放时重取）
queue-load	载入某个命名快照（含当时位置与随机状态）
back	切回上一条队列（含位置）；再 back 一次切回来
add	把一首加到当前队列尾部，不动正在放的那首

消费方契约（JSON 字段 / 环境变量 / 状态目录 / 退出码）见 REFERENCE.md。