fix: automate cross-source media library audits

2026-08-24 12:02:03 +02:00
parent 5008f3329c
commit 5834342f8c
9 changed files with 101 additions and 8 deletions
@@ -15,7 +15,7 @@
 | Platform Context MCP | Athena-/MikeAI-Wissen, begrenzter Laufzeitsnapshot und kontrollierte Dokumentationspflege | eigener Container ohne Docker-Socket, Shell, Egress oder Secrets | Kern |
 | Athena Operator MCP | Entwicklung und vollständiger Betrieb der KI-Plattform mit gebundenen Freigaben | unprivilegierte MCP-Fassade plus rootseitiger strukturierter Executor; keine freie Shell | Kern |
 | Operator-Kontext | `docs/QWEN_OPERATOR_CONTEXT.md` plus `config/operator-system-prompt.txt` | versionierte Selbstbeschreibung und Sicherheitsregeln für Qwen | Kern |
-| Unraid/MUA | MUA r019+ auf dem HomeServer, direkter MCP-Endpunkt | read-only Automatik; Verwaltung bei explizitem Änderungsauftrag; idempotente Batch-Updates | Kern |
+| Unraid/MUA | MUA r020+ auf dem HomeServer, direkter MCP-Endpunkt | read-only Automatik; begrenzte Datei-/Medieninventare; Verwaltung bei explizitem Änderungsauftrag; idempotente Batch-Updates | Kern |
 | Whisper | ggml-org/whisper.cpp | Service im Router-Deploy | optional |
 | XTTS-v2 | Coqui, offizielles CUDA-12.1-Image per Digest | RTX-3060-Container, Stimme `Annmarie Nele`, CPML | Kern |
 | TTS-Gateway | `platform/docker/tts-gateway/` | interne Queue, stabile deutsche Satzblöcke, automatische Erkennung rein englischer Texte und Piper-Fallback | Kern |
@@ -189,8 +189,12 @@ Die Bereitstellung ersetzt niemals die ausdrückliche Änderungsanweisung.
 Unraid ist ausschließlich über das MUA-Plugin angebunden. Die Verbindungen
 `mua-readonly-local` und `mua` nutzen denselben MUA-Endpunkt. Mehrere bestätigte
 Docker-Updates laufen ab MUA r019 gebündelt und idempotent; echte Image-IDs
-verhindern Neuerstellungen aufgrund eines veralteten Statuscaches. Der frühere
-GraphQL-basierte Unraid-MCP wurde
+verhindern Neuerstellungen aufgrund eines veralteten Statuscaches.
+Ab MUA r020 inventarisiert `unraid_files_inventory` Datei- und Ordnernamen
+begrenzt, ohne Dateiinhalte zu lesen. Auto Tool Selector 3.4 hält ausdrücklich
+lesende Bibliotheksprüfungen bei MUA read-only und verwechselt Hörspielfolgen
+nicht mit Sonarr-Episoden. Der Ablauf steht in
+`docs/UNRAID_MEDIA_AUDIT_WORKFLOW.md`. Der frühere GraphQL-basierte Unraid-MCP wurde
 entfernt und gehört weder zum Start noch zum Recovery.

 Der GitHub-Container läuft produktiv. Token-Datei, interner
@@ -63,6 +63,9 @@ laufen, sondern alle fachlichen Funktionen geprüft wurden.
      MUA read-only plus Verwaltung
 - [ ] MUA r019 oder neuer meldet `unraid_docker_update_verified_batch`; ein
      Wiederholungstest mit aktuellem Image endet ohne Container-Neuerstellung
+- [ ] MUA r020 oder neuer meldet `unraid_files_inventory`; ein lesender
+      Medienauftrag aktiviert nur MUA read-only und kann einen Sammlungsordner
+      plus dessen Dateinamen in zwei begrenzten Aufrufen erfassen
 - [ ] eine synthetische CSV wird lokal ausgewertet; kein Webwerkzeug erhält Dateidaten
 - [ ] ein rekursiver GitHub-Komplettbaum ist nicht als Werkzeug verfügbar
 - [ ] der zweite identische Werkzeugaufruf wird gestoppt und eine Abschlussantwort erzeugt
@@ -18,6 +18,9 @@ Reihenfolge ist absichtlich festgelegt:
   bleiben read-only. Docker-Updates verwenden MUA r019 gebündelt, vergleichen
   echte Image-IDs und erhalten den Laufzustand. Die Auswahl eines MCP ist
   ausdrücklich keine Freigabe für eine andere Zustandsänderung.
