Handbuch / Aktuelle Desktop-Dokumentation

Fehlerbehebung

Fehlende Helfer, Service-Neustarts, Abhängigkeiten, Installationsprüfungen und Backups.

Dies ist das Desktop-Handbuch aus demselben generierten Katalog. Schaltflächen, Panels und Menüs beziehen sich auf den installierten Desktop. Paketaktualisierungen können neuer als die verfügbare ISO sein. Installations- und Validierungsumfang prüfen.

Diesen PC prüfen

Öffnen Sie Einstellungen > System > Instandhaltung > Diesen PC prüfen oder eitr check. Die Prüfungen lesen nur; sie reparieren nichts und starten nichts neu. Paketlisten werden nicht aktualisiert. DNS verwendet das Netzwerk. eitr check --json zeigt technische Details ohne Rückfragen.

Tiefere Prüfungen (Passwort erforderlich): Für tiefere Prüfungen drücken Sie Enter; Esc überspringt sie. Im selben Terminal fragt sudo /usr/lib/eitr/eitr-system selfcheck-deeper nach Ihrem Passwort. Ergebnisse ersetzen passende übersprungene Prüfungen. Gelesen werden Snapper-Konfiguration, Vorher/Nachher-Paare, die letzte erfolgreiche Paketaktualisierung, vorhandene Btrfs-Qgroups, Boot-Guard-JSON, ein bereits eingehängtes Werksmanifest und Arch-Linux/Eitr-Schlüssel mit pacman-key --list-keys. Quoten werden nie aktiviert und das Werksabbild wird nicht eingehängt. Fehlende Daten werden begründet übersprungen; das Manifest bestätigt nicht die Archivintegrität. fsck.vfat -n prüft nur eine eindeutig bestimmte FAT-ESP, die nicht schreibbar eingehängt ist; andernfalls muss sie ausgehängt werden und die Prüfung entfällt.

Fehlgeschlagene Units zeigen bis zu drei Namen und einen Statusbefehl. Snapshot-Beschreibungen bestätigen keine späteren Desktop-Schritte; Hook-Protokolle haben keine Zeitstempel. Für Leistenfehler gibt es keine strukturierte Abfrage. Danach kopiert Enter den redigierten Bericht; Esc schließt. Vor dem Teilen prüfen; Kopieren benötigt wl-copy.

Eine Menüaktion meldet ein fehlendes Werkzeug

Neue Installationen enthalten die Desktop-Abhängigkeiten; auf einem bestehenden Arch können einige fehlen. Lies die genaue Meldung und installiere das Paket über Installieren > Pakete > Pacman oder eine normale vollständige Systemaktualisierung. Entferne BlueZ/iwd/PipeWire/WirePlumber nicht wegen nativer Panels: Diese benötigen die Dienste weiterhin.

Dieses Handbuch braucht kein less. Es ist mitgeliefertes Markdown in einem nativen Fenster. Bei fehlendem oder veraltetem Katalog aktualisierst du die EITR-Desktop-Dateien.

Root-eigenes Hilfsprogramm fehlt

Netzwerkwechsel, Sicherheit, Ladegrenzen und Wiederherstellung benötigen geprüfte Root-eigene Hilfsprogramme. Eine reine Dotfiles-Installation enthält deren Pakete möglicherweise noch nicht. Lies das zugehörige Kapitel. Umgehe die Prüfung niemals durch Ausführen einer vom Benutzer beschreibbaren heruntergeladenen Datei als Root. Das Öffnen der Auswahl darf deine Netzwerkverbindung nicht trennen.

Konfigurations- oder Dienstprobleme

Quickshell zeigt verständliche Neuladefehler und behält möglichst die letzte funktionierende Konfiguration. Korrigiere die genannte Datei; starte den Anmeldemanager nicht wiederholt neu. Starte SDDM niemals während deiner Desktop-Sitzung neu.

Ein Elephant-Neustart lädt Menüdefinitionen neu. Sein Dienst muss KillMode=process behalten, für Helfer und Starts ohne uwsm. In einer uwsm-Sitzung laufen gestartete Anwendungen und Terminals in eigenen Anwendungs-Scopes. Designs erzeugen Stile neu: Verschwindet eine Änderung, korrigiere Generator und erzeugte Ausgabe.

