7.1 KiB
Batch Install Plugins from GitHub
| 作者:Fu-Jie · v1.1.0 | ⭐ 点个 Star 支持项目 |
|---|
一键将 GitHub 仓库中的插件批量安装到你的 OpenWebUI 实例。
使用 Batch Install Plugins 安装
当你已经安装过一次 Batch Install Plugins from GitHub 后,也可以用同一句来重新安装或更新它自己:
从 Fu-Jie/openwebui-extensions 安装插件
当选择弹窗打开后,搜索当前插件,勾选后继续安装即可。
Important
如果你已经安装了 OpenWebUI 官方社区里的同名版本,请先删除旧版本,否则重新安装时可能报错。删除后,Batch Install Plugins 后续就可以继续负责更新这个插件。
Tip
💡 想要批量安装/管理 Workspace 技能 (Skills)? 本插件专注安装全局函数型插件(Pipe/Filter/Tool/Action)。如果你需要管理 AI 助手的专属技能,请使用同系列的 OpenWebUI Skills Manager 工具,它具备完整的增删改查、批量发现及可视化浮层点选能力。
主要功能
- 一键安装:单个命令安装所有插件
- 自动更新:自动更新之前安装过的插件
- 公开 GitHub 支持:支持从一个或多个公开 GitHub 仓库安装插件
- 多类型支持:支持 Pipe、Action、Filter 和 Tool 插件
- 多仓库选择器:一次请求可合并多个仓库,并在同一个分组对话框中查看
- 交互式选择对话框:先按仓库和类型筛选、按关键词搜索并查看描述信息,再勾选要安装的插件,只安装所选子集
- 国际化:支持 11 种语言
流程
用户输入
│
▼
┌─────────────────────────────────────┐
│ 从 GitHub 多仓库发现插件 │
│ (获取文件树 + 解析 .py 文件) │
└─────────────────────────────────────┘
│
▼
┌─────────────────────────────────────┐
│ 按类型和关键词过滤 │
│ (tool/filter/pipe/action) │
└─────────────────────────────────────┘
│
▼
┌─────────────────────────────────────┐
│ 显示选择对话框 │
│ (仓库分组 + 筛选 + 搜索) │
└─────────────────────────────────────┘
│
├── [取消] → 结束
│
▼
┌─────────────────────────────────────┐
│ 安装到 OpenWebUI │
│ (更新或创建每个插件) │
└─────────────────────────────────────┘
│
▼
完成
使用方法
- 打开 OpenWebUI,进入 Workspace > Tools
- 从市场安装 Batch Install Plugins from GitHub
- 为你的模型/对话启用此工具
- 让模型调用工具来安装插件
交互式安装工作流
repo 参数现在支持多个 owner/repo,可用逗号、分号或换行分隔。
在插件发现和过滤完成后,OpenWebUI 会通过 execute 事件打开浏览器选择对话框。对话框会合并所有目标仓库的结果,按仓库分组展示,并支持仓库标签、类型筛选、关键词搜索和描述查看,再开始调用安装 API。
如果一次用户请求里提到了多个仓库,尽量保持在同一次请求里,让模型把它们合并到一次工具调用中。
快速开始:安装热门插件集
复制下面这条提示词,粘贴到你的对话框中:
从 Fu-Jie/openwebui-extensions、iChristGit/OpenWebui-Tools、Haervwe/open-webui-tools、Classic298/open-webui-plugins、suurt8ll/open_webui_functions、rbb-dev/Open-WebUI-OpenRouter-pipe 安装所有插件
弹窗出现后,直接用里面的仓库标签、类型筛选和关键词搜索来缩小范围再安装。已安装的插件会自动更新。
需要时,你也可以把这串仓库替换成你自己的插件仓库组合。
默认仓库
未指定仓库时,工具会使用 Fu-Jie/openwebui-extensions(我的个人合集)。
插件检测规则
Fu-Jie/openwebui-extensions(严格模式)
对于默认仓库,工具会采用更严格的筛选规则:
- 包含
class Tools:、class Filter:、class Pipe:或class Action:的.py文件 - Docstring 中包含
title:、description:和openwebui_id:元数据 - 文件名不能以
_cn结尾
其他公开 GitHub 仓库
其他仓库的插件必须满足:
- 包含
class Tools:、class Filter:、class Pipe:或class Action:的.py文件 - Docstring 中包含
title:和description:字段
配置(Valves)
| 参数 | 默认值 | 描述 |
|---|---|---|
SKIP_KEYWORDS |
test,verify,example,template,mock |
逗号分隔的跳过关键词 |
TIMEOUT |
20 |
请求超时时间(秒) |
选择对话框超时时间
插件选择对话框的默认超时时间为 2 分钟(120 秒),为用户提供充足的时间来:
- 阅读和查看插件列表
- 勾选或取消勾选想安装的插件
- 处理网络延迟
支持
⭐ 如果这个插件对你有帮助,欢迎到 OpenWebUI Extensions 点个 Star,这将是我持续改进的动力,感谢支持。