logo
Sign In

User Map Context Clip Filter

function

Limit context messages by admin-defined per-user map, with admin users unlimited.

lyxy00
@lyxy00
·
8 months ago
56
0
1.6K
Updated 8 months ago
Created Dec 12, 2025
user_map_context_clip_filter.py
Python · 196 lines
"""
title: Limit conversation context per user
id: user_map_context_clip_filter
author: gpt-5.1
version: 0.8.0
description: Limit context messages by admin-defined per-user map, with admin users unlimited.
"""

from typing import Optional, Any, Dict, Callable, Awaitable
from pydantic import BaseModel, Field
import json

Limit conversation context per user

Filter for Open WebUI that clips conversation context per user (by ID or email).
Limit counts only context messages and excludes the current message.

Features

  • Admins (role=admin) have unlimited context.
  • Per-user limits via user id or email.
  • Priority: id → email.
  • Fallback to default_max_messages.
  • Optionally keep the first system message.
  • Shows a frontend toast notification when clipping is applied.
  • limit=0 keeps only the current message (plus system if enabled).

Key Settings (Valves)

  • default_max_messages
  • user_limits_json
  • keep_system
  • debug_logging

Example

json
{
  "[email protected]": 16,
  "c162258a-e1d3-48e3-8bfb-e513b1f15e83": 8
}

Copy user_map_context_clip_filter.py to Open WebUI under Admin ▸ Filters to enable.

按用户限制上下文消息条数

这是一个 Open WebUI 的 Filter 插件，用于根据用户 ID / Email 对上下文消息进行裁剪。
limit 只统计“上下文消息数”，不包含当前消息。

功能

  • 管理员（role=admin）无限制上下文。
  • 支持按 user id / email 设置不同 max_messages。
  • 匹配优先级：id → email。
  • 未命中用户使用 default_max_messages。
  • 可选始终保留第一条 system 消息。
  • 发生裁剪时，会在前端显示 toast 通知。
  • limit=0 时仅保留当前消息（如果启用 keep_system 则加上 system）。

核心配置（Valves）

  • default_max_messages
  • user_limits_json
  • keep_system
  • debug_logging

示例

json
{
  "[email protected]": 16,
  "c162258a-e1d3-48e3-8bfb-e513b1f15e83": 8
}

将 user_map_context_clip_filter.py 上传到 Open WebUI 的 Admin ▸ Filters 即可启用。

0