feat(batch-install-plugins): initial release v1.0.0
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>
This commit is contained in:
67
plugins/tools/batch-install-plugins/v1.0.0_CN.md
Normal file
67
plugins/tools/batch-install-plugins/v1.0.0_CN.md
Normal file
@@ -0,0 +1,67 @@
|
||||
[](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、容器化),配置最少。
|
||||
|
||||
Reference in New Issue
Block a user