Musio：一个越用越懂你的 Agent
很多音乐产品都能播放歌曲，也能搜索歌名、查看歌词、收藏歌单。但当我们真正听音乐时，需求往往不是一个个孤立按钮，而是一连串自然的想法：
给我推荐几首适合深夜写代码听的歌。
看看这首歌评论区都在聊什么。
把当前播放的歌曲加入歌单。
再给我找几首类似但不要重复刚才的。
这正是 Musio 想解决的问题。
Musio 是一个本地优先的音乐 Agent。它会在本机启动音乐源适配器、Spring Boot 后端、React Web 控制台和 Java CLI，让用户可以通过网页或命令行连接音乐源、搜索歌曲、播放音乐、查看歌词和
评论，并让 Agent 基于本地记忆和真实音乐能力完成推荐、歌单和对话任务。
项目地址：https://github.com/mindforge-x/musio
不只是播放器，而是会执行音乐任务的 Agent
传统播放器更像一个工具箱：搜索是搜索，播放是播放，歌词是歌词，歌单是歌单。
Musio 更像一个音乐工作台里的 Agent。你可以用自然语言提出目标，它会判断下一步该调用什么能力：
- 需要推荐时，调用推荐能力。
- 需要真实歌曲时，去音乐源中搜索和匹配。
- 需要歌词时，读取歌词。
- 需要评论时，读取热门评论。
- 需要收藏时，先请求确认，再写入本地 Musio 歌单。
也就是说，Musio 不只是“回答你”，而是会把音乐任务拆成步骤并执行。
Musio 现有的 Agent 特性
1. 场景化推荐
你可以直接说：
给我推荐 5 首适合深夜写代码听的歌。
Musio 会根据场景、风格、心情或结构化目标生成候选歌曲，再到音乐源中匹配真实歌曲，避免只生成一段看起来合理但无法播放的文字。
2. 理解上下文
Musio 能理解音乐对话里常见的指代：
- “当前播放的歌”
- “刚才推荐的那首”
- “第一首”
- “这几首”
- “队列上一首”
这让连续对话更自然。你不需要每次都完整输入歌名和歌手，Agent 会结合当前播放状态、短期任务记忆和本轮工具结果判断目标。
3. 读取真实音乐信息
Musio 当前支持围绕真实音乐源执行多种读取能力：
- 搜索歌曲、歌手、专辑
- 获取歌曲详情
- 获取播放地址
- 查看歌词
- 查看热门评论
- 读取用户歌单
- 读取歌单歌曲
这些能力让 Musio 的回答不只是大模型生成，而是建立在真实音乐数据之上。
4. 本地音乐画像和记忆
Musio 会围绕本地环境维护音乐记忆，例如近期推荐结果、上轮任务、用户音乐画像和当前播放器状态。
这使得 Agent 可以避免重复推荐，也可以在用户继续追问时接上上下文。
比如你可以先说：
推荐几首适合通勤听的歌。
然后继续说：
第二首的歌词给我看看。
把这几首加入歌单。
Musio 会知道你在说哪几首。
5. 写入前确认，避免误操作
对于“收藏”“保存”“加入歌单”这类写入动作，Musio 会先展示确认流程。确认后才会写入本地 Musio 歌单。
这点很重要：Agent 可以帮你操作，但不应该在关键写入动作上擅自执行。
Musio 当前的歌单写入是本地 Musio 歌单写入，不会冒充 QQ 音乐账号收藏，也不会把本地操作说成账号级操作。
6. 可见的执行过程
Musio 的前端会展示 Agent 执行过程，例如：
- 正在理解请求
- 正在读取记忆
- 正在调用音乐能力
- 正在等待确认
- 正在整理回答
这让 Agent 不再是一个黑盒。用户可以看到它到底在做什么，也能更放心地把音乐任务交给它。
本地优先的架构
Musio 的一个重要特点是本地优先。
它的核心组件包括：
- backend-spring/：Spring Boot API、Agent Runtime、配置、记忆和音乐接口
- frontend/：React + Vite Web 控制台
- cli-java/：Java CLI、本地服务启动器和诊断命令
- providers/qqmusic-python-sidecar/：QQ 音乐 Python HTTP sidecar
- packaging/：npm 平台包和发布包构建脚本
当前实现优先支持 QQ 音乐，后续可以扩展更多音乐源，例如网易云音乐和本地音乐库。
快速体验
如果使用发布包，可以通过 npm 安装：
npminstall-g@mindforge-x/musio musio也可以从源码运行：
gitclone https://github.com/mindforge-x/musio.gitcdmusio ./scripts/dev.sh启动后，Musio 会打开本地 Web 控制台，你可以登录音乐源并开始和 Agent 对话。
为什么值得关注
Musio 的价值不在于“又做了一个播放器”，而在于它把播放器变成了一个可以被 Agent 驱动的音乐环境。
它知道你正在听什么，知道刚才推荐过什么，能读取歌词和评论，能搜索真实歌曲，也能在确认后帮你整理本地歌单。
这让音乐体验从“点按钮”变成了“表达意图”。
总结
Musio 是一个面向个人音乐场景的本地 Agent。它把音乐源、播放器、记忆系统、工具调用和大模型规划连接在一起，让自然语言真正参与到音乐使用流程中。
如果你想体验一个会理解上下文、会调用真实音乐能力、会记住偏好，并且能帮你整理音乐任务的本地音乐 Agent，或者想学习agent那么 Musio 非常值得一试：
https://github.com/mindforge-x/musio
