Mode d’emploi
- Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
- Consultez le document original pour les outils, identifiants et environnements requis.
- Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/netease/skills --skill ncm-cli-setupAvant de commencer
- L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
- Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Document Skill original
Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.
ncm-cli 安装配置
ncm-cli 是网易云音乐的 CLI 工具（音乐搜索、播放控制、歌单管理、TUI 播放器）。
安装流程
第一步：安装 ncm-cli、mpv
1.1 安装 ncm-cli
bash
npm install -g @music163/ncm-cli验证安装：
bash
ncm-cli --version1.2 安装 mpv
播放功能需要 mpv 播放器。先检测是否已安装：
bash
mpv --versionmacOS / Windows：若未安装，直接执行安装脚本：
bash
python3 scripts/install_mpv.pyLinux：询问用户是否需要播放功能：
- 如果是桌面环境、需要本地播放 → 执行
python3 scripts/install_mpv.py - 如果是服务器环境、不需要播放 → 跳过，搜索/歌单等命令仍可正常使用
安装脚本会自动识别包管理器：
- macOS：Homebrew（
brew install mpv）或 MacPorts - Linux：apt / dnf / pacman / zypper
- Windows：winget / Chocolatey / Scoop
第二步：配置 API Key
使用 ncm-cli 需要先设置API Key：
bash
ncm-cli config set appId <你的AppId>
ncm-cli config set privateKey <你的PrivateKey>如果还没有 API Key，请先前往网易云音乐开放平台申请 API Key（appId 和 privateKey）。
第三步：配置默认播放器
询问用户选择默认播放器：
- mpv（内置播放器）：轻量、跨平台，需先完成第一步中的 mpv 安装
- orpheus（云音乐 App）：调用本地网易云音乐客户端播放，仅支持 macOS
根据用户选择执行：
bash
ncm-cli config set player mpv # 选择内置播放器
ncm-cli config set player orpheus # 选择云音乐 App第四步：登录
登录是必须的，请使用：
bash
ncm-cli login --background常见问题
| 问题 | 解决方法 |
|---|---|
ncm-cli: command not found | 检查 npm 全局 bin 是否在 PATH 中：npm bin -g |
mpv not found | 重新运行 python3 scripts/install_mpv.py 或手动安装：https://mpv.io |
| 登录超时 | 重新执行 ncm-cli login --background |
基本信息
- 需要 Node.js >= 18
