{
  "summary": "网易云音乐遥控器：一句话对上云里的内容（每日推荐 / 歌单 / 榜单 / 收藏 / FM / 最近 / 播客）并放出来；播放侧管好本机队列现场（快照 / back / 追加）",
  "useWhen": "用户要放网易云的音乐（每日推荐、指定歌曲/歌手、我喜欢的音乐）、问现在在放什么，或要暂停/切歌/调音量/看歌词/取歌曲封面时",
  "tier": 1,
  "entry": {
    "path": "scripts/netease-music.sh"
  },
  "aliases": [
    "netease",
    "netease-music"
  ],
  "commands": [
    {
      "name": "daily",
      "summary": "每日推荐分页入队播放（--limit N / --offset N / --shuffle；JSON 带 total）"
    },
    {
      "name": "play",
      "summary": "播一首或一整张：关键词→最匹配一首；歌单 id/链接→整张（--shuffle）"
    },
    {
      "name": "play-ids",
      "summary": "play-ids <id,id,...> [--start N]：按输入顺序整列替换，1 基起点默认 1；保留重复项，选中歌不可播则保留旧队列；关闭随机"
    },
    {
      "name": "search",
      "summary": "只搜不播：列出 id/歌名/歌手/时长/是否要 VIP（--limit N / --offset N；JSON 带 total）"
    },
    {
      "name": "cover",
      "summary": "cover <歌曲关键词|id> [--download PATH] [--force]：只读查询封面，JSON 为 id/name/artist/cover；下载为 id/cover/file/bytes，最多 10 MB（10000000 字节），覆盖需 --force；所有原语歌曲对象含字符串 cover（缺失为空）"
    },
    {
      "name": "artist",
      "summary": "歌手热门分页入队播放（名字或 id；--limit N / --offset N；JSON 带 total）"
    },
    {
      "name": "album",
      "summary": "专辑按顺序分页入队播放（名字、id 或专辑链接；--limit N / --offset N；JSON 带 total）"
    },
    {
      "name": "albums",
      "summary": "只列不播：歌手的专辑（含老专辑；--limit N / --offset N；JSON 带 total）"
    },
    {
      "name": "liked",
      "summary": "分页播放「我喜欢的音乐」（--limit N / --offset N；JSON 带 total）"
    },
    {
      "name": "liked-ids",
      "summary": "只读喜欢 ID 全表；--json 为 {count,total,ids:[数字,...]}；歌曲 JSON 透传可用的布尔 liked，缺字段时用全表按 id 判定"
    },
    {
      "name": "myplaylists",
      "summary": "我的歌单（自建 + 收藏）；--limit N / --offset N 分页，collected/own 筛本页；JSON 带 total"
    },
    {
      "name": "pause",
      "summary": "暂停"
    },
    {
      "name": "resume",
      "summary": "继续播放"
    },
    {
      "name": "toggle",
      "summary": "暂停/继续切换"
    },
    {
      "name": "next",
      "summary": "下一首"
    },
    {
      "name": "prev",
      "summary": "上一首"
    },
    {
      "name": "stop",
      "summary": "停止并清空队列"
    },
    {
      "name": "clear",
      "summary": "停止并清空 mpv 和本地队列，收掉保活；配置和快照保留，可重复调用"
    },
    {
      "name": "volume",
      "summary": "读或设音量（0-130）"
    },
    {
      "name": "seek",
      "summary": "跳进度（相对秒数，如 +30）"
    },
    {
      "name": "queue",
      "summary": "看队列（mpv 真值）：每首歌名、时长，标出正在放的那首"
    },
    {
      "name": "jump",
      "summary": "跳到队列第 N 首（从 1 开始），并回读状态确认"
    },
    {
      "name": "remove",
      "summary": "remove <index>：按 queue 显示的 1 基序号删除；当前项选下一首，末尾选上一首，删空停止；同步本地文件"
    },
    {
      "name": "status",
      "summary": "当前曲目/进度/音量/队列位置（mpv 真值）；repeat_mode 为 off/list/single"
    },
    {
      "name": "lyric",
      "summary": "当前歌曲歌词（默认只显示当前句与下一句，--all 全文）"
    },
    {
      "name": "like",
      "summary": "把当前这首歌加入「我喜欢的音乐」"
    },
    {
      "name": "unlike",
      "summary": "把当前这首歌移出「我喜欢的音乐」"
    },
    {
      "name": "shuffle",
      "summary": "队列随机开/关"
    },
    {
      "name": "repeat",
      "summary": "repeat off|list|single：关闭/整列/单曲循环；on 和无参数 = list；状态追加 repeat_mode，保留旧 repeat 布尔含义"
    },
    {
      "name": "login",
      "summary": "登录（--sms 手机号+验证码两步为主力；不带参数出二维码扫码），cookie 存本机 config"
    },
    {
      "name": "setup",
      "summary": "写配置（--cookie/--quality）；不带参数打印登录办法"
    },
    {
      "name": "check",
      "summary": "只读自检：依赖、登录态、mpv 可用性、默认音质"
    },
    {
      "name": "playlist",
      "summary": "放一张歌单：名字/id/链接都行（--limit N / --offset N；JSON 带 total）"
    },
    {
      "name": "playlists",
      "summary": "搜歌单（只列不播）：id / 名字 / 曲目数 / 作者 / 是否已收藏；--limit N / --offset N，JSON 带 total"
    },
    {
      "name": "charts",
      "summary": "列排行榜（只列不播）：飙升榜 / 新歌榜 / …；--limit N / --offset N，JSON 带 total"
    },
    {
      "name": "chart",
      "summary": "放某个榜单：名字或 id（--limit N / --offset N；JSON 带 total）"
    },
    {
      "name": "myalbums",
      "summary": "我收藏的专辑（只列不播；--limit N / --offset N；JSON 带 total；id 可喂 album）"
    },
    {
      "name": "myartists",
      "summary": "我收藏的歌手（只列不播；--limit N / --offset N；JSON 带 total；id 可喂 artist）"
    },
    {
      "name": "fm",
      "summary": "私人 FM：没听过的歌，整列入队开播（--limit N）"
    },
    {
      "name": "dislike",
      "summary": "dislike [歌曲id]：私人 FM 不喜欢（fm/trash）；省略 id 用当前歌曲，只上报，不自动切歌或改队列"
    },
    {
      "name": "recent",
      "summary": "最近播放（只列不播，一周内，含播放次数；--limit N / --offset N；JSON 带 total）"
    },
    {
      "name": "replay",
      "summary": "再放一次最近第 N 首（默认 1 = 最近那首）"
    },
    {
      "name": "podcasts",
      "summary": "我的播客订阅（只列不播；--recommend 看推荐的；--limit N / --offset N；JSON 带 total）"
    },
    {
      "name": "podcast",
      "summary": "放某播客的节目（--limit N 默认 3；--offset N；名字或 id；JSON 带 total）"
    },
    {
      "name": "episode",
      "summary": "放某一期节目（节目 id 从 podcast 输出里抄）"
    },
    {
      "name": "queues",
      "summary": "看本地队列快照（每次换队列会自动留一条「上一条」）"
    },
    {
      "name": "queue-save",
      "summary": "把当前队列存成命名快照（只存歌曲列表，地址回放时重取）"
    },
    {
      "name": "queue-load",
      "summary": "载入某个命名快照（含当时位置与随机状态）"
    },
    {
      "name": "back",
      "summary": "切回上一条队列（含位置）；再 back 一次切回来"
    },
    {
      "name": "add",
      "summary": "把一首加到当前队列尾部，不动正在放的那首"
    }
  ],
  "errors": [
    "usage",
    "deps",
    "auth",
    "notfound",
    "timeout",
    "external",
    "internal"
  ],
  "requires": [
    {
      "kind": "runtime",
      "name": "node",
      "check": "which node",
      "note": "接口客户端与 mpv 控制都是 node 脚本，零 npm 依赖"
    },
    {
      "kind": "runtime",
      "name": "python3",
      "check": "which python3"
    },
    {
      "kind": "binary",
      "name": "mpv",
      "install": "brew install mpv",
      "check": "which mpv",
      "note": "真正的播放器（常驻 + unix socket 控制）"
    },
    {
      "kind": "binary",
      "name": "qrencode",
      "install": "brew install qrencode",
      "check": "which qrencode",
      "note": "只在扫码登录时用"
    }
  ],
  "config": [
    {
      "key": "cookie",
      "desc": "登录 cookie（MUSIC_U=…），由 login 命令扫码写入",
      "type": "string",
      "secret": true,
      "required": true,
      "ask": "扫码登录一次：pi-skill netease-music login",
      "note": "只存本机 local/skills/netease-music/config.json，不进共享仓库"
    },
    {
      "key": "quality",
      "desc": "音质级别：standard/higher/exhigh/lossless/hires",
      "type": "enum",
      "values": [
        "standard",
        "higher",
        "exhigh",
        "lossless",
        "hires"
      ],
      "default": "lossless"
    }
  ],
  "helpListsCommands": true,
  "probeUnknownCommand": true,
  "admin": [
    {
      "path": "scripts/install-cli.sh",
      "runner": "sh",
      "summary": "standalone 安装：不需要 Pi，把入口链接成 netease-music 并检查 node/mpv/python3"
    },
    {
      "path": "scripts/publish.sh",
      "runner": "sh",
      "summary": "发布公开镜像：测试门禁通过后把技能目录整体覆盖到 gitea 镜像仓（生成物，不在镜像仓手改）"
    }
  ]
}