130 lines
3.1 KiB
Markdown
130 lines
3.1 KiB
Markdown
# Plugins（插件）
|
||
|
||
[English](./README.md) | 中文
|
||
|
||
此目录包含 OpenWebUI 的三种类型的插件：
|
||
|
||
- **Filters（过滤器）**: 在将用户输入发送给 LLM 前进行处理
|
||
- **Actions（动作）**: 从聊天中触发自定义功能
|
||
- **Pipes（管道）**: 在显示给用户前增强 LLM 响应
|
||
|
||
## 📦 插件类型概览
|
||
|
||
### 🔧 Filters（过滤器）(`/filters`)
|
||
|
||
过滤器在用户输入到达 LLM 前修改它。用途包括：
|
||
|
||
- 输入验证和规范化
|
||
- 添加系统提示或上下文
|
||
- 压缩长对话
|
||
- 预处理和格式化
|
||
|
||
[查看过滤器 →](./filters/README_CN.md)
|
||
|
||
### 🎬 Actions（动作）(`/actions`)
|
||
|
||
动作是从聊天中触发的自定义功能。用途包括：
|
||
|
||
- 生成输出（思维导图、图表等）
|
||
- 与外部 API 交互
|
||
- 数据转换
|
||
- 文件操作和导出
|
||
- 复杂工作流程
|
||
|
||
[查看动作 →](./actions/README_CN.md)
|
||
|
||
### 📤 Pipes（管道）(`/pipes`)
|
||
|
||
管道在 LLM 生成响应后处理它。用途包括：
|
||
|
||
- 响应格式化
|
||
- 内容增强
|
||
- 翻译和转换
|
||
- 响应过滤
|
||
- 与外部服务集成
|
||
|
||
[查看管道 →](./pipes/README_CN.md)
|
||
|
||
## 🚀 快速开始
|
||
|
||
### 安装插件
|
||
|
||
1. **下载**所需的插件文件（`.py`）
|
||
2. **打开** OpenWebUI 管理员设置 → 插件（Plugins）
|
||
3. **选择**插件类型（Filters、Actions 或 Pipes）
|
||
4. **上传**文件
|
||
5. **刷新**页面
|
||
6. **配置**聊天设置中的参数
|
||
|
||
### 使用插件
|
||
|
||
- **Filters（过滤器）**: 启用后自动应用于所有输入
|
||
- **Actions（动作）**: 在聊天时从动作菜单手动选择
|
||
- **Pipes（管道）**: 启用后自动应用于所有响应
|
||
|
||
## 📚 插件文档
|
||
|
||
每个插件目录包含：
|
||
|
||
- 插件代码（`.py` 文件）
|
||
- 英文文档（`README.md`）
|
||
- 中文文档（`README_CN.md`）
|
||
- 配置和使用指南
|
||
|
||
## 🛠️ 插件开发
|
||
|
||
要创建新插件：
|
||
|
||
1. 选择插件类型（Filter、Action 或 Pipe）
|
||
2. 导航到对应的目录
|
||
3. 为插件创建新文件夹
|
||
4. 编写清晰记录的插件代码
|
||
5. 创建 `README.md` 和 `README_CN.md`
|
||
6. 更新该目录中的主 README
|
||
|
||
### 插件结构模板
|
||
|
||
```python
|
||
plugins/
|
||
├── filters/
|
||
│ ├── my_filter/
|
||
│ │ ├── my_filter.py # 插件代码
|
||
│ │ ├── my_filter_cn.py # 可选：中文版本
|
||
│ │ ├── README.md # 文档
|
||
│ │ └── README_CN.md # 中文文档
|
||
│ └── README.md
|
||
├── actions/
|
||
│ ├── my_action/
|
||
│ │ ├── my_action.py
|
||
│ │ ├── README.md
|
||
│ │ └── README_CN.md
|
||
│ └── README.md
|
||
└── pipes/
|
||
├── my_pipe/
|
||
│ ├── my_pipe.py
|
||
│ ├── README.md
|
||
│ └── README_CN.md
|
||
└── README.md
|
||
```
|
||
|
||
## 📋 文档检查清单
|
||
|
||
每个插件应包含：
|
||
|
||
- [ ] 清晰的功能描述
|
||
- [ ] 配置参数及默认值
|
||
- [ ] 安装和设置说明
|
||
- [ ] 使用示例
|
||
- [ ] 故障排除指南
|
||
- [ ] 性能考虑
|
||
- [ ] 版本和作者信息
|
||
|
||
## 作者
|
||
|
||
Fu-Jie
|
||
GitHub: [Fu-Jie/awesome-openwebui](https://github.com/Fu-Jie/awesome-openwebui)
|
||
|
||
---
|
||
|
||
> **注意**：有关每种插件类型的详细信息，请参阅每个插件类型目录中的相应 README 文件。
|