Auto-Generate docs 🤖

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,`
+
+<img width="509" height="102" alt="Image" src="https://gproxy.hanxi.cc/proxy/user-attachments/assets/aff9a971-0f88-4ff4-8042-63cef51478b1" />
+
+
+### 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
+
+入口：
+
+<img width="325" height="326" alt="Image" src="https://gproxy.hanxi.cc/proxy/user-attachments/assets/7718a251-4419-4833-909e-3d2bf8fd7c8f" />
+
+搜索和推送到当前播放音箱：
+
+<img width="327" height="641" alt="Image" src="https://gproxy.hanxi.cc/proxy/user-attachments/assets/3722a302-42f4-4c16-9754-98697f1d0dfc" />
+
+---
+[链接到 GitHub Issue](https://github.com/hanxi/xiaomusic/issues/655)

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