想象一下凌晨三点，屏幕的荧光映在你的脸上，代码跑不通，心情正烦躁。这时候，你想听首歌。按照旧时代的惯性，你的手不得不离开键盘，抓起手机，或者用鼠标在任务栏里翻找那个红色的图标。点开App，映入眼帘的是复杂的推荐流、广告、或者是你根本不想kan的社交动态。你只是想听首歌，却被迫处理了一堆视觉噪音。Zui后你可Neng随便点了一首，思路断了心情geng乱了。

但这一切本不该发生。

现在的流程应该是这样的：你甚至不需要把视线从编辑器移开，直接在对话框里敲下一句：“帮我找几首适合深夜写代码的音乐，要那种节奏感强但不要太吵的。” 几秒钟后背景音乐自动切换，AI顺带回了一句：“为你挑选了林俊杰的《曹操》专辑，希望Neng帮你找回状态。”

没有界面切换，没有无关信息的干扰。这就是我们为什么要Zuo一个音乐CLI的初衷。CLI正在焕发新生，它不再只是极客的玩具，而是Agent与底层服务交互的Zui佳桥梁。

当AI接管操作：为什么CLI比GUIgeng“懂”Agent？

hen多人可Neng会问：现在的音乐AppZuo得那么花哨，为什么要退回到黑底白字的命令行？这难道不是历史的倒退吗？

恰恰相反。对于人类来说图形界面是直观的；但对于AI Agent来说CLI才是母语。

试想一下Ru果你让一个AI去操作一个传统的桌面音乐App，它得面对什么？成百上千个像素点、复杂的DOM树、各种弹窗、动画效果。IDE里的Agent虽然强大，但它们往往被限制在“沙盒”里不敢轻易执行危险操作，因为GUI环境太不可控了。哪怕是Zui先进的Cursor，它的Agent在处理UI交互时也显得小心翼翼，生怕点错一个按钮就导致程序崩溃。

而CLI不一样。CLI是上下文纯净的。

在终端里没有多余的UI元素，没有干扰项。正如一位资深开发者所言：CLI把“黑箱”转变成了“透明”状态。当AI Agent在终端里跑命令时每一行输出dou是日志，dou是结构化的数据。AIKe以清晰地kan到“正在创建目录”、“正在连接服务器”、“参数错误”等反馈。这种透明度让AINeng够形成完整的ReAct循环：它发出一个命令，观察输出，Ru果报错就修正参数，再重试，直到成功。这种丝滑的执行体验，是GUI环境无法提供的。

CLI命令本质上是原子化的工具。一个简单的 `ncm-cli play --song "曹操"`，对Claude、对OpenClaw里的AI，或者任何其他Agent框架来说调用方式完全一致。它不依赖任何特定的AI框架，就是一个纯粹的工具接口。这种“专注、稳定”的特性，正是Agent所需要的。

不止是播放器：CLI作为结构化的数据接口

我们Zuo的 `ncm-cli`，不仅仅是一个用来听歌的工具，geng准确地说它是网易云音乐的一个结构化数据接口。

AI需要的是Neng够直接调用的底层Neng力。我们将音乐推荐、搜索、播放控制等基础Neng力，封装成了一系列标准化的CLI指令。

这里有一个设计细节值得一提：所有命令默认输出JSON格式。

这听起来hen枯燥，但对AI来说却是福音。传统的CLI输出往往是为了让人阅读的，充满了各种修饰性的文本和格式，AI解析起来非常费劲。而JSON格式的输出极其稳定，AIKe以直接拿来用，不需要Zuo复杂的文本提取。这意味着，Agent拿到这些数据后Ke以Zuo任何事——生成图片、写分析报告、根据你的情绪发邮件，完全取决于你的想象力。

两种Skill的分工：执行与决策

为了让AIgeng好地理解音乐场景，我们设计了两个核心Skill，它们的分工非常明确：

1. netease-music-cli —— 执行层

这是给“我知道要听什么”的场景准备的。搜歌、播放、控制队列、管理歌单，直来直去。这个Skill有一个非常有意思的设计：我们没有在Skill定义里枚举所有命令，而是让AI自己去“探索”。

就像人类第一次用一个新工具一样，AI拿到任务后会先执行 `ncm-cli --help`，kankan顶层有哪些命令，再根据需要钻进具体子命令去查参数，Zui后才真正执行。这种“渐进式发现”的机制，让AI具备了极强的适应性。

2. netease-music-assistant —— 决策层

这是给“我不知道听什么”的场景准备的。这也是AIZui擅长的领域——处理模糊意图。你不是想搜索某首具体的歌，你想要的是“适合现在这个状态的音乐”。

这个Skill会先读取你的红心歌曲，分析你的偏好，然后制定多维度搜索策略。它会从歌单、专辑、单曲多个维度混合推荐，每条结果dou附带个性化的推荐理由，还会自动去重，避免推荐你Yi经收藏或近期听过的内容。

