cea31fed38
Add Batch Install Plugins from GitHub tool with: - One-click installation of plugins from GitHub repositories - Smart plugin discovery with metadata extraction and validation - Confirmation dialog with plugin list preview - Selective installation with keyword-based filtering - Smart fallback: auto-retry with localhost:8080 on connection failure - Enhanced debugging with frontend and backend logging - 120-second confirmation timeout for user convenience - Async httpx client for non-blocking I/O - Complete i18n support across 11 languages - Event emitter handling with fallback support - Timeout guards on frontend JavaScript execution - Filtered list consistency for confirmation and installation - Auto-exclusion of tool itself from batch operations - 6 regression tests with 100% pass rate Documentation includes: - English and Chinese READMEs with flow diagrams - Popular repository examples (iChristGit, Haervwe, Classic298, suurt8ll) - Mirrored docs for official documentation site - Plugin index entries in both languages - Comprehensive release notes (v1.0.0.md and v1.0.0_CN.md) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
68 lines
2.9 KiB
Markdown
68 lines
2.9 KiB
Markdown
[](https://openwebui.com/t/fujie/batch_install_plugins)
|
||
|
||
## 概述
|
||
|
||
从 GitHub 批量安装插件是一款全新的 OpenWebUI 工具，支持直接从 GitHub 仓库一键安装多个插件。此首个发布版本包含了全面的插件发现、过滤和安装功能，支持用户确认流程、广泛的多语言支持，以及针对容器部署的健壮调试能力。
|
||
|
||
**[📖 README](https://github.com/Fu-Jie/openwebui-extensions/blob/main/plugins/tools/batch-install-plugins/README_CN.md)**
|
||
|
||
## 主要功能
|
||
|
||
- **一键安装**：通过单个命令安装仓库中的所有插件
|
||
- **智能插件发现**：解析 Python 文件提取元数据并自动验证插件
|
||
- **多类型支持**：在单个操作中支持 Pipe、Action、Filter 和 Tool 插件
|
||
- **确认对话框**：安装前显示插件列表供用户审查和批准
|
||
- **选择性安装**：通过基于关键词的过滤排除特定插件
|
||
- **智能降级**：容器环境中主 URL 连接失败时自动重试 localhost:8080
|
||
- **增强调试**：前端 JavaScript 和后端 Python 富日志输出，便于排查问题
|
||
- **延长超时**：120 秒确认窗口，给用户充分的思考时间
|
||
- **异步架构**：非阻塞 I/O 操作，性能更优
|
||
- **完整国际化**：支持 11 种语言，包含适当的回退机制
|
||
- **自动更新**：自动更新之前安装过的插件
|
||
- **自排除机制**：自动排除工具自身，避免在批量操作中重复安装
|
||
|
||
## 技术亮点
|
||
|
||
- **httpx 集成**：现代化的异步 HTTP 客户端，请求更可靠且非阻塞
|
||
- **事件注入支持**：正确处理 OpenWebUI 事件注入，提供回退支持
|
||
- **超时保护**：前端执行周围包装了超时保护，防止进程挂起
|
||
- **过滤列表一致性**：确认和安装使用同一份过滤列表
|
||
- **错误本地化**：所有错误消息都是面向用户的，已正确本地化到各语言
|
||
- **部署弹性**：智能 Base URL 解析处理域名、localhost 和容器化环境
|
||
|
||
## 支持的仓库
|
||
|
||
- **默认**：Fu-Jie/openwebui-extensions（严格验证）
|
||
- **自定义**：任意 GitHub 仓库中的 Python 插件文件
|
||
|
||
## 测试覆盖
|
||
|
||
包含全面的回归测试：
|
||
- 过滤安装列表一致性
|
||
- 缺少事件注入器时的处理
|
||
- 确认超时验证
|
||
- 完全失败场景
|
||
- 本地化完整性
|
||
- 连接错误调试日志和智能降级
|
||
|
||
所有 6 个测试均通过。
|
||
|
||
## 文档
|
||
|
||
- 英文 README，包含流程图和使用示例
|
||
- 中文 README (README_CN.md)，完整翻译
|
||
- 官方文档站点的镜像文档
|
||
- 英文和中文的插件索引条目
|
||
|
||
## 兼容性
|
||
|
||
- OpenWebUI：0.2.x - 0.8.x
|
||
- Python：3.9+
|
||
- 依赖：httpx（异步 HTTP 客户端）、pydantic（类型验证）
|
||
|
||
## 发布说明
|
||
|
||
- 本首发 v1.0.0 版本包含完整的插件基础设施和智能部署处理能力。
|
||
- 该插件设计用于处理多种部署场景（域名、localhost、容器化），配置最少。
|
||
|