從兩個(gè)場(chǎng)景說起

第一個(gè)場(chǎng)景：深夜vibe coding，想換首歌。

往常的流程是：手從鍵盤移開，切到手機(jī)App / 桌面App，刷一下推薦，三首都不對(duì)感覺，思路斷了，算了隨便放著。現(xiàn)在的流程是：在對(duì)話框里順手發(fā)一句「幫我找?guī)资走m合深夜寫代碼的音樂」，AI 處理完，BGM 切了，附了一句推薦理由，你甚至沒有離開編輯器。

第二個(gè)場(chǎng)景：用飛書辦公了半天，想看看照片讓眼睛放松下。

直接在飛書發(fā)一句「用我的紅心歌單幫我生成一個(gè)照片墻」。于是出現(xiàn)下圖。

這就是ncm-cli 加上 OpenClaw 今天能做到的事。

“不知道聽什么”一直是個(gè)痛點(diǎn)，直到OpenClaw 出現(xiàn)

如大家所知，OpenClaw 代表著 Agent 交互方式的一個(gè)轉(zhuǎn)折點(diǎn)：AI 不再只是瀏覽器里的對(duì)話界面，它可以是你 IM 里隨時(shí)響應(yīng)的助手，在你的機(jī)器上執(zhí)行真實(shí)的操作。

我們意識(shí)到，在這個(gè)背景下，音樂是一個(gè)非常適合驗(yàn)證這個(gè)范式的場(chǎng)景

為什么？因?yàn)椤覆恢缆犑裁础故俏覀內(nèi)粘Ｓ龅阶畹湫偷哪：鈭D之一——你不是想搜索某首具體的歌，你想要的是「適合現(xiàn)在這個(gè)狀態(tài)的音樂」。這種模糊意圖，正是 AI 擅長處理的，用傳統(tǒng)搜索界面反而別扭。

而且音樂操作有一個(gè)天然的特點(diǎn)：輸入和輸出分離。你用手機(jī)發(fā)消息（輸入），電腦放音樂（輸出）。OpenClaw 的跨設(shè)備特性和這個(gè)場(chǎng)景完美契合。

我們是怎么思考工具形態(tài)的

確定這件事值得做之后，第一個(gè)問題是：做成什么形態(tài)？

App 不合適——要維護(hù) UI，更新重，和 AI Agent 集成反而繞了一圈。插件或 SDK 依賴特定平臺(tái)，換一個(gè) Agent 就要重做。

我們選擇了CLI。

這個(gè)判斷背后有一個(gè)很直接的邏輯：CLI 命令是 AI Agent 最天然的工具調(diào)用形式。一個(gè)ncm-cli play --song xxx的命令，對(duì)Claude、OpenClaw 里的 AI、或者任何其他 Agent 框架來說，調(diào)用方式完全一樣。CLI 本身不依賴任何 AI 框架，它就是一個(gè)能被任何東西調(diào)用的原子工具。

同時(shí)，CLI 也保留了「直接用」的可能性——人工輸入命令、Shell 腳本集成、自動(dòng)化流水線，都沒問題。

基于這個(gè)形態(tài)，我們還設(shè)計(jì)了兩個(gè)Skill去真正的融入到Agent中：

netease-music-cli—— 適合「我知道要聽什么」的場(chǎng)景。搜歌、播放、控制隊(duì)列、管理歌單，直來直去。

這個(gè)Skill 有一個(gè)有意思的設(shè)計(jì)：我們沒有在Skill 定義里枚舉所有命令，而是讓 AI 自己通過--help去漸進(jìn)式發(fā)現(xiàn)。

AI 拿到任務(wù)后，會(huì)先執(zhí)行ncm-cli --help看頂層有什么，再根據(jù)需要鉆進(jìn)具體子命令查參數(shù)，最后再執(zhí)行。整個(gè)過程和人第一次用一個(gè)新CLI 工具的探索方式完全一樣。

