AIKraft/AI/Войти
AIKraft/Skills/Настройка NCM CLI

Настройка NCM CLI

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

netease official Разработка

Что делает навык

Навык устанавливает и настраивает ncm-cli — CLI-инструмент для поиска музыки, управления плейлистами и воспроизведения через TUI. Он также обеспечивает установку зависимостей (mpv), настройку API-ключей от NetEase Cloud Music и выбор плеера.

Когда применять

  • Пользователю нужно установить ncm-cli на систему с Node.js >= 18.
  • Требуется настроить API Key (appId и privateKey) для работы с сервисом.
  • Необходимо установить плеер mpv для локального воспроизведения музыки.
  • Пользователь хочет выбрать между встроенным плеером mpv или клиентом orpheus.
  • Возникла ошибка 'ncm-cli: command not found' или 'mpv not found' при запуске.

Как работает

  1. Установить ncm-cli глобально через npm (npm install -g @music163/ncm-cli) и проверить версию.
  2. Установить mpv: на macOS/Windows выполнить python3 scripts/install_mpv.py, на Linux определить тип среды (десктоп/сервер) и при необходимости запустить скрипт установки.
  3. Настроить API Key, запросив у пользователя appId и privateKey, и выполнить ncm-cli config set для обоих параметров.
  4. Уточнить у пользователя выбор плеера (mpv или orpheus) и выполнить соответствующую команду ncm-cli config set player.
  5. Выполнить вход в систему командой ncm-cli login --background.
  6. При ошибках проверки PATH или отсутствия mpv выполнить рекомендации по исправлению (npm bin -g или повторный запуск скрипта).

Примеры запросов агенту

Установи ncm-cli и настрой его для работы с моим аккаунтом.
Как установить mpv для ncm-cli на Linux сервере?
Помоги настроить API Key и выбрать плеер orpheus для ncm-cli.

Что понадобится

  • Node.js >= 18
  • API Key (appId и privateKey) от NetEase Cloud Music
  • mpv (для локального воспроизведения)

Описание составлено по SKILL.md навыка, сверено 06.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «ncm-cli-setup» из репозитория: # https://github.com/netease/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r ncm-cli-setup/ ~/.claude/skills/ncm-cli-setup/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.