核心用法
网易云音乐 CLI（ncm-cli）是一款命令行音乐工具，通过终端指令完成网易云音乐的全流程操作。使用前需完成三重准备：安装工具、申请开放平台 API Key（appId + privateKey）、登录账号。核心工作流涵盖六大步骤：版本检查→登录校验→播放器配置（如使用内置 mpv）→命令树获取→内容安全过滤→最终命令执行。
典型操作示例：
- 搜索：
ncm-cli search song --keyword "xxx" - 播放控制：支持暂停、下一首、音量调节等标准播控
- 歌单管理：创建、查看、播放歌单及队列管理
显著优点
- 纯命令流操作：无需打开浏览器或客户端，适合开发者/效率用户
- 完整功能覆盖：集成搜索、播放、歌单、队列、状态查询于一体
- 开源生态：依托 ncm-cli 社区，持续迭代
潜在局限
- 配置门槛高：必须手动申请网易云音乐开放平台 API Key，流程繁琐
- 依赖外部播放器：非内置播放器需额外安装 mpv，增加环境复杂度
- ID 体系复杂：需区分加密 ID（API 用）与明文 ID（链接用），易混淆
- visible 字段限制：部分歌曲因版权不可播放，需额外判断
- 请求总量限制：API 有调用上限，超限即终止服务
适合人群
- 熟悉命令行操作的开发者与高级用户
- 追求效率、偏好键盘驱动工作流的音乐爱好者
- 需要脚本化音乐管理的自动化场景
常规风险
- 内容安全合规：强制内置政治、色情、谩骂等 5 类敏感词过滤，违规输入直接拦截
- API 授权风险：Key 泄露可能导致账号封禁或调用配额耗尽
- 版权播放限制：visible=false 的歌曲无法播放，需向用户明确说明
- 登录态失效：需处理登录过期后的重新授权流程