القائمة
安装和配置 ncm-cli（网易云音乐 CLI 工具）。当用户需要安装 ncm-cli、配置 API Key、安装 mpv 播放器，或排查安装问题时，使用此 skill。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
网易云音乐智能助手，以模型判断为核心，通过 ncm-cli 执行操作。 核心能力：分析用户红心歌单偏好画像、制定多关键词搜索策略、智能推荐歌单/专辑/单曲（含两层推荐说明）、播放控制（播放/暂停/下一首/音量/队列）、管理定时推送调度、通过 OpenClaw 向飞书等 IM 渠道推送推荐结果、创建并写入歌单。 触发时机（满足任意一条即激活）： - 消息中含"网易云"或"云音乐" - 用户想听歌、要歌单推荐、找某类型音乐 - 用户想分析自己的音乐偏好或红心记录
使用 ncm-cli 操作网易云音乐。当用户想播放歌曲、搜索歌曲、控制播放（暂停、下一首、上一首、调音量）、管理播放队列、查看播放状态、播放歌单时，使用此 skill。
استنادا إلى تصنيف SOC المهني
| name | ncm-cli-setup |
| description | 安装和配置 ncm-cli（网易云音乐 CLI 工具）。当用户需要安装 ncm-cli、配置 API Key、安装 mpv 播放器，或排查安装问题时，使用此 skill。 |
ncm-cli 是网易云音乐的 CLI 工具（音乐搜索、播放控制、歌单管理、TUI 播放器）。
npm install -g @music163/ncm-cli
验证安装：
ncm-cli --version
播放功能需要 mpv 播放器。先检测是否已安装：
mpv --version
macOS / Windows：若未安装，直接执行安装脚本：
python3 scripts/install_mpv.py
Linux：询问用户是否需要播放功能：
python3 scripts/install_mpv.py安装脚本会自动识别包管理器：
brew install mpv）或 MacPorts使用 ncm-cli 需要先设置API Key：
ncm-cli config set appId <你的AppId>
ncm-cli config set privateKey <你的PrivateKey>
如果还没有 API Key，请先前往网易云音乐开放平台申请 API Key（appId 和 privateKey）。
询问用户选择默认播放器：
根据用户选择执行：
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 |