Skip to content

安装和管理插件

插件就像给 MaiBot 安装"App",让它拥有更多功能!

什么是插件?

插件是 MaiBot 的扩展功能,比如:

  • 🎮 游戏插件 - 能陪用户玩游戏
  • 🎨 画图插件 - 能生成图片
  • 🎵 音乐插件 - 能播放音乐
  • 🌤️ 天气插件 - 能查天气预报
  • 📚 学习插件 - 能教知识

安装插件

方法一:在线安装(推荐)

  1. 打开 WebUI,点击"插件管理"
  2. 点击"安装插件"按钮
  3. 输入插件地址(GitHub 链接)
  4. 点击"安装",等待完成

示例地址

https://github.com/作者/插件名

方法二:本地安装

  1. 下载插件代码到本地
  2. 在插件管理页面点击"本地安装"
  3. 选择插件文件夹
  4. 确认安装

管理已安装插件

查看插件

插件页面会显示:

  • 📋 插件名称 和简介
  • 🔧 版本号 和作者
  • 启用状态(绿色=启用,灰色=禁用)
  • 📖 使用说明(点击可看)

启用/禁用插件

  • 开关打开 → 插件生效
  • 开关关闭 → 插件停用
  • 改完立即生效,不用重启

配置插件

有些插件可以自定义设置:

  1. 点击插件的"设置"按钮
  2. 修改配置选项
  3. 保存后立即生效

常见配置

  • API 密钥(需要外部服务的插件)
  • 触发关键词
  • 功能开关

更新插件

插件有新版本时会显示更新提示:

  1. 点击"更新"按钮
  2. 等待下载和安装
  3. 自动完成,数据不会丢失

卸载插件

不需要的插件可以卸载:

  1. 点击"卸载"按钮
  2. 确认卸载
  3. 插件文件会被删除

⚠️ 注意:卸载后插件的数据可能会丢失

插件推荐

新手必备

  • 欢迎插件 - 新用户入群自动欢迎
  • 帮助插件 - 提供命令帮助
  • 签到插件 - 每日签到功能

娱乐向

  • 抽卡插件 - 模拟各种抽卡
  • 骰子插件 - 掷骰子游戏
  • 猜谜插件 - 猜谜语、脑筋急转弯

实用向

  • 翻译插件 - 多语言翻译
  • 计算插件 - 数学计算
  • 时间插件 - 时间日期查询

使用技巧

插件冲突

如果插件功能重复或冲突:

  • 只启用需要的插件
  • 调整插件优先级
  • 联系插件作者更新

性能优化

插件太多可能影响性能:

  • 不用的插件及时卸载
  • 定期清理无用插件
  • 关注插件资源占用

安全提醒

  • 只安装可信来源的插件
  • 查看插件权限要求
  • 定期更新插件版本

常见问题

Q: 插件安装失败怎么办? A: 检查网络连接,确认插件地址正确,查看错误提示

Q: 插件不起作用? A: 确认插件已启用,检查配置是否正确,查看 MaiBot 日志

Q: 哪里找插件? A: GitHub 上搜索"MaiBot 插件",或者加入社区获取推荐

Q: 能自己开发插件吗? A: 当然可以!有开发文档和示例代码,零基础也能学

获取帮助

  • 插件页面有使用说明
  • 查看插件的 README 文档
  • 加入 MaiBot 交流群询问
  • 在 GitHub 提交问题