Fehlerbehebung bei SL5 Aura¶

Schnelle Diagnose¶

Beginnen Sie immer hier:

# Check the main log:
tail -50 log/aura_engine.log

# Is Aura running?
pgrep -a -f aura_engine.py

# Is the file watcher running?
pgrep -a type_watcher

Problem: Aura startet nicht¶

Symptom: Kein Startton, kein Prozess in „pgrep“ sichtbar.

Überprüfen Sie das Protokoll:

tail -30 log/aura_engine.log

Häufige Ursachen:

Fehler im Protokoll	Fix
`ModuleNotFoundError`	Führen Sie das Setup-Skript erneut aus: „bash setup/manjaro_arch_setup.sh“
`Kein Modul namens 'objgraph'`	„.venv“ wurde neu erstellt – Neuinstallation: „pip install -r require.txt“
`Adresse bereits verwendet`	Alten Prozess beenden: `pkill -9 -f aura_engine`
„Modell nicht gefunden“	Führen Sie das Setup erneut aus, um fehlende Modelle herunterzuladen
`pygame.mixer nicht verfügbar`	Siehe „Kein Ton beim Start“ unten

Problem: Kein Ton beim Start (pygame.mixer)¶

Symptom: Warnung oder Fehler bezüglich „pygame.mixer“ nicht verfügbar. Aura beginnt spielt aber keine Töne ab.

Ursache: Der Pygame-Build Ihres Systems beinhaltet keine Audiounterstützung oder SDL2 Audiobibliotheken fehlen.

Fix auf Arch/Manjaro:

sudo pacman -S sdl2_mixer
pip install pygame-ce --upgrade

Fix auf Ubuntu/Debian:

sudo apt install libsdl2-mixer-2.0-0
pip install pygame-ce --upgrade

Aura funktioniert weiterhin ohne Ton – dies ist kein schwerwiegender Fehler.

Problem: Aura stürzt nach dem ersten Diktat ab¶

Symptom: Funktioniert einmal und endet dann lautlos.

Überprüfen Sie stderr:

cat /tmp/aura_stderr.log | tail -30

Wenn Sie „Segmentierungsfehler“ oder „doppelt frei“ sehen:

Dies ist ein bekanntes Problem auf Systemen mit glibc 2.43+ (CachyOS, neueres Arch).

sudo pacman -S mimalloc

mimalloc wird automatisch vom Startskript verwendet, sofern es installiert ist. Bestätigen Sie, dass es aktiv ist. Beim Start sollte Folgendes angezeigt werden:

Info: Using mimalloc for improved memory management (/usr/lib/libmimalloc.so).

Problem: Auslösetaste bewirkt nichts¶

Symptom: Sie drücken den Hotkey, aber es passiert nichts – kein Ton, kein Text.

Überprüfen Sie, ob der Datei-Watcher läuft:

pgrep -a type_watcher

Wenn nichts angezeigt wird, starten Sie Aura neu:

./scripts/restart_venv_and_run-server.sh

Überprüfen Sie, ob die Triggerdatei erstellt wird:

ls -la /tmp/sl5_record.trigger

Wenn die Datei nie erstellt wird, funktioniert Ihr Hotkey nicht – siehe unten.

Problem: Hotkey funktioniert nicht auf Wayland¶

Symptom: CopyQ ist installiert und konfiguriert, das Drücken des Hotkeys funktioniert jedoch nichts auf einer Wayland-Sitzung.

Ursache: Die globalen Hotkeys von CopyQ funktionieren auf Wayland ohne nicht zuverlässig zusätzliche Konfiguration. Dies betrifft KDE Plasma, GNOME und andere Wayland-Komponisten.

Option 1: KDE-Systemeinstellungen (empfohlen für KDE Plasma)¶

Öffnen Sie Systemeinstellungen → Verknüpfungen → Benutzerdefinierte Verknüpfungen
Erstellen Sie eine neue Verknüpfung vom Typ Befehl/URL
Stellen Sie den Befehl ein auf:
```
touch /tmp/sl5_record.trigger
```
Weisen Sie Ihre bevorzugte Tastenkombination zu (z. B. „F9“ oder „Strg+Alt+Leertaste“)

Option 2: dotool (Funktioniert auf jedem Wayland-Compositor)¶

# Install dotool:
sudo pacman -S dotool        # Arch/Manjaro
# or
sudo apt install dotool      # Ubuntu (if available)

Verwenden Sie dann den Verknüpfungsmanager Ihres Desktops, um Folgendes auszuführen:

