Dépannage

Repérez le symptôme ci-dessous et suivez les vérifications correspondantes. Modifiez un élément à la fois pour savoir ce qui a aidé. Si le problème persiste, rassemblez les diagnostics indiqués en fin de page.

Lancement et rendu

Pourquoi Paneflow échoue-t-il avec une erreur GPU ou de rendu ?

Linux : Paneflow nécessite une session graphique et un pilote GPU compatible Vulkan. Exécutez cette commande dans un terminal de cette session :

vulkaninfo --summary

Si vulkaninfo est introuvable, installez le paquet vulkan-tools avec le gestionnaire de paquets de votre distribution. L'absence de cet outil de diagnostic ne signifie pas que Vulkan est indisponible.

Si la commande échoue ou ne liste aucun GPU, vérifiez le chargeur Vulkan et le pilote. Le paquet du chargeur est libvulkan1 sur Debian/Ubuntu, vulkan-loader sur Fedora ou vulkan-icd-loader sur Arch. Installez le pilote Vulkan adapté au GPU : Mesa pour les GPU Intel/AMD pris en charge, ou le pilote NVIDIA approprié. Relancez Paneflow et conservez l'erreur si le problème persiste.

macOS : Vérifiez que vous utilisez macOS 13 Ventura ou ultérieur sur un Mac Apple Silicon. Mettez macOS à jour, puis réessayez. Consultez les prérequis d'installation macOS.

Windows : Pour NoSupportedDeviceFound, mettez à jour le pilote GPU depuis le fabricant du PC ou du GPU, puis relancez Paneflow. Le pilote doit prendre en charge DirectX 11, niveau de fonctionnalité 10 ou supérieur. Relevez les informations du GPU et du pilote :

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

Pourquoi ma session Wayland affiche-t-elle une fenêtre vide ?

Une fenêtre vide peut être liée au pilote graphique ou au serveur d'affichage. Elle ne suffit pas à identifier la cause. Vérifiez Vulkan comme indiqué ci-dessus, puis quittez Paneflow et essayez XWayland depuis la même session graphique :

env -u WAYLAND_DISPLAY paneflow

Cela nécessite XWayland et une variable DISPLAY fonctionnelle. La commande sélectionne X11 pour ce lancement seulement. Si Paneflow s'ouvre ainsi, utilisez cette solution temporaire, recherchez les mises à jour du pilote graphique et indiquez le résultat des deux lancements dans votre signalement.

Configuration et raccourcis

Pourquoi mon paneflow.json ne se charge-t-il pas ?

Vérifiez que vous avez modifié la configuration utilisée par l'application en cours. Les versions publiées utilisent ces chemins par défaut :

Un chemin absolu défini dans PANEFLOW_HOME change ce dossier. Si vous utilisez cette variable, adaptez les chemins des commandes suivantes.

Sur Linux ou macOS, avec Python 3 installé :

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

Sur Windows :

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

Corrigez les erreurs de syntaxe signalées, enregistrez le fichier et réessayez. Si le fichier est absent, Paneflow utilise les valeurs par défaut. Une configuration invalide au démarrage revient aussi aux valeurs par défaut ; une modification invalide pendant l'exécution conserve la dernière configuration valide.

Ces commandes vérifient la syntaxe JSON. Consultez la référence du schéma de configuration pour vérifier les noms, les types et les valeurs acceptées. L'application ignore les clés inconnues au premier niveau : une faute dans un nom peut donc ressembler à un réglage sans effet.

Les modifications de window_decorations et window_backdrop nécessitent un redémarrage.

Pourquoi mes raccourcis ne fonctionnent-ils pas ?

Chaque entrée de shortcuts associe une combinaison de touches à un nom d'action. Cet exemple crée un onglet avec ctrl+shift+t et désactive ctrl+shift+w. Ajoutez ces entrées à la configuration existante :

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

Utilisez les noms d'action de la référence des raccourcis clavier, comme new_tab, split_horizontally ou toggle_search. Les actions inconnues sont ignorées avec un avertissement.