+   Medienbestandsprüfungen verwenden ab MUA r020 zuerst eine gezielte
+   Verzeichnissuche und danach ein Inventar des exakten relativen Pfads mit
+   `unraid_files_inventory`; wiederholte `ls`/`find`-Aufrufe sind nur Fallback.
 4. `MikeAI Stability Guard`, Priorität 30: begrenzt einzelne und gesamte
   Werkzeugresultate, verdichtet bei Bedarf zuerst alte Tool-Ausgaben und
   Dialogteile und stoppt identische beziehungsweise ausufernde Tool-Schleifen.
@@ -241,7 +241,7 @@ WireGuard-Adresse sind alle Fach-MCPs direkt erreichbar.
 | Home Assistant | Zustände, Historie, Diagnose, begrenzte YAML-Abläufe | Lesen; Schreiben nur Preview/Approval |
 | ARR | Sonarr/Radarr, Indexersuche, kontrollierte Grabs | Lesen; Schreiben nur Preview/Approval |
 | Navidrome | Bibliothek, Empfehlungen, Playlists/Favoriten | eigener Benutzer; gezielt aktivieren |
-| MUA read-only | Host-, Docker-, Array-, Netzwerk- und Logdiagnose | automatischer Standard |
+| MUA read-only | Host-, Docker-, Array-, Netzwerk-, Log- und begrenzte Datei-/Medieninventare | automatischer Standard |
 | MUA/Admin | eng definierte Unraid-Verwaltung | bei ausdrücklich verlangter Änderung automatisch zusätzlich bereitgestellt |

 Für automatische Unraid-Diagnose existiert in Open WebUI zusätzlich
@@ -0,0 +1,57 @@
+# Automatische Medienbestandsprüfung auf Unraid
+
+Stand: 24. August 2026
+
+## Zweck
+
+Lokale Medienbestände können in einem Open-WebUI-Auftrag mit einer offiziellen
+Online-Liste verglichen werden, ohne dass der Benutzer Werkzeuge nachträglich
+einschaltet. Der Ablauf bleibt vollständig read-only.
+
+## Werkzeugwahl
+
+Der Auto Tool Selector 3.4 erkennt einen ausdrücklich lesenden Unraid-Auftrag
+und stellt ausschließlich `mua-readonly-local` bereit. Wörter wie „Folgen
+fehlen“ oder „Hörspielserie“ aktivieren nicht mehr fälschlich Sonarr/Radarr.
+Formulierungen wie „ohne Änderungen“, „ohne Downloads“ und „keinerlei
+Änderungen“ verhindern zuverlässig die Auswahl von MUA-Admin.
+
+Die öffentliche Recherche erfolgt anschließend mit Open WebUIs nativen
+Werkzeugen `search_web` und `fetch_url`.
+
+## Dateiinventar
+
+MUA r020 stellt `unraid_files_inventory` bereit. Das Werkzeug liest keine
+Dateiinhalte und akzeptiert ausschließlich einen vorhandenen Unraid-Share plus
+einen relativen Pfad unterhalb dieses Shares. Pfadtraversal, absolute Pfade und
+Symlink-Verfolgung sind gesperrt. Tiefe, Trefferzahl und Zahl der untersuchten
+Einträge sind begrenzt.
+
+Empfohlener Ablauf:
+
+1. `unraid_shares_list` nur dann verwenden, wenn der Share unbekannt ist.
+2. Mit `unraid_files_inventory`, `name_contains` und nur Verzeichnissen die
+   passende Sammlung lokalisieren.
+3. Den exakten zurückgegebenen `relative_path` in einem zweiten Aufruf ohne
+   Namensfilter inventarisieren.
+4. Aus Dateinamen lokale Nummern/Titel extrahieren.
+5. Offizielle Liste über native Websuche ermitteln und Differenz bilden.
+6. Fehlende Titel beim gewünschten Anbieter gezielt verifizieren.
+7. Fakten, Dateinamen-Schlussfolgerungen und Unsicherheiten getrennt ausgeben.
+
+Die generische Nur-Lese-Shell ist nur ein Fallback, wenn das Inventarwerkzeug
+die konkrete Frage nicht beantworten kann. Wiederholte `ls`/`find`-Ketten sind
+für Bibliotheksprüfungen nicht vorgesehen.
+
+## Regressionstest
+
+Der ursprüngliche Lauf zur Reihe „Die drei ???“ brauchte nach dem Share-Fund
+vier einzelne Shell-Aufrufe und verbrauchte das Werkzeugbudget vor dem
+eigentlichen Datei- und Webabgleich. Dieser Fall ist der verbindliche
+Regressionstest für Selector 3.4 und MUA r020:
+
+- automatisch nur MUA read-only;
+- höchstens zwei Inventaraufrufe für Lokalisierung und Bestand;
+- danach native Webrecherche;
+- keine Rückfrage, kein Download und keine Dateisystemänderung.
+