- 名称:
点歌
- 作者:
夏里白雪(XiaLiBaiXue@outlook.com)
- 版本:
0.1.0
- 兼容版本:
0.11.81(201)
- 平台:
QQ
- 操作系统:
Windows10
下载
说明
—
点歌插件 (MusicSearch)
基于第三方网易云音乐 API 的 OlivOS 点歌插件，支持搜索歌曲并返回 CQ 码音乐消息。站内已经有人做了程心包的点歌功能了，我只是想写一个插件版的练练手。程心包版本指路：【程心包】网易云点歌。
以及这个文档大部分也是AI生成的，凑合看吧(/- v-)/
功能特性
- 快速点歌：通过简单的指令搜索并点歌
- 网易云音乐：基于网易云音乐 API，曲库丰富
- 智能返回：自动取搜索结果的第一条
- 完善的错误处理：友好的错误提示
- 调试支持：可配置的调试日志输出
安装方法
- 将
MusicSearch 文件夹复制到 OlivOS 的 plugin/app/ 目录下
- 重启 OlivOS 即可使用
使用方法
基本用法
在群聊或私聊中发送以下格式的消息：
.点歌歌曲名称
。点歌歌曲名称
例如：
.点歌爱不会绝迹
。点歌晴天
返回结果
插件会返回一个 CQ 码音乐消息，包含以下信息：
错误提示
- 未输入歌曲名称：提示"请输入歌曲名称，例如：【.点歌爱不会绝迹】或【。点歌爱不会绝迹】"
- 搜索失败：提示"搜索失败，请稍后重试"或具体错误信息
- 未查询到对应歌曲：提示"未查询到对应歌曲"
配置说明
插件配置文件位于 plugin/data/MusicSearch/data/config.json，首次运行会自动创建。
配置项
{
"enabled": true,
"debug_mode": false
}
- enabled：是否启用插件（true/false）
- debug_mode：是否开启调试模式（true/false）
配置热更新
修改配置文件后，无需重启 OlivOS，下次使用时会自动加载新配置。
技术细节
API 接口
使用第三方 API：https://oiapi.net/api/Music_163
请求参数
返回格式
{
"code": 0,
"message": "搜索成功",
"data": [
{
"name": "歌曲名称",
"picurl": "封面图片URL",
"id": 歌曲ID,
"jumpurl": "跳转链接",
"singers": [
{
"name": "歌手名称",
"id": 歌手ID
}
]
}
]
}
CQ 码格式
[CQ:music,type=163,url=跳转链接,audio=音频链接,title=歌曲名,image=封面图,content=歌手]
日志输出
插件使用 “>>>” 格式的日志记录，便于调试和追踪：
>>> 点歌插件已初始化 - 插件初始化成功>>> 正在搜索歌曲: xxx - 开始搜索歌曲>>> 成功返回歌曲: xxx - 成功返回歌曲>>> 未查询到对应歌曲: xxx - 未找到歌曲>>> [调试] xxx - 调试信息（需开启 debug_mode）
文件结构
MusicSearch/
├── app.json # 插件配置文件
├── __init__.py # 插件入口
├── load.py # 配置加载模块
├── main.py # 核心功能模块
└── README.md # 说明文档
作者
👤 夏里白雪(XiaLiBaiXue@outlook.com)
版本
v0.1.0
许可证
本插件遵循 OlivOS 插件开发规范。
—
截图示例