Si un raccourci échoue dans une seule zone, vérifiez quelle vue est active. Les actions Terminal, Search, Markdown et Diff ont chacune leur contexte.

Pourquoi mon thème ne se recharge-t-il pas automatiquement ?

Utilisez "One Dark" ou "PaneFlow Light" comme valeur de la clé theme au premier niveau. Consultez les réglages et exemples de thèmes.

1. Vérifiez le chemin de configuration ci-dessus, y compris PANEFLOW_HOME.
2. Vérifiez la syntaxe JSON et le nom du thème, puis enregistrez le fichier.
3. Attendez un instant. Si le changement ne s'applique pas, redémarrez Paneflow.
4. Si le redémarrage applique le changement mais pas l'enregistrement, signalez le problème et précisez si le fichier se trouve sur un disque réseau ou un système de fichiers monté.

Installation et signature

Pourquoi paneflow n'est-il pas dans mon PATH ?

La résolution dépend de votre méthode d'installation :

• Linux : Les paquets .deb et .rpm installent la commande dans un dossier système. Les installations AppImage et .tar.gz peuvent nécessiter l'ajout de ~/.local/bin au PATH. Suivez les instructions Linux pour la commande et le PATH.
• macOS : Installer PaneFlow.app avec Homebrew ou un DMG n'ajoute pas automatiquement le binaire au PATH du shell. Suivez les instructions d'accès au terminal sur macOS.
• Windows : Après l'installation MSI, fermez les fenêtres de terminal et rouvrez PowerShell depuis le menu Démarrer. Si la commande reste introuvable, suivez les étapes de résolution sur Windows.

Pourquoi macOS indique-t-il qu'Apple ne peut pas vérifier cette application ?

Le DMG officiel est signé et notarisé. Téléchargez une nouvelle copie depuis la dernière version de Paneflow et relevez le texte de l'alerte. Suivez les étapes Gatekeeper sur macOS, qui distinguent la confirmation au premier lancement d'une application bloquée. Si l'alerte indique que l'application est endommagée ou risque d'endommager l'ordinateur, gardez-la bloquée et signalez le message exact.

Pourquoi Windows SmartScreen bloque-t-il le MSI ?

Un installeur signé peut afficher un avertissement de réputation SmartScreen. Suivez les étapes de vérification de signature Windows avant de continuer. Vérifiez que la signature est Valid et que l'éditeur est Strivex. Si l'une des vérifications échoue, téléchargez à nouveau le MSI depuis la version officielle. Si une règle de votre organisation bloque l'installation, contactez l'administrateur.

Collecter les diagnostics

Que dois-je inclure dans un signalement ?

Si l'application s'ouvre, choisissez Help > System Info, puis Copy. Ajoutez ce bloc, le shell utilisé, l'erreur exacte, les étapes pour reproduire le problème et le résultat attendu. Précisez les vérifications de cette page que vous avez essayées.

Si l'application ne s'ouvre pas, indiquez manuellement la version de Paneflow, celle du système, l'architecture, le format d'installation et les informations du GPU et du pilote. Sur Windows, winver affiche la version et le build Windows.

Utilisez le formulaire adapté à votre plateforme :

Pour recueillir la sortie de l'application, quittez d'abord Paneflow, puis lancez-le depuis un terminal avec la journalisation activée. Sur Linux ou macOS :

RUST_LOG=info paneflow

Sur Windows, pour le dossier d'installation MSI par défaut :

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

Si la commande ou le fichier est introuvable, suivez d'abord la section PATH ou utilisez le chemin complet du binaire installé. Pour un DMG macOS, remplacez paneflow par /Applications/PaneFlow.app/Contents/MacOS/paneflow.

Reproduisez le problème et copiez la sortie pertinente du terminal dans le signalement. Retirez les jetons d'accès, chemins privés ou contenus du projet avant de le publier.

Le pont MCP en lecture seule lit la sortie des panneaux. Utilisez les commandes ci-dessus pour les journaux de l'application en cas de problème de lancement, de configuration ou de rendu.