在线播放功能扩展说明

在原版 xiaomusic 基础上，增加了以下扩展功能：

MusicFree插件支持:（需自行获取音源）集成 MusicFree 的 JS 插件系统，支持多种音乐源
开放接口支持:(默认启用) 支持通过TuneFree API进行音乐搜索和播放
插件管理: 提供插件启用/禁用/卸载等功能
自动追加歌曲功能:(默认未启用) 播放到歌单末尾时自动搜索并播放相同歌手的歌曲
用户口令智能提取（默认未启用）: 支持对用户语音指令的智能分析，自动提取歌名、歌手名（需用户配置AI API密钥，默认不启用）

调用策略

调用策略：
- 配置了开放接口且启用，只调用开放接口。
- 未配置或启用接口时，会调用MusicFree插件搜索（需导入且启用）
搜索结果优先级规则：
- 【歌曲名】>【歌手名】>【插件平台权重】
- 插件平台权重（启用插件列表中前9个插件，排名越靠前权重越高，最高9分）

🔧 新增功能介绍

🤐 新增语音口令

【在线播放+关键词(歌手/歌曲名组合)】，会直接调用接口或插件，搜索关键词,返回匹配后的第一个资源进行播放。比如说：【在线播放】林俊杰||江南||林俊杰+江南。
【歌手播放+歌手名】，会在线搜索该歌手的歌曲并创建歌单进行播放。比如说：【播放歌手：陈奕迅】。

Tips 需要在配置界面【允许唤醒的命令】选项中增加：,singer_play,online_play,

WEB端搜索、配置

支持网页端搜索/播放歌曲及推送小爱音响(部分MusicFree插件获取的资源小爱音响不适用，如Bilibili插件)
支持网页端管理插件、接口
支持歌曲列表的全部推送功能

JS插件管理

支持加载和管理 MusicFree JS 插件
提供插件导入/启用/禁用/卸载功能
支持插件配置文件管理

开放接口支持

集成TuneFree API接口
支持在线搜索和播放
可配置开放接口地址

✨高级配置

用户口令智能提取

默认不启用，需用户主动配置API密钥后方可使用
使用AI大模型分析用户语音指令，自动提取歌曲名和歌手名信息
配置后会提高搜索精确度，非必须

自动追加歌曲功能

可配置是否在播放到最后一首歌时，追加当前歌手的其他歌曲(默认未启用，仅【全部播放】模式适用）
默认未启用，只会根据当前歌单播放，不会自动搜索、添加歌曲

配置示例：

**/conf/plugins-config.json 下

json

{
  ......
  // 启用自动添加歌曲功能
  "auto_add_song": true,

  // OpenAI 兼容 API 配置（支持阿里百炼、质谱 AI 等符合 OpenAI API 规范的大模型）
  "aiapi_info": {
    // OpenAI API 的基础 URL（默认指向阿里百炼）
    "base_url": "",
    // API 密钥
    "api_key": "API密钥",
    // 使用的模型名称（默认 qwen-flash，当前配置为 qwen-plus）
    "model": "qwen-plus",
    // 是否启用 AI 功能
    "enabled": true
  },

  ......
}

评论 1 - hanxi

入口：

搜索和推送到当前播放音箱：

评论 2 - gdzjy

@boluofan 建议把https://github.com/lyswhut/lx-music-mobile 的音源也兼容了吧，毕竟lx-music-mobile项目比MusicFree更早，有很多免费的音源。

评论 3 - boluofan

@boluofan 建议把https://github.com/lyswhut/lx-music-mobile 的音源也兼容了吧，毕竟lx-music-mobile项目比MusicFree更早，有很多免费的音源。

lxmusic的插件沙箱环境不好做，暂不打算支持。

链接到 GitHub Issue

在线播放功能扩展说明 ​

调用策略 ​

🔧 新增功能介绍 ​

🤐 新增语音口令 ​

WEB端搜索、配置 ​

JS插件管理 ​

开放接口支持 ​

✨高级配置 ​

用户口令智能提取 ​

自动追加歌曲功能 ​

配置示例： ​

评论 ​

评论 1 - hanxi ​

评论 2 - gdzjy ​

评论 3 - boluofan ​