Fehlerbehebung

Suche das Symptom unten und folge den passenden Prüfungen. Ändere jeweils nur eine Sache, damit du erkennst, was hilft. Bleibt das Problem bestehen, sammle die Diagnosedaten am Ende dieser Seite.

Start und Rendering

Warum schlägt Paneflow mit einem GPU- oder Rendering-Fehler fehl?

Linux: Paneflow braucht eine grafische Sitzung und einen GPU-Treiber mit Vulkan-Unterstützung. Führe diesen Befehl in einem Terminal dieser Sitzung aus:

vulkaninfo --summary

Fehlt vulkaninfo, installiere vulkan-tools über den Paketmanager deiner Distribution. Ein fehlendes Diagnosewerkzeug bedeutet nicht, dass Vulkan fehlt.

Schlägt der Befehl fehl oder zeigt keine GPU, prüfe Vulkan-Loader und Treiber. Das Loader-Paket heißt libvulkan1 auf Debian/Ubuntu, vulkan-loader auf Fedora und vulkan-icd-loader auf Arch. Installiere den Vulkan-Treiber für deine GPU: Mesa für unterstützte Intel/AMD-GPUs oder den passenden NVIDIA-Treiber. Starte Paneflow erneut und halte einen verbleibenden Fehler fest.

macOS: Prüfe, ob du macOS 13 Ventura oder neuer auf einem Apple-Silicon-Mac verwendest. Aktualisiere macOS und versuche es erneut. Beachte die macOS-Installationsvoraussetzungen.

Windows: Aktualisiere bei NoSupportedDeviceFound den GPU-Treiber vom PC- oder GPU-Hersteller und starte Paneflow erneut. Der Treiber muss DirectX 11 Feature Level 10 oder höher unterstützen. Erfasse GPU- und Treiberdetails:

Get-CimInstance Win32_VideoController |
  Select-Object Name, DriverVersion, DriverDate

Warum ist meine Wayland-Sitzung leer?

Ein leeres Fenster kann mit dem Grafiktreiber oder Display-Server zusammenhängen. Es zeigt die Ursache nicht eindeutig. Prüfe Vulkan wie oben beschrieben, beende Paneflow und versuche XWayland in derselben grafischen Sitzung:

env -u WAYLAND_DISPLAY paneflow

Dafür brauchst du XWayland und eine funktionierende DISPLAY-Variable. Der Befehl wählt X11 nur für diesen Start. Öffnet sich Paneflow so, nutze das vorübergehend, prüfe Grafiktreiber-Updates und beschreibe die Ergebnisse beider Starts im Fehlerbericht.

Konfiguration und Shortcuts

Warum lädt mein paneflow.json nicht?

Prüfe, ob du die Konfiguration der laufenden App bearbeitet hast. Veröffentlichte Builds verwenden standardmäßig diese Pfade:

Ein absoluter Pfad in PANEFLOW_HOME ändert diesen Ordner. Passe in diesem Fall die Pfade in den folgenden Befehlen an.

Auf Linux oder macOS mit installiertem Python 3:

python3 -m json.tool ~/.paneflow/paneflow.json

Auf Windows:

Get-Content $env:USERPROFILE\.paneflow\paneflow.json -Raw |
  ConvertFrom-Json | Out-Null

Behebe gemeldete Syntaxfehler, speichere und versuche es erneut. Fehlt die Datei, gelten die Standardwerte. Ungültige Konfiguration beim Start verwendet ebenfalls die Standardwerte; eine ungültige Änderung während der Ausführung behält die letzte gültige Konfiguration bei.

Diese Befehle prüfen die JSON-Syntax. Prüfe Namen, Typen und erlaubte Werte in der Konfigurationsschema-Referenz. Die App ignoriert unbekannte Keys auf oberster Ebene. Ein Tippfehler kann deshalb wie eine wirkungslose Einstellung aussehen.

Änderungen an window_decorations und window_backdrop erfordern einen Neustart.

Warum funktionieren meine Shortcuts nicht?

Jeder Eintrag in shortcuts ordnet einer Tastenkombination einen Action-Namen zu. Dieses Beispiel erstellt mit ctrl+shift+t einen Tab und deaktiviert ctrl+shift+w. Ergänze die vorhandene Konfiguration:

{
  "shortcuts": {
    "ctrl+shift+t": "new_tab",
    "ctrl+shift+w": "none"
  }
}