這個(gè)設(shè)計(jì)有兩個(gè)好處：一是Skill 定義本身不需要隨命令的增減而更新；二是和后面將要介紹的動(dòng)態(tài)命令系統(tǒng)形成了自然的協(xié)同——服務(wù)端新下發(fā)了一個(gè)命令，AI 下次就能通過--help發(fā)現(xiàn)并使用它，整條鏈路都不需要人工介入。

netease-music-assistant—— 適合「我不知道聽什么」的場(chǎng)景。它會(huì)先讀取你的紅心歌曲，分析你的偏好（曲風(fēng)、情緒、時(shí)間段習(xí)慣），然后制定多維度搜索策略，從歌單、專輯、單曲多個(gè)維度混合推薦，每條結(jié)果都附帶個(gè)性化的推薦理由，還會(huì)自動(dòng)去重（不重復(fù)推薦你已經(jīng)收藏或近期推薦過的內(nèi)容）。

兩個(gè)Skill 的分工很清晰：前者是執(zhí)行層，后者是決策層。

我們做了什么

ncm-cli 支持三種使用方式：

命令設(shè)計(jì)：不是從按鈕出發(fā)，從AI“原子操作” 的視角出發(fā)

命令覆蓋范圍的選取，我們不是從「用戶會(huì)點(diǎn)哪些按鈕」出發(fā)，而是從「AI 完成一個(gè)音樂任務(wù)需要哪些原子操作」出發(fā)。

AI 處理一個(gè)請(qǐng)求，本質(zhì)上是一個(gè)多步推理 + 執(zhí)行的過程。以「幫我播放一首適合現(xiàn)在心情的歌」為例，AI 需要能做這些事：

圍繞這個(gè)流程，我們把命令分成了幾個(gè)層次：

另外有一個(gè)細(xì)節(jié)值得一提：所有命令默認(rèn)輸出JSON，格式穩(wěn)定，AI 可以直接解析，不需要做文本解析。

動(dòng)態(tài)命令：讓CLI 保持「活」的

傳統(tǒng)CLI 有一個(gè)固有限制：命令是編譯進(jìn)代碼的，新增一個(gè)功能，必須改代碼、發(fā)版、等用戶升級(jí)，整條鏈路很長。

ncm-cli 引入了一套動(dòng)態(tài)命令系統(tǒng)，核心思想是：把命令的定義從代碼里移到服務(wù)端

傳統(tǒng)CLI的發(fā)版鏈路：

動(dòng)態(tài)命令的更新流程：

CLI 啟動(dòng)時(shí)，會(huì)向服務(wù)端發(fā)送一次同步請(qǐng)求，告知「我本地已經(jīng)緩存了哪些命令的哪個(gè)版本」。服務(wù)端只返回有變化的部分，CLI 用這些增量數(shù)據(jù)在本地重建命令樹。

效果是：業(yè)務(wù)團(tuán)隊(duì)可以獨(dú)立地添加、修改、下線命令，用戶不需要升級(jí)客戶端，下次啟動(dòng)就能用到新功能。CLI 從一個(gè)靜態(tài)工具變成了一個(gè)持續(xù)生長的命令執(zhí)行引擎。

播放形態(tài)

播放后端支持兩種：

內(nèi)置播放器（mpv）：跨平臺(tái)，macOS/Linux/Windows 均可用。即使沒有安裝網(wǎng)易云音樂客戶端，也能直接播起來。

網(wǎng)易云音樂桌面客戶端：這個(gè)模式帶來了一種不同的體驗(yàn)——AI 操控的不是一個(gè)獨(dú)立的播放進(jìn)程，而是你已經(jīng)安裝的那個(gè) App 本身。技術(shù)上，ncm-cli 通過orpheus://URL Scheme 向客戶端發(fā)送指令，客戶端后臺(tái)常駐進(jìn)程監(jiān)聽并響應(yīng)。App 沒有運(yùn)行時(shí)會(huì)自動(dòng)啟動(dòng)。這意味著：你對(duì) AI 說「幫我播放林俊杰的曹操專輯」，打開的是完整的網(wǎng)易云音樂界面——專輯封面、歌詞、音質(zhì)、紅心、社交……全套 App 體驗(yàn)，只是控制方式從點(diǎn)擊變成了自然語言。App 沒有被取代，它獲得了一個(gè)新的控制界面。