极客的仪式感：TUI播放器的魅力

虽然我们强调CLI的自动化Neng力，但这并不意味着我们要牺牲视觉体验。相反，我们在终端里构建了一种独特的“仪式感”。

这就是我们的 TUI播放器。

当你输入 `ncm-cli tui` 启动它时你会kan到一个黑胶唱片的旋转动画，卡拉OK风格的歌词会随着音乐同步滚动，场景切换流畅自然。在黑底白字的终端里kan到这些动态效果，有一种莫名的复古美感。

TUI有一个特性特别适合Agent：它Ke以和CLI命令同时工作。当TUI正在跑着的时候，你仍然Ke以在另一个终端执行 `ncm-cli next` 切歌，或者 `ncm-cli volume 50` 调节音量，TUI界面会实时响应。这对AI Agent来说尤为自然——Agent发出的命令和人在TUI里的操作是完全对等的。App没有被取代，它只是获得了一个新的、geng极客的控制界面。

打破静态桎梏：动态命令系统

传统CLI有一个固有限制：命令是编译进代码里的。Ru果你想加一个新功Neng，必须改代码、发版、等用户升级。整条链路hen长，极其笨重。

但工具的迭代速度必须跟上AI的思考速度。因此，`ncm-cli` 引入了一套动态命令系统。核心思想hen简单：把命令的定义从代码里移到服务端。

当CLI启动时它会向服务端发送一次同步请求，告知“我本地Yi经缓存了哪些命令的哪个版本”。服务端只返回有变化的部分，CLI用这些增量数据在本地重建命令树。

这个设计带来了两个巨大的好处：

第一，Skill定义本身不需要随命令的增减而频繁geng新；

第二，业务团队Ke以独立地添加、修改、下线命令，用户完全不需要升级客户端，下次启动就Neng用到新功Neng。CLI从一个静态工具，变成了一个持续生长的命令执行引擎。AI下次通过 `--help` 查询时就Neng自动发现并使用这些新命令，整条链路不需要任何人工介入。

实战场景：当音乐成为工作流的一部分

说了这么多技术细节，让我们回到实际体验中。`ncm-cli` 结合 OpenClaw 生态，究竟Neng带来什么改变？

场景一：深夜 Vibe Coding

这是我Zui喜欢的场景。深夜写代码，思路卡住了想换首歌提提神。Ru果是以前，手离开键盘 -> 拿手机 -> 解锁 -> 打开App -> 漫无目的地刷推荐 -> 心情geng烦躁。现在呢？你在IDE的对话框里顺手发一句：“帮我找几首适合深夜写代码的音乐。”

AI处理完，BGM自动切了还附了一句推荐理由：“这首曲子节奏平稳，适合专注。” 你甚至没有离开编辑器，心流状态得以保持。

场景二：跨设备的奇妙联动

音乐操作有一个天然的特点：输入和输出分离。你用手机发消息，电脑放音乐。OpenClaw 的跨设备特性和这个场景完美契合。

安装 OpenClaw 并连接你的飞书等IM软件后你就Ke以从手机随时控制电脑上的音乐播放。你在飞书里办公了半天想kankan照片让眼睛放松下直接发一句：“用我的红心歌单帮我生成一个照片墙。”

这个请求kan起来和音乐播放没什么关系，但它展示了Agent模式geng大的想象空间。AI调用了你的音乐数据，分析了你的审美偏好，然后结合其他工具生成了图片。这就是 `ncm-cli` 作为数据接口的价值所在。

如何开始？

Ru果你也想体验这种Agent时代的音乐交互方式，上手非常简单。

你需要安装 `ncm-cli`：

npm install -g @music163/ncm-cli

然后前往网易云音乐开放平台完成入驻并获取API凭证，运行配置向导：

ncm-cli configure   # 配置凭证
ncm-cli login       # 扫码登录

接下来你就Ke以尽情玩耍了。启动TUI播放器：

ncm-cli tui

或者，Ru果你Yi经安装了OpenClaw，Ke以直接添加Skill：

npx skills add https://github.com/NetEase/skills

安装后直接在Claude Code或你的IM对话框里像和朋友聊天一样指挥你的音乐播放吧。

让音乐回归“被找到”的本质

Zuo这件事的初衷hen简单：“合适的”音乐应该geng容易“被找到”。

我们厌倦了在推荐算法和自己的犹豫之间拉锯，厌倦了为了听首歌而不得不忍受的复杂界面。AI Agent提供了一个新的可Neng性——用自然语言表达当下的状态，让AI替你Zuo决策，而CLI则是连接意图与执行的Zui高效路径。

当然`ncm-cli` 只是我们探索这个方向的一个起点，还有hen多没Zuo好的地方。比如命令覆盖范围的选取，我们不是从“用户会点哪些按钮”出发，而是从“AI完成一个音乐任务需要哪些原子操作”出发。这中间的平衡，还需要不断的打磨。

我们欢迎大家让我们一起重新定义工具的形态。

---