Verwende Action-Namen aus der Tastenkürzel-Referenz, etwa new_tab, split_horizontally oder toggle_search. Unbekannte Actions werden mit einer Warnung übersprungen.

Versagt ein Shortcut nur an einer Stelle, prüfe, welche Ansicht den Fokus hat. Terminal-, Search-, Markdown- und Diff-Actions haben eigene Kontexte.

Warum lädt mein Theme nicht per Hot Reload neu?

Verwende "One Dark" oder "PaneFlow Light" für theme auf oberster Ebene. Lies die Theme-Einstellungen und Beispiele.

1. Prüfe den Konfigurationspfad oben, einschließlich PANEFLOW_HOME.
2. Prüfe JSON-Syntax und Theme-Namen, dann speichere die Datei.
3. Warte kurz. Wird die Änderung nicht übernommen, starte Paneflow neu.
4. Wirkt die Änderung nach dem Neustart, aber nicht nach dem Speichern, melde das Problem. Erwähne, ob die Datei auf einem Netzlaufwerk oder eingebundenen Dateisystem liegt.

Installation und Signierung

Warum ist paneflow nicht in meinem PATH?

Die Lösung hängt von der Installationsart ab:

• Linux: .deb und .rpm installieren den Befehl in einem Systemordner. Für AppImage und .tar.gz muss möglicherweise ~/.local/bin in PATH aufgenommen werden. Folge den Linux-Anweisungen für Befehl und PATH.
• macOS: Homebrew und DMG installieren PaneFlow.app, nehmen die ausführbare Datei aber nicht automatisch in den Shell-PATH auf. Folge der Anleitung für macOS-Terminalzugriff.
• Windows: Schließe nach der MSI-Installation die Terminalfenster und öffne PowerShell über das Startmenü erneut. Fehlt der Befehl weiter, folge den Windows-Schritten zur Befehlssuche.

Warum sagt macOS, dass Apple diese App nicht prüfen kann?

Das offizielle DMG ist signiert und notarisiert. Lade eine neue Kopie vom neuesten Paneflow-Release herunter und prüfe den genauen Warntext. Folge den macOS-Gatekeeper-Schritten, die zwischen einer Bestätigung beim ersten Start und einer blockierten App unterscheiden. Meldet die Warnung eine beschädigte App oder eine Gefahr für den Computer, lass die App blockiert und melde den genauen Text.

Warum blockiert Windows SmartScreen das MSI?

Ein signierter Installer kann eine SmartScreen-Reputationswarnung auslösen. Prüfe vor dem Fortfahren die Windows-Signatur nach dieser Anleitung. Die Signatur muss Valid und der Herausgeber Strivex sein. Schlägt eine Prüfung fehl, lade das MSI erneut vom offiziellen Release herunter. Blockiert eine Unternehmensrichtlinie die Installation, wende dich an die Administration.

Diagnosedaten sammeln

Was soll ich in ein Issue schreiben?

Öffnet sich die App, wähle Help > System Info, dann Copy. Ergänze den Block um die verwendete Shell, den genauen Fehler, Schritte zum Reproduzieren und das erwartete Ergebnis. Nenne die Prüfungen dieser Seite, die du versucht hast.

Öffnet sich die App nicht, gib Paneflow-Version, Betriebssystemversion, Architektur, Installationsformat sowie GPU- und Treiberdetails manuell an. Auf Windows zeigt winver die Version und den Build an.

Verwende den Bericht für deine Plattform:

Beende Paneflow zuerst und starte es dann in einem Terminal mit aktivierter Protokollierung. Auf Linux oder macOS:

RUST_LOG=info paneflow

Auf Windows mit dem Standardordner der MSI-Installation:

$env:RUST_LOG = "info"
$env:RUST_BACKTRACE = "1"
& "$env:ProgramFiles\PaneFlow\paneflow.exe"

Fehlt der Befehl oder die ausführbare Datei, folge zuerst dem PATH-Abschnitt oder verwende den vollständigen Pfad. Bei einer macOS-DMG-Installation ersetze paneflow durch /Applications/PaneFlow.app/Contents/MacOS/paneflow.

Reproduziere das Problem und kopiere die relevante Terminalausgabe in den Bericht. Entferne Zugangstokens, private Pfade oder Projektinhalte vor dem Veröffentlichen.

Die schreibgeschützte MCP-Bridge liest Pane-Ausgabe. Nutze die obigen Befehle für App-Protokolle bei Start-, Konfigurations- oder Rendering-Problemen.