touch /tmp/sl5_record.trigger

Option 3: ydotool¶

sudo pacman -S ydotool
sudo systemctl enable --now ydotool

Konfigurieren Sie dann Ihre Verknüpfung für die Ausführung:

touch /tmp/sl5_record.trigger

Option 4: GNOME (mit dconf / GNOME-Einstellungen)¶

Öffnen Sie Einstellungen → Tastatur → Benutzerdefinierte Verknüpfungen
Fügen Sie eine neue Verknüpfung mit dem folgenden Befehl hinzu:
```
touch /tmp/sl5_record.trigger
```
Weisen Sie eine Tastenkombination zu

Option 5: CopyQ mit Wayland-Fix¶

Einige Wayland-Compositors erlauben die Arbeit von CopyQ, wenn es mit Folgendem gestartet wird:

QT_QPA_PLATFORM=xcb copyq

Dadurch wird CopyQ gezwungen, XWayland zu verwenden, das globale Hotkeys unterstützt.

Problem: Text erscheint, aber ohne Korrekturen¶

Symptom: Das Diktat funktioniert, aber alles bleibt in Kleinbuchstaben geschrieben, es gibt keine Grammatikkorrekturen.

Überprüfen Sie, ob LanguageTool ausgeführt wird:

curl -s http://127.0.0.1:8082/v2/languages | head -5

Wenn dies einen Fehler zurückgibt, wird LanguageTool nicht ausgeführt. Aura sollte damit beginnen automatisch – überprüfen Sie das Protokoll auf Fehler im Zusammenhang mit LanguageTool:

grep -i "languagetool\|LT\|8082" log/aura_engine.log | tail -10

Überprüfen Sie das LanguageTool-Protokoll:

cat log/languagetool_server.log | tail -20

Problem: Aura bleibt im DEV_MODE hängen¶

Symptom: Bei „DEV_MODE = 1“ bleibt Aura nach dem ersten Auslöser hängen und stoppt antworten.

Ursache: Ein hohes Protokollvolumen von mehreren Threads überlastet das Protokollierungssystem.

Fix: Fügen Sie einen Protokollfilter in „config/filters/settings_local_log_filter.py“ hinzu:

LOG_ONLY = [
    r"Successfully",
    r"CRITICAL",
    r"📢📢📢 #",
    r"window_title",
    r":st:",
]
LOG_EXCLUDE = []

Speichern Sie die Datei – Aura lädt den Filter automatisch neu. Kein Neustart erforderlich.

Problem: „plugins.zip“ wächst endlos / hohe CPU-Auslastung¶

Symptom: 100 % CPU, Lüfter auf Hochtouren, „plugins.zip“ wächst ohne anzuhalten.

Ursache: Der Secure Packer packt Dateien in einer Endlosschleife neu.

Fix: Stellen Sie sicher, dass „.blob“- und „.zip“-Dateien vom Zeitstempelscan ausgeschlossen sind. Überprüfen Sie „scripts/py/func/secure_packer_lib.py“ in Zeile 86:

if file.startswith('.') or file.endswith('.pyc') or file.endswith('.blob') or file.endswith('.zip'):
    continue

Wenn diese Zeile fehlt, fügen Sie sie hinzu.

Problem: Regeln werden nicht ausgelöst¶

Symptom: Sie diktieren eine Triggerphrase, aber die Regel führt nichts aus.

Checkliste:

Ist die Regel in der richtigen Datei? (FUZZY_MAP_pre.py = vor LanguageTool, FUZZY_MAP.py = danach)
Wird die Kartendatei gespeichert? Aura wird beim Speichern neu geladen – überprüfen Sie das Protokoll „Erfolgreich neu geladen“.
Stimmt das Muster mit dem überein, was Vosk tatsächlich transkribiert? Überprüfen Sie das Protokoll auf die rohe Transkription:
```
grep "Yielding chunk" log/aura_engine.log | tail -5
```
Ist „only_in_windows“ eingestellt und das falsche Fenster ist aktiv?
Passt zuerst eine allgemeinere Regel? Regeln werden von oben nach unten verarbeitet – Stellen Sie spezifische Regeln vor allgemeine Regeln.

Sammeln von Protokollen für Fehlerberichte¶

Wenn Sie ein Problem melden, geben Sie bitte Folgendes an:

# Last 100 lines of main log:
tail -100 log/aura_engine.log

# Crash output:
cat /tmp/aura_stderr.log

# System info:
uname -a
python3 --version

Posten an: GitHub Issues