astrbot_plugin_songloft

通过 AstrBot 对话控制 Songloft 音乐服务器，支持小米音箱播放、歌曲搜索、歌单管理等功能。

功能

• 全维度播放控制：播放 / 暂停 / 切歌 / 音量 / 播放模式
• 歌曲搜索与歌单管理
• 多设备选择（通过 MIoT 插件控制小米音箱）
• WebUI 配置管理页面（集成于 AstrBot 仪表盘）

前置要求

• AstrBot v4.5.0+
• Songloft 自托管音乐服务器（运行中）
• songloft-plugin-miot 已安装到 Songloft（用于控制小米音箱）

安装

1. 在 AstrBot 商店搜索本插件，或从 GitHub Releases 处下载最新版本
2. 重启 AstrBot 或执行热加载命令

配置

在 AstrBot 设置页面中配置以下参数：

配置项	说明	默认值
songloft_host	Songloft 服务器地址	空（必填）
songloft_username	登录用户名	空（必填）
songloft_password	登录密码	空（必填）
miot_plugin_path	MIoT 插件入口路径	空（非必填）
miot_account_id	小米账号 ID	空（必填）
default_device	默认音箱设备 ID	空（可选）默认使用第一个可用设备
sync_interval	播放状态同步间隔（秒）	30

指令

发送 /sl 查看完整帮助。

指令	说明
/sl play <关键词>	搜索并播放歌曲
/sl pause	暂停播放
/sl resume	恢复播放
/sl next	下一首
/sl prev	上一首
/sl volume <0-100>	设置音量
/sl mode <模式>	设置播放模式（repeat/shuffle/normal）
/sl status	查看当前播放状态
/sl devices	列出可用设备
/sl device <ID>	切换默认设备
/sl search <关键词>	搜索歌曲
/sl playlists	列出歌单
/sl playlist <ID>	播放歌单

更新日志

v1.0.0 (2026-06-18)

初版发布：

• 通过 AstrBot 对话控制 Songloft 音乐服务器
• 小米音箱（MIoT 插件）播放控制
• 歌曲搜索（多页搜索 + 匹配度排序）
• 全维度播放控制：播放 / 暂停 / 切歌 / 音量 / 播放模式
• 歌单管理与播放
• WebUI 配置管理页面

WebUI

安装后在 AstrBot 仪表盘 → 插件 → astrbot_plugin_songloft → manage 页面访问配置管理界面。

致谢

感谢以下项目：

• AstrBot 作为基础插件框架
• Songloft 自托管音乐服务器
• Linux.do 社区提供的支持与帮助

许可证

Apache-2.0