WLAN-Daten werden nicht mehr aktualisiert

Die Leiste nutzt für alle Bildschirme einen gemeinsamen WLAN-Leseprozess. Wenn er endet, bleiben die letzten gültigen Daten als veraltet markiert, während der Prozess mit wachsenden Abständen neu gestartet wird. Nach sechs fehlgeschlagenen Versuchen wartet er auf einen ausdrücklichen Wiederholungsaufruf. Native Bedienelemente bleiben verfügbar. WLAN-Aktionen teilen eine geordnete Warteschlange und einen Belegtstatus über alle Bildschirme. Bei Zeitüberschreitung oder Prozessende ist das Ergebnis unbekannt: Aktualisiere den Zustand vor einem ausdrücklichen neuen Versuch. Schreibaktionen werden nie automatisch wiederholt. QR-Erzeugung bleibt ein separates Hilfsprogramm.

Den technischen Status zeigt eitr-shell desktop-bar ipc call -- data status. Die Ausgabe enthält Datenalter, Fehlercodes, laufende Lesevorgänge, Beobachter und Neustarts, aber keine Netzwerknamen oder Adressen. Ein neuer Versuch erfolgt mit eitr-shell desktop-bar ipc call -- data retry.

Die OBS-Aufnahme nutzt denselben Broker auf allen Bildschirmen. Eine gemeinsame Prüfung läuft alle 2 Sekunden, solange ein OBS-Fenster oder -Prozess bekannt ist. Aufnahmedetails werden nur bei geöffnetem Aufnahmepanel alle 2 Sekunden aktualisiert und liefern auch den gemeinsamen Status. Bei unbekanntem Status bleibt der letzte bekannte Aufnahmezustand erhalten; die Steuerelemente sind bis zu einer erfolgreichen Aktualisierung deaktiviert. Aufnahmeaktionen und Optionsänderungen teilen sich eine geordnete Warteschlange. Bei Zeitüberschreitung oder Beendigung des Brokers ist das Ergebnis unbekannt; die Aktion wird niemals automatisch wiederholt. Der eigenständige OBS-Befehl bleibt für Walker und Screenshot-Tastenkürzel verfügbar.

Akku, Energieprofile und Flugmodus verwenden ebenfalls diesen Broker. Akkudaten werden alle 30 Sekunden gelesen; Profile und Funkstatus nur bei geöffneten zugehörigen Panels. Geräteakkus aktivieren keine Laptop-Steuerung. Akku-Hooks und Warnungen behalten ihre Schwellenwerte. Energieprofil- und Flugmodusaktionen werden geordnet ausgeführt und melden Fehler im anfordernden Panel. Bei unbekanntem Ergebnis werden sie niemals automatisch wiederholt. Die eigenständigen Befehle bleiben verfügbar.

Installation und Wiederherstellung prüfen

EITR ist weiterhin Beta. VM-Tests belegen nicht die Funktion jedes WiFi-Adapters, Bluetooth-Agenten, TPMs, GPUs, Fingerabdrucklesers oder Secure-Boot-Aufbaus. Aktueller WiFi-Dienst- und Unternehmensauthentifizierungscode wird mit Nachbildungen getestet. Prüfe echte Authentifizierung, bevor du dich darauf verlässt. Bestehende ISOs ändern sich nicht mit den Repository-Manifesten; baue Payload und ISO für neue Installationen neu.

Sichere vor der Installation auf einer separaten SSD deine anderen Laufwerke und prüfe das Ziel sorgfältig. Die Installation löscht das von dir bestätigte Laufwerk. Bewahre Passphrasen und Wiederherstellungsschlüssel offline auf. Snapshots derselben SSD sind keine unabhängige Sicherung. Beginne bei Wiederherstellung und Snapshots.

Ein Problem melden

