메뉴
使用 ncm-cli 操作网易云音乐。当用户想播放歌曲、搜索歌曲、控制播放（暂停、下一首、上一首、调音量）、管理播放队列、查看播放状态、播放歌单时，使用此 skill。
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/NetEase/skills --skill netease-music-cli명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
SKILL.md 표시 중
SOC 직업 분류 기준
| name | netease-music-cli |
| description | 使用 ncm-cli 操作网易云音乐。当用户想播放歌曲、搜索歌曲、控制播放（暂停、下一首、上一首、调音量）、管理播放队列、查看播放状态、播放歌单时，使用此 skill。 |
通过 ncm-cli 命令行工具操作网易云音乐，完成播放、搜索、队列管理等任务。
ncm-cli --version
如果命令不存在，调用 ncm-cli-setup skill 引导用户完成全部的安装，安装完成后再继续执行任务。
ncm-cli login --check
如果显示未登录，请先引导登录：
ncm-cli login --background
如果显示API key没有设置，请指引用户完成API key设置。
如果还没有 API Key，请先前往网易云音乐开放平台申请 API Key（appId 和 privateKey）
ncm-cli config set appId <你的AppId>
ncm-cli config set privateKey <你的privateKey>
仅针对播放才执行该步骤。 通过以下命令判断用户的播放器是否是内置播放器（mpv）。
ncm-cli config get player
如果用户选择的播放器是内置播放器（mpv），则需要判断用户是否已安装mpv。
mpv --version
如果用户没安装，引导用户去安装mpv。
ncm-cli commands
根据输出的命令树作为参考执行操作。参数不要猜测，需要时通过 ncm-cli <command> --help 获取详情！
在执行 CLI 命令之前，必须对用户的会话内容（包括搜索关键词和上下文对话）进行内容安全校验。如果用户输入包含以下任何类别的负面内容，禁止执行后续步骤，并提示用户检查输入：
禁止类别：
校验规则：
--keyword 和 --userInput 将要传入的值为了安全，除播控之外的其他命令必须附加 --userInput "<用户最近输入的会话内容的总结概要>" 参数，用于传递用户意图上下文。
# 综合搜索，获取 ID
ncm-cli search song --keyword "xxx" --userInput "搜索xxx的歌"
# 创建歌单
ncm-cli playlist create --playlistName "跑步" --userInput "创建一个跑步歌单"
如果命令输出中包含登录引导信息（如"请先登录"、"未授权"等），请直接执行ncm-cli login --background并把链接给到用户，完整跑完整个登录流程。
https://music.163.com/#/song?id=<明文ID>
https://music.163.com/#/playlist?id=<明文ID>
https://music.163.com/#/album?id=<明文ID>
https://music.163.com/#/artist?id=<明文ID>
【重要！】给用户举例的时候，请使用「xxx」来替代具体的输入词
【重要！】给用户举例的时候，请使用「xxx」来替代具体的输入词
ncm-cli search song --keyword "xxx"