Guoba-Plugin / 锅巴插件
锅巴插件是 Yunzai-Bot 的 Web 后台管理面板，把大多数管理操作搬进浏览器：可视化编辑配置文件、安装 / 卸载 / 配置插件、编辑喵喵帮助、V2 数据迁移等。聊天指令是辅助入口——用于获取访问地址、查看版本、更新插件、重载服务。
管理面板仅支持 V3 版本的 Yunzai；V2 版本 Yunzai 仅支持迁移至 V3 功能。
面板默认监听端口 50831（可在 config/application.yaml 修改），启动时控制台会打印访问地址，复制到浏览器即可访问。面板仅限主人登录使用。
指令说明
以下指令说明供 bot 使用者（群友 / 管理员）参考，标「主人」的指令仅机器主人可用。
面板访问
| 指令 | 权限 | 说明 |
|---|---|---|
#锅巴帮助 | 主人 | 查看锅巴帮助与使用说明 |
#锅巴登录 | 主人 | 生成面板访问地址（自定义 / 内网 / 外网）并附临时登录令牌，3 分钟有效、用后即失效；也可在 bot 控制台通过验证码登录 |
#锅巴登录的规则定义虽未限制权限，但方法内校验主人身份，非主人发送会被忽略；群聊中默认将地址私信发送给主人。
版本与更新
| 指令 | 权限 | 说明 |
|---|---|---|
#锅巴版本 | 所有人 | 查看锅巴插件当前版本（唯一 all 级指令） |
#锅巴更新 | 主人 | 从 git 仓库拉取更新（git pull --rebase） |
#锅巴强制更新 | 主人 | 强制更新：先 git fetch 再 git reset --hard 重置到远程分支，会丢弃本地改动，请谨慎使用 |
服务重载
| 指令 | 权限 | 说明 |
|---|---|---|
#锅巴重启 | 主人 | 重载锅巴 Web 服务（同时重新扫描各插件的 guoba.support.js），无需重启 bot |
面板功能
- 配置文件管理：可视化编辑 bot 配置文件（
bot.yaml/group.yaml/other.yaml/redis.yaml等），改动即时生效 - 插件管理：安装 / 卸载插件、查看插件 README、配置已接入锅巴的插件
- 编辑喵喵帮助：可视化编辑 miao-plugin 帮助
- V2 → V3 迁移：旧版云崽数据丝滑迁移至 V3
- 系统信息：首页系统状态、磁盘信息等
指令列表
锅巴:兼容V2
- 描述：兼容V2的单JS插件
- 事件：
message - 优先级：0
锅巴登录
- 描述：锅巴快捷登录
- 事件：
message - 优先级：100
| 正则表达式 | 处理函数 |
|---|---|
^#?锅巴(登录|登陆)$ | login |
锅巴更新
- 描述：锅巴更新、升级
- 事件：
message - 优先级：100
| 正则表达式 | 处理函数 |
|---|---|
^#锅巴版本$ | getVersion |
^#锅巴(强制)?(更新|升级|update)$ | doUpdate |
锅巴帮助
- 描述：锅巴插件帮助
- 事件：
message - 优先级：100
| 正则表达式 | 处理函数 |
|---|---|
^#?锅巴(帮助|菜单|说明|功能|指令|命令|使用说明|help)$ | getHelp |
^#锅巴重启$ | restart |
鸣谢
← 返回插件列表