xitian-plugin / 插件管理器
Yunzai-Bot V3 的 js 插件管理器：支持通过发送 js 文件或仓库地址安装插件、停用 / 启用 / 删除 / 恢复、分组管理、命令冲突调试与插件核验。主要针对单个 js 文件插件（大型插件仅支持列表查看，不支持安装管理）。
指令说明
以下指令供 bot 使用者（群友 / 管理员）参考。xitian-plugin 的指令默认仅主人可用，可在锅巴后台「Xitian-Plugin」的 auth 配置中调整：
auth.grade：放行群主（owner）/ 群管理（admin）/ 所有人（everyone）auth.accredit：授权指定 QQ 操作auth.group：关闭后群聊内不可使用- 当
grade与accredit均为空时，默认仅主人可用
安装插件
| 指令 | 说明 |
|---|---|
#安装插件 | 发送指令后直接发送 js 文件即可安装，默认安装到 default_group 分组 |
#安装插件 <github/gitee 仓库地址> | 从仓库克隆插件到 plugins/ 目录，可选自动安装依赖，装完自动重启 |
#开始批量安装插件 / #结束批量安装插件 | 进入 / 退出批量安装模式，期间可连续发送多个 js 文件；#取消安装插件 可中途取消 |
#清空回收站 | 清空回收站内全部插件（需回复「是」确认，不可找回） |
智能安装 / 智能重命名 / 插件核验默认开启（锅巴 js 配置可单独关闭）：
- 智能安装：检测到同名 / 相似插件时，自动将旧插件移入回收站再覆盖安装
- 智能重命名：按词库清除文件名中的
v、V、版本号、符号等干扰字符后安装，避免同一插件重复安装 - 插件核验：解析文件检查导出类型是否合法，并提示
fs/child_process等敏感模块；核验通过才启用（不通过则保持停用态.bak）
插件管理
| 指令 | 说明 |
|---|---|
#插件列表 | 图片展示所有分组下的插件及其启用状态 |
#查找插件 xxx | 在全部插件中按名字查找 |
#停用插件 xxx | 停用插件（文件改为 .bak，立即生效） |
#启用插件 xxx | 启用已停用插件 |
#删除插件 xxx | 将插件移入回收站（可恢复） |
#彻底删除插件 xxx | 物理删除插件，不可找回（需回复「是」确认） |
#恢复插件 xxx | 从回收站恢复到原分组（原分组不存在则回默认分组） |
#查看回收站 | 列出回收站内的插件 |
#插件 xxx 重命名 yyy | 重命名插件文件 |
#查看插件 xxx | 将插件文件发送到当前会话（群聊上传群文件，私聊发送离线文件） |
#删除插件 <git插件名>（如#删除插件 xitian-plugin）会直接删除整个 git 插件目录，不走回收站- 停用 / 启用 / 删除 / 恢复等操作匹配到多个插件时，会列出序号供你选择
插件分组
js 插件按文件夹分组管理（plugins 目录下每个子目录即一个分组）。
| 指令 | 说明 |
|---|---|
#分组列表 | 查看现有分组 |
#创建分组 xxx | 新建分组文件夹 |
#删除分组 xxx | 删除分组（需分组内为空） |
#xxx设置分组 yyy | 将插件 xxx 移动到分组 yyy |
#同步分组 | 扫描 plugins 目录，自动把存在的文件夹同步为分组（排除 exclude 列表中的目录） |
命令调试
| 指令 | 说明 |
|---|---|
#命令总览 | 查看当前所有已加载插件的命令正则（转发消息，每 50 条一页） |
#测试命令 xxx | 查看哪些插件会响应指令 xxx，用于排查命令冲突 |
#测试执行命令 xxx | 实际执行该指令并显示返回结果 |
插件管理器自身
| 指令 | 说明 |
|---|---|
#插件帮助 / #插件菜单 / #插件help | 查看指令帮助图 |
#插件更新 | git pull 更新插件管理器，成功后自动重启 |
#插件强制更新 | 放弃本地改动后更新，用于解决更新冲突 |
#插件版本 | 查看版本与更新记录图 |
#插件更新日志 | 查看最近更新日志（转发消息） |
指令列表
分组
- 描述：提供js插件分组管理
- 事件：
message - 优先级：5
| 正则表达式 | 处理函数 |
|---|---|
^#分组列表$ | list |
^#创建分组(.\*)$ | new |
^#删除分组(.\*)$ | del |
^#(.\*)设置分组(.\*)$ | set |
^#同步分组$ | sync |
插件帮助
- 描述：发送插件管理器使用帮助
- 事件：
message - 优先级：5
| 正则表达式 | 处理函数 |
|---|---|
^#插件(管理器)?(菜单|帮助|help)$ | help |
插件安装
- 描述：进行安装和新增插件操作
- 事件：
message - 优先级：5
| 正则表达式 | 处理函数 |
|---|---|
^#(安装|新增|增加)插件(https://(github|gitee).com/\[a-zA-Z0-9-\]\{1,39\}/\[a-zA-Z0-9\_-\]\{1,100\}(.git)?)?$ | new |
^#开始批量安装插件$ | batch |
^#清空回收站 | clear |
插件管理
- 描述：各种功能帮助master管理js插件
- 事件：
message - 优先级：5
| 正则表达式 | 处理函数 |
|---|---|
^#查找插件(.\*)$ | find |
^#停用插件(.\*)$ | mv_ty |
^#启用插件(.\*)$ | mv_qy |
^#(彻底)?删除插件(.\*)$ | del |
^#恢复插件(.\*)$ | rec |
^#插件(.\*)重命名(.\*)$ | rename |
^#查看插件(.\*)$ | upload |
插件测试
- 描述：测试或查看全部命令
- 事件：
message - 优先级：500
| 正则表达式 | 处理函数 |
|---|---|
^#命令(总览|列表)$ | getrule |
^#测试(执行)?命令(.\*)$ | testrule |
更新插件
- 描述：#更新 #强制更新
- 事件：
message - 优先级：4000
| 正则表达式 | 处理函数 |
|---|---|
^#插件(管理器)?更新日志$ | updateLog |
^#插件(管理器)?(强制)\*更新$ | update |
^#插件(管理器)?版本$ | version |
插件列表
- 描述：查看js和大型插件
- 事件：
message - 优先级：5000
| 正则表达式 | 处理函数 |
|---|---|
^#插件列表$ | read |
^#查看回收站$ | look |
鸣谢
- V2 插件管理器 2.0 — 本插件原型来源（记录于插件版本日志）
- 素材来源于网络，仅供交流学习使用
← 返回插件列表