Make OpenWebUI reasoning filter order reproducible

2026-08-21 14:56:39 +02:00
parent bf90698b99
commit 9a40758c7f
7 changed files with 220 additions and 0 deletions
@@ -33,6 +33,7 @@ Chats oder privaten Nutzdaten.
 | Image-Backup | Das alte Archiv `openwebui-mcp-images.tar.gz` enthielt trotz seines Namens nicht das inventarisierte OpenWebUI-Image. | Restore nutzt als sicheren Fallback nur den gesicherten unveränderlichen Digest. Künftige Backups benötigen einen isolierten Probeimport. |
 | Wiederholung | Ein späterer Installerlauf hätte die restaurierte OpenWebUI-Version wieder überschrieben. | Das Restore schreibt den geprüften lokalen Image-Tag auch in die dauerhafte Installationskonfiguration. |
 | TinySearch-Volume | Das vom Installer vorbereitete Modellvolume wurde von Compose gleichzeitig als Compose-eigen behandelt. | Das Volume besitzt einen festen Namen und ist in Compose ausdrücklich als extern vorbereitet markiert. |
+| Reasoning-Filter | Beide globalen Filter besaßen Priorität 0; bei gleicher Priorität entschied die ID-Sortierung statt der gewünschten Logik. | `Reasoning Default Off` läuft mit Priorität 10 sicher vor dem optionalen `Thinking`-Override mit Priorität 20. Filter und sicherer Installer liegen versioniert im Repository. |

 ## Abnahmezustand am 21. August 2026

@@ -72,6 +72,9 @@ enthält, verwendet das Skript ausschließlich den im Docker-Inventar gesicherte
 unveränderlichen Registry-Digest. Es fällt niemals auf `latest` zurück.
 Da lokale Docker-Image-IDs beim Wiederherstellen von einem Registry-Digest
 abweichen können, verifiziert es zusätzlich die gesicherte OCI-Build-Revision.
+Nach dem Datenimport wendet es außerdem die im Repository versionierten
+OpenWebUI-Filter erneut an. Dadurch bleiben auch deren Prioritäten unabhängig
+vom Alter der Datenbanksicherung reproduzierbar.

 Der alte Host bleibt bis zum bestandenen Abnahmetest unverändert und dient nur
 als Referenz. Es werden keine Caches oder unbekannten Altverzeichnisse kopiert.
@@ -1,5 +1,27 @@
 # Betrieb

+## Reasoning-Filter in OpenWebUI
+
+Die versionierten Filter liegen unter `platform/openwebui/filters/`. Ihre
+Reihenfolge ist absichtlich festgelegt:
+
+1. `Reasoning Default Off`, Priorität 10: setzt jeden Request zunächst auf
+   `reasoning_effort=none`.
+2. `Thinking`, Priorität 20: läuft nur bei aktiviertem Brain-Schalter und
+   überschreibt den Standard mit Low, Medium oder High.
+
+OpenWebUI sortiert kleinere Prioritäten zuerst. Nach dem ersten Anlegen eines
+Admin-Benutzers oder nach einer Datenwiederherstellung werden beide Filter mit
+einer vorherigen Datenbanksicherung installiert beziehungsweise aktualisiert:
+
+```bash
+sudo /opt/mike-ai/stack/platform/openwebui/install-filters.sh
+```
+
+Bei mehreren Administratoren muss der gewünschte Eigentümer explizit über
+`OPENWEBUI_FILTER_OWNER_ID` gesetzt werden. Das Skript liest oder verändert
+keine Chats.
+
 ## Profile

 | Profil | Virtuelles Modell | Kontext | Zweck |