怎么装
Pi
pi install git:gitea.vhkd.top/pi-hub/netease-music@v0.1.4CLI
git clone https://gitea.vhkd.top/pi-hub/netease-music-cli.git && cd netease-music-cli && ./scripts/install-cli.sh装完跑 pi-skill netease-music check（Pi）或 netease-music help（命令行）。
先准备什么
node运行环境
接口客户端与 mpv 控制都是 node 脚本，零 npm 依赖
python3运行环境
mpv命令
真正的播放器（常驻 + unix socket 控制）
brew install mpv
qrencode命令
只在扫码登录时用
brew install qrencode
要先配什么
cookie
必配
私密
登录 cookie（MUSIC_U=…），由 login 命令扫码写入
扫码登录一次：pi-skill netease-music login
quality
可选
音质级别：standard/higher/exhigh/lossless/hires
常用命令
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 <歌曲关键词|id> [--download PATH] [--force]：只读查询封面，JSON 为 id/name/artist/cover；下载为 id/cover/file/bytes，最多 10 MB（10000000 字节），覆盖需 --force；所有原语歌曲对象含字符串 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 <index>：按 queue 显示的 1 基序号删除；当前项选下一首，末尾选上一首，删空停止；同步本地文件 |
status | 当前曲目/进度/音量/队列位置（mpv 真值）；repeat_mode 为 off/list/single |
lyric | 当前歌曲歌词（默认只显示当前句与下一句，--all 全文） |
like | 把当前这首歌加入「我喜欢的音乐」 |
unlike | 把当前这首歌移出「我喜欢的音乐」 |
shuffle | 队列随机开/关 |
repeat | repeat off|list|single：关闭/整列/单曲循环；on 和无参数 = list；状态追加 repeat_mode，保留旧 repeat 布尔含义 |
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 | 把一首加到当前队列尾部，不动正在放的那首 |