Agent Skills
返回列表
洛雪音乐助手

洛雪音乐助手

AI Agent 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_525df779/lxmusic。

技能介绍

要解决的具体问题

lx-music-assistant 面向已在桌面端使用洛雪音乐助手的用户，解决“大模型/Agent 无法直接操作本地播放器”的问题。技能不替代音乐源，而是通过内嵌 CLI 调用洛雪音乐助手的 OpenAPI 服务，让模型可以执行搜索、播放、状态查询、音量和本地歌单等动作。使用时需要先启动桌面版，并开启端口 23330 的开放 API。

技能如何工作

核心流程是把自然语言请求转成 CLI 命令，再按固定节奏验证结果：

  • 搜索 / 唤醒：search 可在播放器内显示结果并唤醒程序，searchPlay 会直接播放指定歌曲或歌手作品。
  • 智能播放：对知名歌手可推荐代表作用 searchPlay 播放；对不确定对象先用 search 查询，避免直接播放错误结果。
  • 播放控制：支持暂停、继续、上一首、下一首等控制，并通过 status 汇报当前状态。
  • 歌单查询：本地歌单可通过 list 获取 ID；在线歌单必须指定平台源，如 kw、kg、tx、wy、mg。

适用边界与注意点

该技能依赖本地桌面环境和 OpenAPI 服务，不适用于未安装洛雪音乐助手、API 未启动或需要云端音乐检索的场景。状态查询前通常建议等待约 500ms，避免读到未更新的状态。音量控制存在已知问题：当 status 返回 volume=0 时，需手动拖动一次音量条激活参数，否则 API 设置可能不生效。

使用场景

  • 桌面端已开启洛雪 OpenAPI，让 Agent 根据歌手名搜索并直接播放代表作。
  • 用户给出网易云或 QQ 歌单链接，技能提取平台源和 ID 后查询在线歌单。
  • 播放过程中需要暂停、继续、切歌并查看当前歌曲状态，由 Agent 调用 CLI 完成。
  • 本地收藏较多时，让 Agent 查询本地歌单列表并汇报可用歌单 ID。

适合人员

  • 使用洛雪音乐助手桌面版、希望用自然语言控制播放的工程师。
  • 维护本地音乐库、需要按歌手或歌单快速找歌的用户。
  • 搭建 AI Agent 工具链、想接入本地桌面应用 OpenAPI 的开发者。
  • 需要把歌单链接转成平台源和 ID 进行查询的音乐用户。