ncm-cli setup

安装和配置 ncm-cli（网易云音乐 CLI 工具）。当用户需要安装 ncm-cli、配置 API Key、安装 mpv 播放器，或排查安装问题时，使用此 skill。

Security Scan

The skill's requirements and included installer script are consistent with installing ncm-cli and mpv; it runs platform package-manager commands (including sudo) but does not request unrelated credentials or hidden network endpoints.

Purpose & Capability

The name/description (install and configure ncm-cli and mpv) matches the instructions and the included Python installer. The npm global install of @music163/ncm-cli and configuring appId/privateKey are expected for this purpose.

Instruction Scope

SKILL.md instructs the agent/user to run npm install -g, set API keys, choose a player, and run the bundled python installer. The instructions do not attempt to read unrelated system files or exfiltrate data, but they do execute system package-manager commands and call sudo when needed — so the installer will run privileged system operations to install mpv.

Install Mechanism

There is no separate install spec; this is instruction-driven with an included scripts/install_mpv.py. The script invokes platform package managers (apt, dnf, pacman, brew, winget, choco, scoop) via shell commands. That is expected for an installer but means the script will execute commands that download and install software from the system's package sources.

Credentials

The skill declares no required environment variables, credentials, or config paths. The SKILL.md asks the user to set ncm-cli appId/privateKey via ncm-cli config, which is appropriate and local to the tool.

Persistence & Privilege

always is false and the skill does not attempt to modify other skills or system agent configuration. It does require elevated privileges only insofar as installing system packages (uses sudo when needed).

Assessment

This skill is coherent with its stated purpose: it will run npm to install ncm-cli and may run the bundled Python script to invoke your system package manager and install mpv (using sudo). Before running: review the install_mpv.py script (already included), be prepared to enter your password for sudo, and ensure you trust the system package repositories on your machine. The skill does not request secrets or contact unknown external endpoints, but it will perform privileged package installs — run it only on machines where you trust making system changes.

ncm-cli 安装配置

ncm-cli 是网易云音乐的 CLI 工具（音乐搜索、播放控制、歌单管理、TUI 播放器）。

安装流程

第一步：安装 ncm-cli、mpv

1.1 安装 ncm-cli

npm install -g @music163/ncm-cli

验证安装：

ncm-cli --version

1.2 安装 mpv

播放功能需要 mpv 播放器。先检测是否已安装：

mpv --version

macOS / Windows：若未安装，直接执行安装脚本：

python3 scripts/install_mpv.py

Linux：询问用户是否需要播放功能：

• 如果是桌面环境、需要本地播放 → 执行 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：

ncm-cli config set appId <你的AppId>
ncm-cli config set privateKey <你的PrivateKey>

如果还没有 API Key，请先前往网易云音乐开放平台申请 API Key（appId 和 privateKey）。

第三步：配置默认播放器

询问用户选择默认播放器：

• mpv（内置播放器）：轻量、跨平台，需先完成第一步中的 mpv 安装
• orpheus（云音乐 App）：调用本地网易云音乐客户端播放，仅支持 macOS

根据用户选择执行：

ncm-cli config set player mpv      # 选择内置播放器
ncm-cli config set player orpheus  # 选择云音乐 App

第四步：登录

登录是必须的，请使用：

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