前言¶

手动切歌、调音量、翻歌词，对坐在电脑前的人是小事，对 Agent 却是一批重复的动作。洛雪音乐助手（LX Music）桌面版本身有完整的播放、搜索、歌单能力，但都封装在本地客户端里，命令行和 Agent 难以直接调用。lx-music-assistant 这个 Skill 做的事，就是把这套本地播放控制能力包装成 Agent 可执行的命令集，让 Agent 能搜索歌曲、控制播放、读状态和歌词，并在每次执行后用 Markdown 表格汇报结果。

下面介绍这个 Skill 的定位、能力、安装启用方式和典型用法。

这是什么¶

lx-music-assistant 是一个面向洛雪音乐助手桌面版的控制类 Skill，坐标 @user_525df779/lxmusic，由社区开发者 user_525df779 发布，当前版本 1.0.5，来源标记为 community，分类为 ai-agent。它解决的问题是：Agent 缺少一个统一的入口来驱动本地音乐播放器完成搜索、播放控制、状态查询和歌单操作。

依据 SkillHub 页面信息，该 Skill 当前评分 100000，下载量 519，安装量为 0，标签为 requires_api_key=false，即不需要额外配置 API Key 即可使用。

核心功能¶

根据官方简介，这个 Skill 的能力范围如下：

1、搜索歌曲并唤醒程序：输入歌名或歌手等关键词，触发搜索，同时把洛雪音乐助手桌面版拉起来，不需要用户手动打开客户端。
2、播放、暂停与切换：控制当前曲目的播放、暂停、上一首、下一首。
3、音量调节：调整播放音量。
4、播放状态与歌词查询：查看当前播放状态、当前曲目信息和歌词内容。
5、收藏歌曲：把当前或指定歌曲加入收藏。
6、本地歌单查询：读取洛雪音乐助手本地歌单，查询其中的歌曲。

有一点设计值得单独说明：每次执行命令后，Skill 会自动查询一次播放状态，并用 Markdown 表格把结果汇报出来。这意味着调用方不需要自己再补一轮状态查询，返回结果里就带着当前播放信息，便于在 Agent 的上下文里直接引用。

安装与启用¶

官方地址为 https://api.skillhub.cn/user_525df779/lxmusic，SkillHub 页面地址为 https://www.skillhub.cn/skills/user_525df779/lxmusic。

关于安装命令和配置字段，需要如实说明：本次写作时我尝试打开上述两个地址以及 https://api.skillhub.cn/skills/user_525df779/lxmusic、https://skillhub.cn/skills/user_525df779/lxmusic，均抓取失败，未能核实到官方给出的具体安装命令、目录路径或配置项。因此这里不给出任何未经核实的命令。如果你需要安装，建议直接打开官方地址或 SkillHub 页面，按页面上的说明操作。

从已核实的信息可以确认两点：一是该 Skill 基于通用 SKILL.md 格式，可以被支持该格式的 Agent 直接加载；二是 requires_api_key=false，不需要单独申请和填写 API Key。至于 Cursor、Codex CLI、Claude Code 等不同工具在加载方式上是否有差异，本次没有核实到相关说明，这里不臆测。

典型用法¶

同样因为页面抓取失败，我没有拿到官方提供的可复现调用示例，所以下面不写伪代码或猜测的命令格式，避免误导。

如果要验证一个命令是否可用，比较稳妥的顺序是：先触发一次搜索并唤醒程序，确认洛雪音乐助手桌面版已启动且能返回结果；再执行播放或暂停，看返回的 Markdown 表格里状态是否同步变化；然后调一次音量并查询状态，确认音量字段生效；最后查一次歌词和本地歌单，确认读取链路正常。这套顺序只用于验证，不代表官方推荐的调用流程。

适用场景与注意¶

适合的场景：Agent 需要替用户完成「找一首歌并放起来」这类端到端操作；需要在一段长流程里持续感知当前播放状态并据此做下一步判断；需要把本地歌单纳入 Agent 的上下文，用于推荐或查询。

需要注意的地方：

1、它依赖洛雪音乐助手桌面版在本地运行，客户端未启动或未正常安装时，搜索和唤醒能否完全接管取决于客户端自身的表现，这一点官方简介没有细说。
2、播放控制、歌词和歌单都围绕本地客户端状态，Agent 看到的是查询时刻的快照，不是实时流。
3、搜索结果和曲库可用性取决于洛雪音乐助手所接入的音源，这一点不在该 Skill 的控制范围内。
4、资料中安装量标记为 0，说明这是一个较新的社区 Skill，遇到问题时可参考的公开案例较少，需要自己多做验证。

结尾¶

lx-music-assistant 的价值在于把洛雪音乐助手的本地播放能力整理成 Agent 可直接调用的命令集，并把状态汇报固化到每次执行之后，省掉调用方额外的查询步骤。对于想把音乐播放纳入 Agent 工作流的人来说，这是一个起点清晰、依赖本地客户端的轻量方案。

官方地址：https://api.skillhub.cn/user_525df779/lxmusic

SkillHub 页面：https://www.skillhub.cn/skills/user_525df779/lxmusic