从仓库或文件手动安装插件：离线与私有方案

插件市场解决 90% 的需求，剩下 10%——私有插件、未上架作品、网络受限环境——走手动路线。

两种手动安装方式

入口都在插件页右下角的 + 按钮：

从链接安装：粘贴插件仓库的地址，框架自动拉取安装。适合插件在公开仓库但没进市场的情形。

从文件安装：上传插件压缩包。适合三种情况：

• 插件作者只发布了压缩包
• 私有插件，仓库不公开
• 服务器网络到仓库不通（国内环境常见）

网络受限环境的下载链路

1. 在能联网的电脑上下载插件仓库的 ZIP（仓库页面 → Code → Download ZIP）
2. 传到能访问面板的设备上
3. 插件页 + 按钮 → 从文件安装 → 上传

或者从根上解决网络问题：「设置 → 网络 → 代理与依赖源」里有两个可用项：

• HTTP 代理：整体代理出站请求，Docker 部署注意代理地址的容器视角（见 Docker 部署）
• GitHub 加速地址：专门给插件下载用的加速镜像前缀

安装后的参数配置

不少插件带配置项，位置在配置文件页的「插件」分区。装完浏览一遍：

• 填插件要的 Key、目录、开关
• 插件参数与可用范围相关的设置（比如只对管理员生效的功能）按插件文档来
• 改完保存配置，个别插件需要重载才读新参数——用插件卡片上的重载或一键重载修复按钮

更新、重载与卸载

已安装列表里每个插件都支持：

• 更新：拉取插件新版本
• 重载：不重启框架重新加载插件代码，改配置和修代码后的快速生效手段
• 停用 / 启用：停用保留文件，只是不加载
• 删除：连文件一起清掉

插件停用会连带它注册的指令、提供的工具与技能全部失效，指令管理里它们的条目也会受影响——排查「指令突然没了」先看插件是不是被停了。

装不上的报错分流

• 下载就失败：网络问题，走上面的加速链路
• 下载成功、加载报 No module named：依赖没装上，看插件安装失败与依赖报错处理
• 加载成功但功能不对劲：查插件文档的版本要求，插件与框架大版本不匹配是常见原因