插件问题
插件已经启用，为什么仍然不能使用？
先阅读插件自己的 README 或使用说明，确认必填配置、依赖、权限和支持的 MaiBot 版本。然后检查插件加载日志、配置校验错误以及命令或事件是否成功注册。
只有在确认问题来自插件本身后，才需要向插件作者反馈。
插件命令为什么被当成普通聊天消息？
确认命令格式和前缀正确，并检查插件启动时是否成功注册命令。如果多个插件使用相同命令，或者某个插件提前拦截并修改了消息，命令可能继续进入普通聊天流程。
可以临时禁用近期安装的插件，逐个恢复来定位冲突。
怎样排查插件冲突？
记录冲突发生前最后安装或更新的插件，然后分批禁用插件进行二分排查。定位后比较命令名称、Hook、事件优先级和依赖版本，不要只根据网上某个旧版本案例直接认定插件有问题。
插件下载失败怎么办？
检查仓库地址、网络、Git 是否可用，以及代理或镜像源配置。还要确认插件仓库的实际默认分支；分支可能叫 main、master 或其他名称，不能固定假设。
如果能访问仓库但安装仍失败，查看安装日志中的 Git 错误、权限错误和依赖安装错误。
插件更新后无法使用怎么办？
检查插件的更新说明和配置迁移要求，并对比 MaiBot 版本兼容范围。恢复前先备份插件目录和配置；如果需要回退，应按照插件仓库提供的版本说明操作。