名称: 点歌作者: 夏里白雪(XiaLiBaiXue@outlook.com) 版本: 0.1.0 兼容版本: 0.11.81(201) 平台: QQ 操作系统: Windows10 下载 music-search-v0-1-0.zip 7kB 说明 — 点歌插件 (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 请求参数 name ：歌曲名称（必填）返回格式 { "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 插件开发规范。 — 截图示例

对这个插件进行了小小的增强吧：支持纯数字输入时按网易云歌曲 id 直接查询。修复第三方接口请求兼容性，补充请求头并增加 SSL 兼容处理。音乐卡片现在保留原有展示字段，同时补充 id ，以免可能有些签名不支持修复了个bug，数据目录固定写入 plugin/data/MusicSearch ，不再误写到 plugin/tmp （原插件是从 init 向上查找，但是 OlivOS 是先解压到 tmp 目录里面，所以就会误写到 tmp，解决方法就是直接定义到 plugin/data）配置改为按 bothash 隔离保存，方便多 bot 分别配置新增分群配置：一个群一个文件，按群号保存。 .点歌 on/off/状态默认控制当前群。 .点歌全局 on/off/状态控制当前 bot 的全局配置。点歌触发现在同时受“全局开关 / 本群开关 / OlivaDiceCore on-off”三重条件限制。若存在 OlivaDiceCore ，会遵循其 host/group 的 bot on/off 逻辑。全局权限只有配置骰主 / 骰主能控制，分群权限除去骰主外，群管/群主也能控制 config.json 文件更改，新增配置骰主 { "enabled": True, # 是否启用 "debug_mode": False, # 调试模式开关 "masters": [] # 配置骰主（按 bot 隔离） } 下载： musicsearch.zip 7kB

【娱乐插件】点歌

Desom-fu

有一点需要注意一下：
如果使用的是ntqq的协议端（例如lagrange，llbot，napcat等）必须要正确配置音乐签名才能正常使用

Desom-fu

对这个插件进行了小小的增强吧：

支持纯数字输入时按网易云歌曲 id 直接查询。
修复第三方接口请求兼容性，补充请求头并增加 SSL 兼容处理。
音乐卡片现在保留原有展示字段，同时补充 id，以免可能有些签名不支持
修复了个bug，数据目录固定写入 plugin/data/MusicSearch，不再误写到 plugin/tmp（原插件是从init向上查找，但是 OlivOS 是先解压到 tmp 目录里面，所以就会误写到 tmp，解决方法就是直接定义到 plugin/data）
配置改为按 bothash 隔离保存，方便多 bot 分别配置
新增分群配置：一个群一个文件，按群号保存。
.点歌 on/off/状态 默认控制当前群。
.点歌全局 on/off/状态 控制当前 bot 的全局配置。
点歌触发现在同时受“全局开关 / 本群开关 / OlivaDiceCore on-off”三重条件限制。
若存在 OlivaDiceCore，会遵循其 host/group 的 bot on/off 逻辑。
全局权限只有配置骰主 / 骰主能控制，分群权限除去骰主外，群管/群主也能控制

config.json 文件更改，新增配置骰主

{
    "enabled": True,  # 是否启用
    "debug_mode": False,  # 调试模式开关
    "masters": []  # 配置骰主（按 bot 隔离）
}

下载：

musicsearch.zip

7kB

xiali_baixue

Desom-fu 坏了，那我所有的插件好像都有配置文件误写到plugin/tmp的问题。。。我得挨个修一遍。。。

不过我有一个担忧，如果我希望查询的歌曲名就是只有数字的，例如99（这首歌是动画《灵能百分百》的主题曲），是不是就会出现“因为检测到了数字，所以是按照id搜索了id为99的歌曲”的情况？

另外就是一个小小的个人看法：

尽量避减少直接通过指令操作配置的功能，减轻使用者的指令记忆负担，最好是可以支持图形化界面进行配置。

不过考虑到有一些骰主可能是多bot一起挂在一个服务器上，不一定每一个骰主都有直接操作服务器的权限，确实应该在图形化界面之余，提供可以利用指令进行远程配置的方案。每一个插件也最好都能支持根据bot_hash进行配置区分。

下一个版本我试试能不能把这些配置放到GUI里面，并保留老师您添加的这些指令。再次感谢老师的指点~

Desom-fu

xiali_baixue 这种确实有可能，我当时也想了一下，这种解决办法就是直接搜这首歌的id或者搜歌名+作者

当然也可以新加一个指令，用.点歌id作为前缀匹配id，这个也是一种解决方法

指令方面可能我个人的想法是能不上服务器就不上服务器，所以一般我都是会做对应的指令匹配，方便些（）比如像开关这种，肯定是一行指令就关比上服务器关方便。
另外再就是还有一个痛点，olivos目前是没有webui的，gui菜单只有windows服务器能用

然后关于OlivaDiceCore部分的话，我是做了选择性兼容，就是有更好，没有也能用。然后再就是做bothash相关的话，一定要注意在有olivadicecore的情况下，做一下账号链接的兼容，很简单，几行代码就能搞定，这样能让体验提升很多（我上面写的版本我也做了）

xiali_baixue

Desom-fu

Desom-fu 然后再就是做bothash相关的话，一定要注意在有olivadicecore的情况下，做一下账号链接的兼容

为什么是“在有OlivaDiceCore”的情况下呢？有什么情况会出现用户不使用OlivaDiceCore嘛？

Desom-fu

xiali_baixue 解耦，虽然基本上人人都装，但是万一有人真的就只是把olivos拿来当机器人框架呢，所以做了olivadicecore兼容，但不强求

xiali_baixue

Desom-fu 老师要不要考虑建一个插件开发模板之类的帖子？我最近这两天改插件改得头疼，要加配置隔离、调整配置文件生成位置什么的。

我统计了一下，有一些东西是可以通用的：

全局配置

全局启用开关

全局调试模式开关

日志输出公共方法

Debug级，受到调试模式开关控制。

Info级，直接输出。

Error级，仅用于输出错误日志。

配置的Bot级隔离。

每个Bot的配置在初始化时写入一个botId，方便用户读取配置时区分该配置属于哪一个Bot

通用GUI

仅包含全局启用开关、全局调试模式开关的配置，以及两个页签：全局配置、Bot配置，并写入通用的GUI布局方法，例如计算组件尺寸、位置等。

默认的组件结构

main.py：主方法功能类，负责具体的插件功能逻辑处理。

load.py：加载类，负责处理插件初始化的具体逻辑。

util.py：公共方法类，用于存放其他类都需要调用的方法，例如日志输出公共方法。

__init__.py：初始化类。

app.json：插件信息文件。

我目前暂时只想到这些，后续可能会发布一个这样的帖子。能否帮忙评审一下这个方案是否可行？有没有什么遗漏？非常感谢(*ˊᗜˋ)

Desom-fu

xiali_baixue 确实没什么问题，我明天写一个吧，正好和我之前写的那个规则插件模版区分一下然，后我再稍作修改一下（

Desom-fu

xiali_baixue 已实现，具体可参照此贴：https://forum.olivos.run/d/907-olivos

xiali_baixue

Desom-fu 老师这个效率太可怕了，我给我之前写的插件解耦断断续续搞了好几天了都没修完（捂脸）。看样子修航母确实不如造航母简单（虽然我造的顶多算是一辆破自行车）

2184445819

oiapi的这个api好像出问题了

xiali_baixue

2184445819 Huyansama 经测试，前段时间API确实出现问题，现API已恢复可用。

Huyansama

api好像出问题了牢大

Huyansama

老师，他现在提示这个，请问是什么原因？
[ERROR] 生成音乐消息失败 Error: Unexpected end of JSON input
at IncomingMessage.<anonymous> (file:///D:/Dice/conf/napcat/6eacdaf139135b27ffb0ccb185785f09/napcat.mjs:10247:20)
at IncomingMessage.emit (node:events:520:35)
at endReadableNT (node:internal/streams/readable:1701:12)
at process.processTicksAndRejections (node:internal/process/task_queues:89:21)
[ERROR] 发生错误 Error: 消息体无法解析, 请检查是否发送了不支持的消息类型
at OneBotMsgApi.sendMsgWithOb11UniqueId (file:///D:/Dice/conf/napcat/6eacdaf139135b27ffb0ccb185785f09/napcat.mjs:96800:13)
at SendMsg.base_handle (file:///D:/Dice/conf/napcat/6eacdaf139135b27ffb0ccb185785f09/napcat.mjs:97189:56)
at process.processTicksAndRejections (node:internal/process/task_queues:103:5)
at async SendMsg.handle (file:///D:/Dice/conf/napcat/6eacdaf139135b27ffb0ccb185785f09/napcat.mjs:47335:23)
at async OB11HttpServerAdapter.httpApiRequest (file:///D:/Dice/conf/napcat/6eacdaf139135b27ffb0ccb185785f09/napcat.mjs:91875:24)

xiali_baixue

Huyansama 测试了一下，看上去像是CQ码解析出了问题。这个依赖的是框架的功能，我也没办法了🤷‍♀️

xiali_baixue

基本信息

软件: OlivaDice
版本: 0.11.81(201)
运行架构: Windows
操作系统/浏览器:

复现步骤

使用程心自定义构建测试数据：关键词测试，返回信息[CQ:music,type=163,id=1404797306]

OlivOS终端输出以下内容：

[qq|1846210252] - [程心自定义] - <reply> - Group(439643476): [OP:music,type=163,id=1404797306,url=,audio=,title=,content=,image=]

NapCat终端输出以下内容：

08-14 17:19:31 [error] 雪宝II型全自动闯祸机 | 发生错误 Error: 消息体无法解析, 请检查是否发送了不支持的消息类型
    at OneBotMsgApi.sendMsgWithOb11UniqueId (file:///D:/ProgramFiles/OlivaDice-3.4.53-OlivOS-Win-0.11.81/conf/napcat/d7e237506b06644f19913dc1ab70d5be/napcat.mjs:96800:13)
    at SendMsg.base_handle (file:///D:/ProgramFiles/OlivaDice-3.4.53-OlivOS-Win-0.11.81/conf/napcat/d7e237506b06644f19913dc1ab70d5be/napcat.mjs:97189:56)
    at process.processTicksAndRejections (node:internal/process/task_queues:105:5)
    at async SendMsg.handle (file:///D:/ProgramFiles/OlivaDice-3.4.53-OlivOS-Win-0.11.81/conf/napcat/d7e237506b06644f19913dc1ab70d5be/napcat.mjs:47335:23)
    at async OB11HttpServerAdapter.httpApiRequest (file:///D:/ProgramFiles/OlivaDice-3.4.53-OlivOS-Win-0.11.81/conf/napcat/d7e237506b06644f19913dc1ab70d5be/napcat.mjs:91875:24)

预期结果

发送音乐消息

实际结果

报错

简单的复现代码/链接（可选）

复现相关的关键代码段，请使用Markdown代码段标记

日志记录（可选）

复现相关的日志记录，可使用Markdown代码段标记，或直接上传文件

补充说明（可选）

感谢Huyansama 发现并反馈了这个问题。

xiali_baixue

Huyansama 这个问题已经反馈并修复了，感谢@Desom-fu大佬

Huyansama

xiali_baixue 好的好的谢谢老师