Rozwiązywanie problemów z SL5 Aura¶

Szybka diagnoza¶

Zawsze zaczynaj tutaj:

KOD_BLOKU_0

Problem: Aura nie uruchamia się¶

Objaw: Brak dźwięku uruchamiania, brak widocznego procesu w pgrep.

Sprawdź dziennik: KOD_BLOKU_1

Częste przyczyny:

Błąd w logu	Napraw
`ModuleNotFoundError`	Uruchom ponownie skrypt instalacyjny: `bash setup/manjaro_arch_setup.sh`
`Brak modułu o nazwie 'objgraph'`	Odtworzono plik `.venv` — zainstaluj ponownie: `pip install -r wymagania.txt`
`Adres już używany`	Zabij stary proces: `pkill -9 -f aura_engine`
`Nie znaleziono modelu`	Uruchom ponownie instalację, aby pobrać brakujące modele
`pygame.mixer niedostępny`	Zobacz „Brak dźwięku podczas uruchamiania” poniżej

Problem: Brak dźwięku podczas uruchamiania (pygame.mixer)¶

Objaw: Ostrzeżenie lub błąd dotyczący pygame.mixer jest niedostępny. Zaczyna się aura ale nie odtwarza żadnych dźwięków.

Przyczyna: Kompilacja pygame w Twoim systemie nie obsługuje dźwięku ani SDL2 brakuje bibliotek audio.

Poprawka w Arch/Manjaro: KOD_BLOKU_2

Poprawka w Ubuntu/Debianie: KOD_BLOKU_3

Aura będzie nadal działać bez dźwięku — nie jest to błąd krytyczny.

Problem: Aura ulega awarii po pierwszym dyktowaniu¶

Objaw: Działa raz, a następnie cicho gaśnie.

Sprawdź stderr: KOD_BLOKU_4

Jeśli widzisz „Błąd segmentacji” lub „Podwójnie wolne”:

Jest to znany problem w systemach z glibc 2.43+ (CachyOS, nowszy Arch).

KOD_BLOKU_5

mimalloc jest automatycznie używany przez skrypt startowy, jeśli jest zainstalowany. Potwierdź, że jest aktywny — powinieneś zobaczyć to przy uruchomieniu: KOD_BLOKU_6

Problem: Klawisz spustowy nic nie robi¶

Objaw: Naciskasz klawisz skrótu, ale nic się nie dzieje — brak dźwięku, brak tekstu.

Sprawdź, czy przeglądarka plików jest uruchomiona: KOD_BLOKU_7

Jeśli nic się nie pojawi, uruchom ponownie Aurę: KOD_BLOKU_8

Sprawdź, czy tworzony jest plik wyzwalacza: KOD_BLOKU_9

Jeśli plik nigdy nie zostanie utworzony, oznacza to, że klawisz skrótu nie działa — patrz poniżej.

Problem: Klawisz skrótu nie działa w Waylandzie¶

Objaw: CopyQ jest zainstalowany i skonfigurowany, ale naciśnięcie klawisza skrótu działa nic na sesji Waylanda.

Przyczyna: Globalne skróty klawiszowe CopyQ nie działają niezawodnie na Waylandzie bez dodatkowa konfiguracja. Dotyczy to KDE Plasma, GNOME i innych Kompozytorzy Waylanda.

Opcja 1: Ustawienia systemu KDE (zalecane dla plazmy KDE)¶

Otwórz Ustawienia systemu → Skróty → Skróty niestandardowe
Utwórz nowy skrót typu Polecenie/URL
Ustaw polecenie na: KOD_BLOKU_10
Przypisz preferowaną kombinację klawiszy (np. F9 lub Ctrl+Alt+Spacja)

Opcja 2: dotool (działa na każdym kompozytorze Waylanda)¶

KOD_BLOKU_11

Następnie użyj menedżera skrótów na pulpicie, aby uruchomić: KOD_BLOKU_12

Opcja 3: ydotool¶

KOD_BLOKU_13

Następnie skonfiguruj skrót do uruchomienia: KOD_BLOKU_14

Opcja 4: GNOME (przy użyciu ustawień dconf / GNOME)¶

Otwórz Ustawienia → Klawiatura → Skróty niestandardowe
Dodaj nowy skrót za pomocą polecenia: KOD_BLOKU_15
Przypisz kombinację klawiszy

Opcja 5: CopyQ z poprawką Waylanda¶

Niektóre kompozytorzy Waylanda umożliwiają działanie CopyQ, jeśli zostaną uruchomione z: KOD_BLOKU_16

Zmusza to CopyQ do korzystania z XWayland, który obsługuje globalne skróty klawiszowe.

Problem: Tekst pojawia się, ale bez poprawek¶

Objaw: Dyktowanie działa, ale wszystko pozostaje zapisane małymi literami, bez poprawek gramatycznych.

Sprawdź, czy LanguageTool jest uruchomiony: KOD_BLOKU_17

Jeśli zwróci błąd, oznacza to, że LanguageTool nie działa. Aura powinna to rozpocząć automatycznie — sprawdź dziennik pod kątem błędów związanych z LanguageTool:

KOD_BLOKU_18

Sprawdź dziennik LanguageTool: KOD_BLOKU_19

Problem: Aura zawiesza się w trybie DEV_MODE¶

Objaw: Przy DEV_MODE = 1, Aura zawiesza się po pierwszym uruchomieniu i zatrzymuje się odpowiadanie.

Przyczyna: Duża liczba logów z wielu wątków przeciąża system rejestrowania.

Poprawka: Dodaj filtr dziennika w config/filters/settings_local_log_filter.py:

KOD_BLOKU_20

Zapisz plik — Aura automatycznie przeładuje filtr. Nie ma potrzeby ponownego uruchamiania.

Problem: plik plugins.zip rośnie w nieskończoność / Wysoki procesor¶

Objaw: 100% procesora, wentylatory pracują na pełnych obrotach, plik plugins.zip rośnie bez przerwy.

Przyczyna: Bezpieczny program pakujący przepakowuje pliki w nieskończonej pętli.

Poprawka: Upewnij się, że pliki .blob i .zip są wykluczone ze skanowania sygnatury czasowej. Sprawdź scripts/py/func/secure_packer_lib.py wokół linii 86:

KOD_BLOKU_21

Jeśli brakuje tej linii, dodaj ją.

Problem: Reguły nie uruchamiają się¶

Objaw: Dyktujesz frazę wyzwalającą, ale reguła nic nie daje.

Lista kontrolna:

Czy reguła znajduje się we właściwym pliku? (FUZZY_MAP_pre.py = przed LanguageTool, FUZZY_MAP.py = po)
Czy plik mapy został zapisany? Aura ładuje się ponownie po zapisaniu — sprawdź dziennik Załadowano ponownie pomyślnie.
Czy wzór odpowiada temu, co faktycznie transkrybuje Vosk? Sprawdź dziennik surowa transkrypcja: KOD_BLOKU_22
Czy ustawiono opcję „tylko_w_oknach” i aktywne jest niewłaściwe okno?
Czy najpierw dopasowuje się bardziej ogólną regułę? Reguły są przetwarzane od góry do dołu — przedkładać szczegółowe zasady nad ogólne.

Zbieranie dzienników w celu raportowania błędów¶

Zgłaszając problem, podaj:

KOD_BLOKU_23

Wyślij do: GitHub Issues