Einstellungen > System > Informationen > Problem melden sammelt EITR- und Paketversionen, Grafikhardware, Hyprland-Fehler, fehlgeschlagene Dienste, aktuelle Warnungen, Abstürze der letzten Woche, Fehler des vorherigen Starts, Installationsprotokoll und letzte Paketänderungen in ~/Documents/eitr-problem-report-<time>.txt. Nur du kannst die Datei lesen. Benutzername, Rechnername, persönlicher Pfad, E-Mail-, IP- und MAC-Adressen werden entfernt; Protokolle können weiterhin Anwendungen oder Dateinamen nennen. Lies den Bericht vor dem Senden.

Nichts wird automatisch versendet. Das Terminal zeigt nur den Speicherort und bietet Versand oder vorheriges Lesen an:

  1. Per E-Mail an reports@eitr.info: Dein E-Mail-Programm öffnet eine Zusammenfassung. Hänge die gespeicherte Datei an.
  2. GitHub-Issue öffnen benötigt ein GitHub-Konto und öffnet ein neues Issue des Projekts. Issues sind öffentlich.
  3. Bericht zum Einfügen kopieren kopiert den Bericht.
  4. Bericht lesen öffnet deinen Texteditor.

Der Bericht dient nur zum Finden und Beheben dieses Problems und wird danach gelöscht. Eine E-Mail teilt deine Adresse mit. Antworte jederzeit darauf, um den Bericht löschen zu lassen.

Wenn etwas abstürzt

Absturzbenachrichtigungen sind standardmäßig eingeschaltet. Ein Benutzerdienst beobachtet neue, lesbare systemd-coredump-Einträge deiner eigenen Programme. Jeder Absturz bietet Problem melden, Ignorieren und Dieses Programm stummschalten; Die KI fragen erscheint, wenn ein Standardassistent installiert und ausgewählt ist. Wiederholte Abstürze desselben Programms erzeugen höchstens alle fünf Minuten eine Benachrichtigung. Ein Absturz, der die Sitzung beendet, wird bei der nächsten Anmeldung angeboten; Programme, die in der Minute nach dem Abmelden, Neustarten oder Herunterfahren abstürzen, dagegen nicht: Ihnen fehlt dann nur der Desktop. Schalte sie unter Hauptmenü > Schnellaktionen oder Kontrollzentrum > Schnellaktionen um. Einstellungen und stummgeschaltete Programmpfade stehen in ~/.config/eitr/crash-help.json; entferne einen Pfad aus ignored, um wieder Hinweise zu erhalten.

Die KI fragen öffnet deinen Standardassistenten nur mit Programm, Signal und Stacktrace aus coredumpctl info. Er soll die Ursache erklären und eine Lösung vorschlagen, ohne das System ohne deine Zustimmung zu ändern. Ein Speicherabbild wird nicht übergeben. Wenn du diese Aktion wählst, kann der Assistent die Zusammenfassung an seinen Anbieter senden. Problem melden fügt dieselbe Zusammenfassung dem vorhandenen Meldeablauf hinzu: Prüfe sie vor dem Teilen; nichts wird automatisch gesendet.

Anpassungen und Aktualisierungen

EITR-Code liegt unter /usr/share/eitr und wird mit eitr-desktop aktualisiert. Deine Einstellungen bleiben unter ~/.config. Dauerhafte Änderungen gehören dorthin, wo Aktualisierungen sie nicht berühren:

  • Monitore, Geräte, zusätzliche Belegungen und Regeln: ~/.config/hypr/local.lua.
  • Shell-Ergänzungen: ~/.config/eitr/shell.local.zsh.
  • Terminaloptionen: ~/.config/kitty/local.conf.
  • Starterfarben: ~/.config/walker/style.override.css.
  • Vollständiger Ersatz einer mitgelieferten Datei: gleicher relativer Pfad unter ~/.config/eitr/overrides. Diese Datei erhält keine Fehlerkorrekturen aus Aktualisierungen mehr.

Designdateien wie kitty/theme.conf und der Walker-Stil werden bei Designwechseln und einmal nach jeder Paketaktualisierung neu erzeugt. Vorherige Kopien liegen unter ~/.local/state/eitr/generated-backups. Ändert sich das Speicherformat einer Einstellung, wird sie einmal bei der Anmeldung umgewandelt. Ein Fehler wird gemeldet und bei der nächsten Anmeldung erneut versucht (~/.local/state/eitr/migrations.log). eitr-config status zeigt wirksame Einstellungen und Überschreibungen.

