ff44d324eb
- Redefine keep_first to count only non-system messages, protecting the first N user/assistant exchanges plus all interleaved system messages - System messages in the compression gap are now extracted and preserved as original messages instead of being summarized - System messages dropped during forced trimming are re-inserted into the final output - Change keep_first default from 1 to 0 - Update docstring, README, README_CN, WORKFLOW_GUIDE_CN, and docs mirrors Fixes #62
Filters
English | 中文
Filters process and modify user input before it is sent to the LLM. This directory contains various filters that can be used to extend OpenWebUI functionality.
📋 Filter List
| Filter Name | Description | Documentation |
|---|---|---|
| Async Context Compression | Reduces token consumption in long conversations through intelligent summarization and message compression while maintaining conversational coherence. | English / 中文 |
🚀 Quick Start
Installing a Filter
- Navigate to the desired filter directory
- Download the corresponding
.pyfile to your local machine - Open OpenWebUI Admin Settings and find the "Filters" section
- Upload the Python file
- Configure the filter parameters according to its documentation
- Refresh the page and enable the filter in your chat settings
📖 Development Guide
When adding a new filter, please follow these steps:
- Create Filter Directory: Create a new folder in the current directory (e.g.,
my_filter/) - Write Filter Code: Create a
.pyfile with clear documentation of functionality and configuration in comments - Write Documentation:
- Create
filter_name.md(English version) - Create
filter_name_cn.md(Chinese version) - Documentation should include: feature description, configuration parameters, usage examples, and troubleshooting
- Create
- Update This List: Add your new filter to the table above
⚙️ Configuration Best Practices
- Priority Management: Set appropriate filter priority to ensure correct execution order
- Parameter Tuning: Adjust filter parameters based on your specific needs
- Debug Logging: Enable debug mode during development, disable in production
- Performance Testing: Test filter performance under high load
Contributor Note: To ensure project maintainability and user experience, please provide clear and complete documentation for each new filter, including feature description, parameter configuration, usage examples, and troubleshooting guide.
Author
Fu-Jie GitHub: Fu-Jie/openwebui-extensions