基础插件详情

约定

下列文档中，使用灰底标出的，皆为config-plugin.yaml文件配置项。

此外，命令中所出现的：方括号[]内的内容，代表一个参数

权限管理

• 超级用户专属
• 配置项：auth
• 说明：

部分插件会有最低权限等级要求，即在帮助中以方括号包裹的数字，只有高于该权限等级的群成员才能使用

本插件用于进行群成员权限等级设置，保证用户不会做出越权行为（例如普通用户禁用本群某个功能）。

• 命令：

更新管理员权限：会将所有群中未被设置权限的群管理员设为默认权限等级（配置项auth.defaultlevel）

设置管理员权限 [群号] [用户QQ号] [Level]：将指定群的指定用户权限设为Level

• 其它：

每日1点5分，会自动将所有群中未被设置权限的管理员设为默认权限等级（auth.defaultlevel）

权限level(>=1)数字越小，权限越高

超级管理员的权限会被确保至少为auth.superlevel级

部分插件已预置了最低权限等级，但所有插件皆可通过config-plugin文件进行权限等级配置

只需配置该文件中的 插件Key.adminlevel 配置项，即可设置指定插件的最低权限等级了

例如将 translate.adminlevel 配置项值设为5，则只有群权限等级高于5(level<=5)的成员才能使用翻译插件

限流

• 说明：

统筹所有插件的CD限流，即单用户调用单个插件功能的最大时间间隔，若调用过于频繁，两次调用的间隔小于所配置的CD时长，将自动阻止此次调用。

• 配置项：

分为全局CD以及单插件CD：

通过limiter.globalcd来配置全局CD，将对所有插件生效

通过配置config-plugin文件下的插件Key.cd配置项来设置针对该插件的CD，该CD优先级高于全局CD

例如：想要配置翻译插件的CD时长为1分钟30秒，在config-plugin文件中新增或修改translate.cd配置项为1m30s即可。

帮助

• 说明：

可以清晰明了地说明插件的功能，以及插件的使用方法。

• 命令：

帮助： 分类查看所有插件列表

帮助 [插件名]： 查看指定插件的详细帮助