Fehlgeschlagene Aufgaben bieten bei gewähltem Standardassistenten A: KI fragen; Esc schließt. Nur die letzten 200 Ausgabezeilen bleiben im Speicher; ANSI-Sequenzen werden entfernt und erkennbare Geheimniszeilen vor dem Teilen verborgen: Ein Cloud-Assistent sendet diese Ausgabe an seinen Anbieter, Ratatoskr behält sie auf diesem PC.

Bildschirmtopologie, Helligkeit und Nachtlicht verwenden ebenfalls den gemeinsamen Broker. Monitorereignisse und Änderungen der Hauptbildschirm-Einstellung aktualisieren die Geometrie aller Bildschirme. Helligkeit und Nachtlicht werden nur bei Bedarf aktualisiert; DDC-Helligkeit wird nicht regelmäßig abgefragt. Bildschirmtests behalten ihre unabhängige automatische Rücknahme auch beim Beenden der Leiste oder des Brokers. Die eigenständigen Bildschirmbefehle und Befehle zum Dimmen und Wiederherstellen bleiben verfügbar.

Hardware verwendet einen gemeinsamen Broker für alle Bildschirme und die Hardware-Aktion im Kontrollzentrum. Beim Öffnen werden die Daten sofort und danach alle zwei Sekunden aktualisiert, solange ein Hardware-Panel geöffnet ist. Nach dem Schließen des letzten Panels endet die Abfrage. CPU-, Systemlaufwerk- und GPU-Identität bleiben für die Broker-Sitzung gespeichert, auch bei fehlenden oder zu langsamen GPU-Abfragen. Bei Lesefehlern bleiben die letzten gültigen Abschnitte sichtbar. Die eigenständige CLI system-details.py bleibt verfügbar; eitr-shell desktop-bar ipc call -- data status enthält die Diagnose für hardware.details.

Der Fernzugriff verwendet den gemeinsamen Broker: Der Status von Tailscale und Sunshine wird beim Öffnen und alle 10 Sekunden aktualisiert, solange ein Fernzugriffspanel ihn beobachtet. Nach dem Schließen des letzten Panels enden die Statusabfragen. Die Richtlinienverfügbarkeit wird nur beim Start und bei Änderungen gelesen. Aktionen verwenden weiterhin die Walker-Helfer; der Broker ändert keine Fernzugriffseinstellungen. Die CLI remote-status.py bleibt verfügbar. eitr-shell desktop-bar ipc call -- data status enthält Diagnosen für remote.status und remote.availability.

Wetter verwendet auf allen Bildschirmen und Panels eine gemeinsame Standardvorhersage mit 15 Minuten Cache- und Aktualisierungsintervall. Stadtsuche und alternative Städte gehören nur zum anfragenden Panel und ersetzen die Standardvorhersage nicht. KI-Nutzung teilt ihren Cache und wird beim Öffnen und danach alle fünf Minuten aktualisiert, solange ein Nutzungspanel geöffnet ist. Nach dem Schließen des letzten Panels starten keine wartenden Kontoabfragen mehr; laufende Aufrufe enden innerhalb ihrer bisherigen Zeitlimits, danach wird der KI-Adapter freigegeben. Wartezeiten der Anbieter werden eingehalten. Eigenständige Wetter- und KI-Befehle sowie die Sitzungsauswahl bleiben verfügbar. eitr-shell desktop-bar ipc call -- data status enthält Zähler für weather.default und ai.usage, ohne Kontonamen oder Anbieterantworten.

Aktualisierungsprüfungen nutzen den Datenbroker der Leiste gemeinsam auf allen Bildschirmen: 45 Sekunden nach dem Start, alle sechs Stunden und nach einer Systemaktualisierung oder manuellen Abfrage. Eine Anfrage während einer Prüfung plant eine weitere Prüfung danach ein. Offline- oder unlesbare Ergebnisse melden niemals einen aktuellen Stand; ein Rechtsklick auf das Aktualisierungssymbol versucht es erneut. Benachrichtigungen und Aufgabenterminals bleiben in der Shell. Die eigenständige Prüf-CLI bleibt verfügbar. Der obige Diagnosebefehl enthält updates.status.