TUI 播放器是我們比較喜歡的功能之一——黑膠旋轉(zhuǎn)動(dòng)畫、卡拉 OK 風(fēng)格歌詞同步、場(chǎng)景切換，在終端里有一種莫名的儀式感。

TUI 有一個(gè)值得一說的特性：它可以和CLI 命令同時(shí)工作。TUI 跑著的時(shí)候，你仍然可以在另一個(gè)終端執(zhí)行ncm-cli next、ncm-cli volume 80，TUI 界面會(huì)實(shí)時(shí)響應(yīng)。這對(duì) AI Agent 來說尤為自然——Agent 發(fā)出的命令和人在 TUI 里的操作是完全對(duì)等的。

怎么用

詳細(xì)使用指南見：網(wǎng)易云音樂CLI 使用指南

首先你需要安裝ncm-cli:

npm install -g @music163/ncm-cli

前往網(wǎng)易云音樂開放平臺(tái)完成入駐并獲取API 憑證，然后運(yùn)行配置向?qū)В?/p>

ncm-cli configure

接下來就可以使用了。有多種使用方式：

方式一：OpenClaw

詳細(xì)教程見：OpenClaw ncm-cli 快速上手指南

安裝OpenClaw 并連接你的飛書等IM軟件，然后安裝我們提供的skill：https://github.com/NetEase/skills，之后你就可以從手機(jī)隨時(shí)控制電腦上的音樂播放。

這種方式最適合日常使用：不需要打開終端，不需要記命令，用IM 發(fā)消息就好。

一個(gè)有趣的例子：你在飛書發(fā)一句「用我的紅心歌單幫我生成一個(gè)照片墻」。

這個(gè)請(qǐng)求看起來和音樂播放沒什么關(guān)系，但它展示了Agent 模式更大的想象空間——

ncm-cli 在這里不只是播放工具，而是音樂數(shù)據(jù)的結(jié)構(gòu)化接口。Agent 拿到這些數(shù)據(jù)之后，可以做任何事——生成圖片、寫報(bào)告、分析偏好、發(fā)郵件，取決于你的想象力和 Agent 能調(diào)用的其他工具。

這是CLI 作為 Agent 工具的核心價(jià)值：一個(gè)專注、穩(wěn)定的數(shù)據(jù)和控制接口，Agent 決定怎么用它

方式二：Claude Code Skills

npx skills add

https://github.com/NetEase/skills

安裝后，直接在Claude Code 對(duì)話：

> 幫我推薦幾首適合專注的純音樂

> 播放我最近聽的歌曲

> 下一首

> 把這首歌加到紅心

方式三：直接CLI

npm install -g @music/ncm-cli

ncm-cli configure # 配置憑證

ncm-cli login # 掃碼登錄

ncm-cli tui # 啟動(dòng) TUI 播放器

歡迎反饋

做這件事的初衷很簡單：「合適的」音樂應(yīng)該更容易「被找到」，而不是每次都要在推薦算法和自己的猶豫之間拉鋸。AI Agent 提供了一個(gè)新的可能性——用自然語言表達(dá)當(dāng)下的狀態(tài)，讓 AI 替你做決策。

ncm-cli 是我們探索這個(gè)方向的一個(gè)起點(diǎn)，還有很多沒做好的地方。

幾個(gè)問題想聽聽大家的想法：

你日常聽歌的「痛點(diǎn)」是什么？是找歌難，還是管理歌單煩，還是別的？

如果AI 能更主動(dòng)地介入你的聽歌體驗(yàn)（比如感知你的狀態(tài)、主動(dòng)推薦），你希望它怎么做，又不希望它怎么做？

如果你有技術(shù)背景，有沒有想貢獻(xiàn)的方向？

歡迎在評(píng)論區(qū)聊，也歡迎到GitHub 提 issue。