技能介绍

你要解决什么问题

私有音乐库往往散落在多台设备上：本地硬盘、NAS、旧笔记本。手动整理曲库、同步播放列表、跨终端续播，是一件反复且琐碎的事。对 AI Agent 来说，音乐服务器缺少一个可编程入口——聊天窗口里的 Agent 想帮你「找一首适合深夜加班的歌」，却连你的曲库里有什么都不知道。这个技能解决的问题，就是给 Agent 接上一个统一的控制面，让它能读取并操作你自托管的音乐库。

技能如何工作

Navidrome 本身是一个自托管的音乐流媒体服务器，兼容 Subsonic API，同时提供自有的 REST 端点。这个技能把两者封装成 Agent 可调用的能力：

曲库管理：扫描并维护音乐库元数据，Agent 可以按歌手、专辑、年份等维度浏览你的收藏。
歌单操作：读取现有歌单，或根据自然语言描述（比如“适合跑步的电子乐”）创建新歌单。
播放控制：下发播放、暂停、跳过、随机播放等指令，覆盖当前会话或指定设备。
搜索与检索：在曲库中搜索歌曲、专辑、艺人，返回可执行的结果。

关键工作路径是：用户在对话中提出音乐相关意图 → Agent 通过 Subsonic 兼容接口或 REST 端点调用对应操作 → 服务器在自托管环境内执行并返回结果。底层服务支持 macOS、Linux、Windows 直接运行，也提供 Docker 镜像部署。

适用边界与注意点

这个技能面向自托管场景。你需要先有一个可访问的 Navidrome 实例；云端托管方案仅作为可选替代，并不改变技能本身的接口逻辑。API 兼容性以 Navidrome 实现的 Subsonic 协议为准，部分高级功能在不同服务器版本中行为可能不一致。另外，曲库规模较大时，首次扫描和元数据抓取会有明显延迟，Agent 的搜索结果依赖服务器已完成的索引状态。