From cdd04e4e98446f0a7a01a39697697061e6b62ce0 Mon Sep 17 00:00:00 2001 From: "Issues Docs [BOT]" Date: Fri, 9 Jan 2026 19:22:06 +0000 Subject: [PATCH] =?UTF-8?q?Auto-Generate=20docs=20=F0=9F=A4=96?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/issues/655.md | 105 +++++++++++++++++++++++++++++++++++++++ docs/issues/changelog.md | 14 ++++++ 2 files changed, 119 insertions(+) create mode 100644 docs/issues/655.md diff --git a/docs/issues/655.md b/docs/issues/655.md new file mode 100644 index 0000000..b59572f --- /dev/null +++ b/docs/issues/655.md @@ -0,0 +1,105 @@ +--- +title: 在线播放功能扩展说明 +--- + +# 在线播放功能扩展说明 + +在原版 xiaomusic 基础上，增加了以下扩展功能： + +1. **MusicFree插件支持**:（需自行获取音源） 集成 MusicFree 的 JS 插件系统，支持多种音乐源 +2. **开放接口支持**:(默认启用) 支持通过TuneFree API进行音乐搜索和播放 +3. **插件管理**: 提供插件启用/禁用/卸载等功能 +4. **自动追加歌曲功能**:(默认未启用) 播放到歌单末尾时自动搜索并播放相同歌手的歌曲 +5. **用户口令智能提取**（默认未启用）: 支持对用户语音指令的智能分析，自动提取歌名、歌手名（需用户配置AI API密钥，默认不启用） + +### 调用策略 +- 调用策略： + - 配置了开放接口且启用，只调用开放接口。 + - 未配置或启用接口时，会调用MusicFree插件搜索（需导入且启用） +- 搜索结果优先级规则： + - 【歌曲名】>【歌手名】>【插件平台权重】 + - 插件平台权重（启用插件列表中前9个插件，排名越靠前权重越高，最高9分） + +## 🔧 新增功能介绍 + +### 🤐 新增语音口令 +- 【在线播放+关键词(歌手/歌曲名组合)】，会直接调用接口或插件，搜索关键词,返回匹配后的第一个资源进行播放。比如说：【在线播放】林俊杰||江南||林俊杰+江南。 +- 【歌手播放+歌手名】，会在线搜索该歌手的歌曲并创建歌单进行播放。比如说：【播放歌手：陈奕迅】。 + +**Tips** +需要在配置界面【允许唤醒的命令】选项中增加：`,singer_play,online_play,` + +Image + + +### 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 + +入口： + +Image + +搜索和推送到当前播放音箱： + +Image + +--- +[链接到 GitHub Issue](https://github.com/hanxi/xiaomusic/issues/655) diff --git a/docs/issues/changelog.md b/docs/issues/changelog.md index 0bd874b..5409690 100644 --- a/docs/issues/changelog.md +++ b/docs/issues/changelog.md @@ -1,5 +1,19 @@ # 版本日志 +## v0.4.5 (2026-01-10) + +### Feat + +- 在线播放功能优化，新增AI智能提取用户口令 (#654) + +### Fix + +- 修复重构后的问题 +- 修复部分网络歌曲无法播放的问题 +- 解决在线歌曲链接转换问题 +- 修复重构引起的问题 +- 修复重构后遇到的问题 + ## v0.4.4 (2026-01-07) ### Fix